本頁面由 Cloud Translation API 翻譯而成。

在您的 UI (v3) 中實作通勤時間搜尋

在您的 UI 中整合「通勤時間搜尋」功能，讓求職者按通勤時間搜尋特定地理區域內的職缺。「通勤時間搜尋」可依使用者選擇的大眾運輸模式及預計出發時段來預估通勤時間。

導入通勤時間搜尋

您必須先將 Cloud Talent Solution 掛接至 UI，才能導入通勤時間搜尋功能。請按照快速入門導覽課程說明來設定 Cloud Talent Solution。

通勤時間搜尋功能會利用您在導入 CTS 時上傳的地址資料來計算通勤時間。如要在現有的 CTS UI 中啟用這項功能，請傳送 jobs.search 要求，並在 JobQuery.commuteFilter 欄位中加入 CommuteFilter 物件。commuteMethod、travelDuration 和 startCoordinates 為必填欄位。

Java

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。


public static void commuteSearch(String companyName) throws IOException, InterruptedException {
  // Make sure to set the requestMetadata the same as the associated search request
  RequestMetadata requestMetadata =
      new RequestMetadata()
          // Make sure to hash your userID
          .setUserId("HashedUserId")
          // Make sure to hash the sessionID
          .setSessionId("HashedSessionID")
          // Domain of the website where the search is conducted
          .setDomain("www.google.com");
  JobQuery jobQuery =
      new JobQuery()
          .setCommuteFilter(
              new CommuteFilter()
                  .setRoadTraffic("TRAFFIC_FREE")
                  .setCommuteMethod("TRANSIT")
                  .setTravelDuration("1000s")
                  .setStartCoordinates(
                      new LatLng().setLatitude(37.422408).setLongitude(-122.085609)));
  if (companyName != null) {
    jobQuery.setCompanyNames(Arrays.asList(companyName));
  }

  SearchJobsRequest searchJobsRequest =
      new SearchJobsRequest()
          .setJobQuery(jobQuery)
          .setRequestMetadata(requestMetadata)
          .setJobView("JOB_VIEW_FULL")
          .setRequirePreciseResultSize(true);
  SearchJobsResponse response =
      talentSolutionClient
          .projects()
          .jobs()
          .search(DEFAULT_PROJECT_ID, searchJobsRequest)
          .execute();
  Thread.sleep(1000);
  System.out.printf("Search jobs for commute results: %s\n", response);
}

Python

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。

def commute_search(client_service, company_name):
    request_metadata = {
        "user_id": "HashedUserId",
        "session_id": "HashedSessionId",
        "domain": "www.google.com",
    }
    start_location = {"latitude": 37.422408, "longitude": -122.085609}
    commute_preference = {
        "road_traffic": "TRAFFIC_FREE",
        "commute_method": "TRANSIT",
        "travel_duration": "1000s",
        "start_coordinates": start_location,
    }
    job_query = {"commute_filter": commute_preference}
    if company_name is not None:
        job_query.update({"company_names": [company_name]})
    request = {
        "job_query": job_query,
        "request_metadata": request_metadata,
        "job_view": "JOB_VIEW_FULL",
        "require_precise_result_size": True,
    }
    response = (
        client_service.projects().jobs().search(parent=parent, body=request).execute()
    )
    print(response)

Go

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。


// commuteSearch searches for jobs within commute filter.
func commuteSearch(w io.Writer, projectID, companyName string) (*talent.SearchJobsResponse, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	jobQuery := &talent.JobQuery{
		CommuteFilter: &talent.CommuteFilter{
			RoadTraffic:    "TRAFFIC_FREE",
			CommuteMethod:  "TRANSIT",
			TravelDuration: "1000s",
			StartCoordinates: &talent.LatLng{
				Latitude:  37.422408,
				Longitude: -122.085609,
			},
		},
	}
	if companyName != "" {
		jobQuery.CompanyNames = []string{companyName}
	}

	parent := "projects/" + projectID
	req := &talent.SearchJobsRequest{
		// Make sure to set the RequestMetadata the same as the associated
		// search request.
		RequestMetadata: &talent.RequestMetadata{
			// Make sure to hash your userID.
			UserId: "HashedUsrId",
			// Make sure to hash the sessionID.
			SessionId: "HashedSessionId",
			// Domain of the website where the search is conducted.
			Domain: "www.googlesample.com",
		},
		// Set the actual search term as defined in the jobQuery.
		JobQuery: jobQuery,
		// Set the search mode to a regular search.
		SearchMode:               "JOB_SEARCH",
		RequirePreciseResultSize: true,
	}
	resp, err := service.Projects.Jobs.Search(parent, req).Do()
	if err != nil {
		return nil, fmt.Errorf("failed to search for jobs with commute filter: %w", err)
	}
	return resp, nil
}

Ruby

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。

# project_id              = "Id of the project"
# commute_method          = "The method of transportation for which to calculate the commute time"
# travel_duration         = "The maximum travel time in seconds"
# start_coordinates       = "The latitude and longitude of the location from which to calculate the commute time"

require "google/apis/jobs_v3"

jobs = Google::Apis::JobsV3
talent_solution_client = jobs::CloudTalentSolutionService.new
# @see https://developers.google.com/identity/protocols/application-default-credentials#callingruby
talent_solution_client.authorization = Google::Auth.get_application_default(
  "https://www.googleapis.com/auth/jobs"
)

# Make sure to set the request_metadata the same as the associated search request
request_metadata = jobs::RequestMetadata.new user_id:    "HashedUserId",
                                             session_id: "HashedSessionId",
                                             domain:     "www.google.com"
# Set location filter
commute_filter = jobs::CommuteFilter.new road_traffic:      "TRAFFIC_FREE",
                                         commute_method:    commute_method,
                                         travel_duration:   travel_duration,
                                         start_coordinates: start_coordinates
# Perform a search for analyst  related jobs
search_jobs_request =
  jobs::SearchJobsRequest.new request_metadata:            request_metadata,
                              job_query:                   (jobs::JobQuery.new commute_filter: commute_filter),
                              job_view:                    "JOB_VIEW_FULL",
                              require_precise_result_size: true
search_jobs_response = talent_solution_client.search_jobs project_id, search_jobs_request
puts search_jobs_response.to_json
search_jobs_response

UI 建議項目

Cloud Talent Solution 不允許同時按距離 (使用 CTS 位置篩選器)「以及」通勤時間進行搜尋。如要將這兩個選項都提供給求職者，請使用雙標籤或採行類似做法。
修改應用程式前端，這樣求職者要求搜尋通勤時間時，後端就能在通勤篩選器中填入相關資訊，並按照一般搜尋要求的流程來呼叫 API。
在 UI 中納入最近新增的項目：
- 可讓使用者選擇按距離搜尋或按通勤時間搜尋。舉例來說，您的搜尋 UI 可能類似以下範例呈現的樣子：
- 列出通勤方式選項的下拉式選單。
- 調整路況的選項。
- 交通時間總長 (可用的交通時間上限為 60 分鐘)。
- 通勤開始時間。
接著，API 傳回的通勤時間資訊會用來向求職者顯示相關資訊。搜尋結果清單將只列出位於指定通勤時間區域內的相關職缺。請參閱工作搜尋最佳做法說明文件，進一步瞭解如何就搜尋結果傳回的區域內職缺，調整排序及數量。

產生具有通勤資訊的地圖 (建議採用)

透過 Maps API，您可以根據 CTS API 傳回的通勤時間資訊來產生地圖，並將地圖內嵌於搜尋結果再傳給求職者。Maps API 套件支援多種地圖顯示選項。部分 Maps API 選項的呈現效果比較好。比方說，如果按求職者設定的通勤偏好搜尋特定區域內的職缺，以 Google 地圖 JavaScript 熱視圖視覺呈現搭配標記分群法來顯示傳回的相關職缺搜尋結果，視覺效果就非常好。相反地，路線模式就不會顯示搜尋要求傳回的所有工作，且也不建議在這種情況下使用。

如要進一步瞭解依通勤時間搜尋的實作方式，請參閱通勤時間搜尋使用指南。

在您的 UI (v3) 中實作通勤時間搜尋 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

導入通勤時間搜尋

Java

Python

Go

Ruby

UI 建議項目

產生具有通勤資訊的地圖 (建議採用)

在您的 UI (v3) 中實作通勤時間搜尋