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

在 UI 中實作通勤時間搜尋

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

導入通勤時間搜尋

您必須先將 Cloud Talent Solution 掛接至 UI，才能導入通勤時間搜尋功能。請按照快速入門導覽課程說明來設定 Cloud Talent Solution。
通勤時間搜尋功能會利用您在導入 CTS 時上傳的地址資料來計算通勤時間。如要在現有的 CTS UI 中啟用這項功能，請傳送 jobs.search 要求，並在 JobQuery.commuteFilter 欄位中加入 CommuteFilter 物件。commuteMethod、travelDuration、startCoordinates 和 roadTraffic 或 departureTime 皆為必填欄位。

Go

如要瞭解如何安裝及使用 CTS 的用戶端程式庫，請參閱 CTS 用戶端程式庫。詳情請參閱 CTS Go API 參考說明文件。

如要向 CTS 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證」。

import (
	"context"
	"fmt"
	"io"

	talent "cloud.google.com/go/talent/apiv4beta1"
	"cloud.google.com/go/talent/apiv4beta1/talentpb"
	"github.com/golang/protobuf/ptypes/duration"
	"google.golang.org/genproto/googleapis/type/latlng"
)

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

	// Initialize a jobService client.
	c, err := talent.NewJobClient(ctx)
	if err != nil {
		return fmt.Errorf("talent.NewJobClient: %w", err)
	}
	defer c.Close()

	// Construct a jobQuery request with a commute filter.
	jobQuery := &talentpb.JobQuery{
		CommuteFilter: &talentpb.CommuteFilter{
			CommuteMethod:  talentpb.CommuteMethod_TRANSIT,
			TravelDuration: &duration.Duration{Seconds: 1800},
			StartCoordinates: &latlng.LatLng{
				Latitude:  37.422408,
				Longitude: -122.085609,
			},
		},
	}
	if companyID != "" {
		jobQuery.Companies = []string{fmt.Sprintf("projects/%s/companies/%s", projectID, companyID)}
	}

	// Construct a searchJobs request with a jobQuery.
	req := &talentpb.SearchJobsRequest{
		Parent: fmt.Sprintf("projects/%s", projectID),
		// Make sure to set the RequestMetadata the same as the associated
		// search request.
		RequestMetadata: &talentpb.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,
	}

	resp, err := c.SearchJobs(ctx, req)
	if err != nil {
		return fmt.Errorf("SearchJobs: %w", err)
	}

	for _, job := range resp.GetMatchingJobs() {
		fmt.Fprintf(w, "Matcing Job: %q\n", job.GetJob().GetName())
		fmt.Fprintf(w, "Job address: %v\n", job.GetCommuteInfo().GetJobLocation().GetPostalAddress().GetAddressLines())
	}

	return nil
}

Java

如要瞭解如何安裝及使用 CTS 的用戶端程式庫，請參閱 CTS 用戶端程式庫。詳情請參閱 CTS Java API 參考說明文件。

如要向 CTS 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證」。


import com.google.cloud.talent.v4.CommuteFilter;
import com.google.cloud.talent.v4.CommuteMethod;
import com.google.cloud.talent.v4.Job;
import com.google.cloud.talent.v4.JobQuery;
import com.google.cloud.talent.v4.JobServiceClient;
import com.google.cloud.talent.v4.RequestMetadata;
import com.google.cloud.talent.v4.SearchJobsRequest;
import com.google.cloud.talent.v4.SearchJobsResponse;
import com.google.cloud.talent.v4.TenantName;
import com.google.protobuf.Duration;
import com.google.type.LatLng;
import java.io.IOException;

public class CommuteSearchJobs {

  public static void searchJobs() throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "your-project-id";
    String tenantId = "your-tenant-id";
    searchJobs(projectId, tenantId);
  }

  // Search Jobs with histogram queries.
  public static void searchJobs(String projectId, String tenantId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (JobServiceClient jobServiceClient = JobServiceClient.create()) {
      TenantName parent = TenantName.of(projectId, tenantId);
      String domain = "www.example.com";
      String sessionId = "Hashed session identifier";
      String userId = "Hashed user identifier";
      RequestMetadata requestMetadata =
          RequestMetadata.newBuilder()
              .setDomain(domain)
              .setSessionId(sessionId)
              .setUserId(userId)
              .build();

      CommuteMethod commuteMethod = CommuteMethod.DRIVING;
      long seconds = 3600L;
      Duration travelDuration = Duration.newBuilder().setSeconds(seconds).build();

      double latitude = 37.422408;
      double longitude = -122.084068;
      LatLng startCoordinates =
          LatLng.newBuilder().setLatitude(latitude).setLongitude(longitude).build();

      CommuteFilter commuteFilter =
          CommuteFilter.newBuilder()
              .setCommuteMethod(commuteMethod)
              .setTravelDuration(travelDuration)
              .setStartCoordinates(startCoordinates)
              .build();

      JobQuery jobQuery = JobQuery.newBuilder().setCommuteFilter(commuteFilter).build();
      SearchJobsRequest request =
          SearchJobsRequest.newBuilder()
              .setParent(parent.toString())
              .setRequestMetadata(requestMetadata)
              .setJobQuery(jobQuery)
              .build();

      for (SearchJobsResponse.MatchingJob responseItem :
          jobServiceClient.searchJobs(request).getMatchingJobsList()) {
        System.out.format("Job summary: %s%n", responseItem.getJobSummary());
        System.out.format("Job title snippet: %s%n", responseItem.getJobTitleSnippet());
        Job job = responseItem.getJob();
        System.out.format("Job name: %s%n", job.getName());
        System.out.format("Job title: %s%n", job.getTitle());
      }
    }
  }
}

Node.js

如要瞭解如何安裝及使用 CTS 的用戶端程式庫，請參閱 CTS 用戶端程式庫。詳情請參閱 CTS Node.js API 參考說明文件。

如要向 CTS 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證」。


const talent = require('@google-cloud/talent').v4;

/** Search Jobs using commute distance */
function sampleSearchJobs(projectId, tenantId) {
  const client = new talent.JobServiceClient();
  // Iterate over all elements.
  // const projectId = 'Your Google Cloud Project ID';
  // const tenantId = 'Your Tenant ID (using tenancy is optional)';
  const formattedParent = client.tenantPath(projectId, tenantId);
  const domain = 'www.example.com';
  const sessionId = 'Hashed session identifier';
  const userId = 'Hashed user identifier';
  const requestMetadata = {
    domain: domain,
    sessionId: sessionId,
    userId: userId,
  };
  const commuteMethod = 'TRANSIT';
  const seconds = 1800;
  const travelDuration = {
    seconds: seconds,
  };
  const latitude = 37.422408;
  const longitude = 122.084068;
  const startCoordinates = {
    latitude: latitude,
    longitude: longitude,
  };
  const commuteFilter = {
    commuteMethod: commuteMethod,
    travelDuration: travelDuration,
    startCoordinates: startCoordinates,
  };
  const jobQuery = {
    commuteFilter: commuteFilter,
  };
  const request = {
    parent: formattedParent,
    requestMetadata: requestMetadata,
    jobQuery: jobQuery,
  };

  client
    .searchJobs(request)
    .then(responses => {
      const resources = responses[0];
      for (const resource of resources) {
        console.log(`Job summary: ${resource.jobSummary}`);
        console.log(`Job title snippet: ${resource.jobTitleSnippet}`);
        const job = resource.job;
        console.log(`Job name: ${job.name}`);
        console.log(`Job title: ${job.title}`);
      }
    })
    .catch(err => {
      console.error(err);
    });
}

Python

如要瞭解如何安裝及使用 CTS 的用戶端程式庫，請參閱 CTS 用戶端程式庫。詳情請參閱 CTS Python API 參考說明文件。

如要向 CTS 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證」。


from google.cloud import talent


def search_jobs(project_id, tenant_id):
    """Search Jobs using commute distance"""

    client = talent.JobServiceClient()

    # project_id = 'Your Google Cloud Project ID'
    # tenant_id = 'Your Tenant ID (using tenancy is optional)'

    if isinstance(project_id, bytes):
        project_id = project_id.decode("utf-8")
    if isinstance(tenant_id, bytes):
        tenant_id = tenant_id.decode("utf-8")
    parent = f"projects/{project_id}/tenants/{tenant_id}"
    domain = "www.example.com"
    session_id = "Hashed session identifier"
    user_id = "Hashed user identifier"
    request_metadata = talent.RequestMetadata(
        domain=domain, session_id=session_id, user_id=user_id
    )
    commute_method = talent.CommuteMethod.TRANSIT
    seconds = 1800
    travel_duration = {"seconds": seconds}
    latitude = 37.422408
    longitude = -122.084068
    start_coordinates = {"latitude": latitude, "longitude": longitude}
    commute_filter = talent.CommuteFilter(
        commute_method=commute_method,
        travel_duration=travel_duration,
        start_coordinates=start_coordinates,
    )
    job_query = talent.JobQuery(commute_filter=commute_filter)

    # Iterate over all results
    results = []
    request = talent.SearchJobsRequest(
        parent=parent,
        request_metadata=request_metadata,
        job_query=job_query,
    )
    for response_item in client.search_jobs(request=request).matching_jobs:
        print(f"Job summary: {response_item.job_summary}")
        print(f"Job title snippet: {response_item.job_title_snippet}")
        job = response_item.job
        results.append(job.name)
        print(f"Job name: {job.name}")
        print(f"Job title: {job.title}")
    return results

UI 建議

Cloud Talent Solution 不允許在同一個 API 呼叫中，同時按距離 (使用 CTS 位置篩選器)「以及」通勤時間進行搜尋。如要將這兩個選項都提供給求職者，請使用雙標籤或採行類似做法。
修改應用程式前端，確保後端會自動在通勤篩選器中填入求職者的相關資訊。後端應按照一般搜尋要求的流程來呼叫 API。
在 UI 中納入項目：
- 可讓使用者選擇按距離搜尋或按通勤時間搜尋。舉例來說，您的搜尋 UI 可能類似以下範例呈現的樣子：
- 列出通勤方式選項的下拉式選單。
- 調整路況的選項。
- 交通時間總長 (可用的交通時間上限為 60 分鐘)。
- 通勤開始時間。
API 傳回的通勤時間資訊會用來向求職者顯示相關資訊。搜尋結果清單將只列出位於指定通勤時間區域內的相關職缺。請參閱職缺搜尋最佳做法說明文件，進一步瞭解如何就搜尋結果傳回的區域內職缺，調整排序及數量。
通勤搜尋結果是根據歷來和匯總資料，而非即時車流量狀況。departureTime路況是根據指定時段的平均路況計算而得。roadTraffic 下方的 BUSY_HOUR/TRAFFIC_FREE 選項分別代表早上尖峰時段和午夜的平均路況。無論使用者在一天中的哪個時間傳送查詢，都會收到相同的通勤搜尋結果。

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

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

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

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

導入通勤時間搜尋

Go

Java

Node.js

Python

UI 建議

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

在 UI 中實作通勤時間搜尋