Esta página foi traduzida pela API Cloud Translation.

Pesquisa de trajeto (v3)

Os pedidos de pesquisa de emprego podem incluir um filtro de tempo de trajeto que restringe os empregos devolvidos àqueles que se encontram a um tempo de viagem especificado a partir de um ponto de partida. Os resultados incluem o tempo de viagem regular estimado em segundos para os empregos correspondentes.

Pesquisa de tempo de trajeto específico

Para devolver trabalhos dentro de um tempo de trajeto específico, envie um pedido jobs.search e inclua um objeto CommuteFilter no campo JobQuery.commuteFilter. A Cloud Talent Solution usa a morada do trabalho para calcular o tempo de trajeto até esse trabalho. Quando não é fornecida uma morada detalhada, a Cloud Talent Solution tenta inferir a morada real da rua do trabalho.

Java

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

Campos obrigatórios

commuteMethod: o método de transporte para o qual calcular o tempo de trajeto diário. As opções são DRIVING e TRANSIT. Todas as versões desde a V3p1beta1 também incluem os modos de transporte WALKING e CYCLING. Os trajetos a pé e de bicicleta podem não refletir as condições reais, como construções, ou incluir caminhos claros para caminhar ou andar de bicicleta. Estas respostas vão incluir warnings no resultado devolvido, que tem de apresentar aos seus utilizadores.
travelDuration: o tempo de viagem máximo em segundos. O valor máximo permitido é 3600s (uma hora). O formato é 123s.
startCoordinates: a latitude e a longitude da localização a partir da qual calcular o tempo de trajeto. Aceita um objeto LatLng.

Campos opcionais

allowImpreciseAddresses: os endereços "Precisos" são definidos como endereços ao nível da rua ou coordenadas GPS. Se allowImpreciseAddresses estiver definido como true, também podem ser devolvidos trabalhos com moradas "imprecisas" (apenas cidade, estado ou país). Para endereços ao nível da cidade e de nível mais geral, é usada a correspondência de texto. Se este campo estiver definido como false ou não for especificado, a pesquisa de viagens regulares devolve apenas tarefas que incluem moradas precisas.

, independentemente da distância do candidato.

roadTraffic: especifica a densidade do tráfego a usar ao calcular o tempo de viagem regular de e para o trabalho. As opções são TRAFFIC_FREE ou BUSY_HOUR. Não pode estar presente se departureHourLocal for especificado.
departureTime: a hora de partida a usar para calcular o impacto do trânsito. Aceita um número inteiro entre 0 e 23, que representa a hora no fuso horário do startLocation. Não pode estar presente se roadTraffic for especificado.

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

Pesquisa de tempo de trajeto específico

Java

Python

Go

Ruby

Campos obrigatórios

Campos opcionais

Pesquisa de trajeto (v3)