Búsqueda por viaje diario (v3)

Las solicitudes de búsqueda de trabajos pueden incluir un filtro de tiempo de viaje cotidiano que restringe los trabajos que se muestran a solo aquellos que se encuentran dentro de un tiempo de traslado específico desde un punto de partida. Los resultados incluyen el tiempo estimado de viaje cotidiano en segundos para los trabajos coincidentes.

Búsqueda de tiempo de viaje cotidiano específico

Para mostrar trabajos dentro de un tiempo de viaje diario específico, envía una solicitud jobs.search y, luego, incluye un objeto CommuteFilter en el campo JobQuery.commuteFilter. Cloud Talent Solution usa la dirección del trabajo para calcular su tiempo de viaje cotidiano. Si no se proporciona una dirección detallada, Cloud Talent Solution intentará deducirla.

Java

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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 obligatorios

• commuteMethod: Es el medio de transporte que se usará para calcular el tiempo de traslado. Las opciones son DRIVING y TRANSIT. Todas las versiones, ya que V3p1beta1 también incluirán los modos de tránsito WALKING y CYCLING. Es posible que las rutas a pie o en bicicleta no reflejen las condiciones reales, como la construcción o incluir senderos para caminar o andar en bicicleta. En estas respuestas, se incluirán warnings en el resultado que se debe mostrar para los usuarios.

• travelDuration: Es el tiempo de viaje máximo en segundos. El valor máximo permitido es 3600s (una hora). El formato es 123s.

• startCoordinates: Es la latitud y la longitud de la ubicación desde la cual se calculará el tiempo de traslado. Acepta un objeto LatLng.

Campos opcionales

• allowImpreciseAddresses: Son las direcciones “precisas” se definen como direcciones a nivel de calle o coordenadas GPS. Si allowImpreciseAddresses se configura como true, es posible que también se muestren trabajos con direcciones “imprecisas” (solo ciudad, estado o país). Para las direcciones a nivel de ciudad y de áreas más amplias, se usa la coincidencia de texto. Si este campo se configura como false o no se especifica, solo la búsqueda de viaje de ida y vuelta al trabajo mostrará los trabajos que incluyan direcciones precisas.

Nota: Si allowImpreciseAddresses se configura como true, la búsqueda de viajes no puede calcular tiempos de viaje precisos con los trabajos con información sobre la ciudad y la dirección más aproximada. Los trabajos con direcciones imprecisas muestran un tiempo de travelDuration de 0 sin importar la distancia del usuario que busca empleo.

• roadTraffic: Especifica la densidad del tráfico que se usará para calcular el tiempo de traslado. Las opciones son TRAFFIC_FREE o BUSY_HOUR. No debe estar presente si se especifica departureHourLocal.

• departureTime: Es la hora de salida que se usa para calcular el efecto del tráfico. Acepta un número entero entre 0 y 23 que representa la hora en la zona horaria de startLocation. No debe estar presente si se especifica roadTraffic.