Esta página foi traduzida pela API Cloud Translation.

Implementar a pesquisa de trajeto na sua IU (v3)

Pode integrar a pesquisa de trajeto pendular na sua IU para permitir que os candidatos a emprego pesquisem empregos numa área geográfica definida pelo tempo de trajeto pendular. A pesquisa de trajeto para o trabalho estima o tempo de trajeto com base no modo de transporte selecionado pelo utilizador e na hora do dia em que planeia viajar.

Implementar a pesquisa de viagens regulares

Antes de poder implementar a pesquisa de trajeto, a Cloud Talent Solution tem de estar associada à sua IU. Siga os guias de início rápido para configurar o Cloud Talent Solution.

A pesquisa de trajeto usa os dados de morada que carregou com os seus empregos durante a implementação do CTS para calcular o tempo de trajeto. Para ativar esta funcionalidade na IU do CTS existente, envie um pedido jobs.search e inclua um objeto CommuteFilter no campo JobQuery.commuteFilter. commuteMethod, travelDuration e startCoordinates são campos obrigatórios.

Java

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte o artigo Bibliotecas de cliente da 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

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte o artigo Bibliotecas de cliente da 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

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte o artigo Bibliotecas de cliente da 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

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte o artigo Bibliotecas de cliente da 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

Recomendações para a sua IU

O Cloud Talent Solution não permite a pesquisa por distância (através do filtro de localização do CTS) E tempo de trajeto. Para permitir que os candidatos a emprego acedam a ambas as opções, use uma abordagem de 2 separadores ou semelhante.
Modifique o front-end da sua aplicação para que, quando um candidato a emprego pedir uma pesquisa de trajeto, o back-end preencha as informações relevantes no filtro de trajeto e chame a API como faria num pedido de pesquisa normal.
Inclua estes itens recém-adicionados na IU:
- Uma opção para escolher se se trata de uma pesquisa de distância ou de trajeto. Por exemplo, a IU de pesquisa pode ter o aspeto do exemplo abaixo:
- Um menu pendente de opções de método de trajeto.
- Uma opção para ajustar as condições de trânsito.
- O tempo de viagem total (o tempo de viagem máximo suportado é de 60 minutos).
- Hora de início da viagem regular.
As informações sobre o tempo de trajeto devolvidas pela API são, em seguida, usadas para apresentar informações ao candidato a emprego. Apenas são devolvidos na lista de resultados os trabalhos relevantes localizados na área de tempo de trajeto designada. Consulte a documentação de práticas recomendadas de pesquisa de emprego para ver uma discussão sobre as formas de ajustar a ordem e o número de empregos devolvidos nesta área.

Gerar um mapa com informações de viagens regulares (recomendado)

Pode tirar partido da API Google Maps para gerar um mapa com base nas informações de tempo de trajeto devolvidas pela API CTS e incorporá-lo nos resultados devolvidos a um candidato a emprego. O conjunto de APIs Google Maps tem várias opções para apresentar o mapa. Algumas opções da API Maps são mais eficazes do que outras. Por exemplo, a visualização do mapa de calor do JavaScript do Google Maps, juntamente com a agrupamento de marcadores, é uma excelente forma de visualizar os trabalhos relevantes devolvidos a um candidato a emprego na área determinada pelas suas preferências de deslocação definidas. Por outro lado, o Modo de direções não mostra todos os trabalhos devolvidos num pedido de pesquisa e não é uma opção recomendada.

Para mais informações sobre a implementação de uma pesquisa baseada em deslocações, consulte o guia de instruções da pesquisa de deslocações.

Implementar a pesquisa de trajeto na sua IU (v3) Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Implementar a pesquisa de viagens regulares

Java

Python

Go

Ruby

Recomendações para a sua IU

Gerar um mapa com informações de viagens regulares (recomendado)

Implementar a pesquisa de trajeto na sua IU (v3)