Suche in Abhängigkeit von der Anfahrtszeit (v3)

Jobsuchanfragen können einen Anfahrtszeitfilter enthalten, der die zurückgegebenen Jobs auf eine angegebene Fahrtzeit vom Startpunkt aus begrenzt. Die Ergebnisse enthalten die geschätzte Anfahrtszeit in Sekunden für übereinstimmende Jobs.

Um Jobs innerhalb einer bestimmten Pendelzeit zurückzugeben, senden Sie eine jobs.search -Anforderung und fügen Sie ein CommuteFilter -Objekt in das Feld JobQuery.commuteFilter ein. Cloud Talent Solution verwendet die Adresse des Jobs, um die Anfahrtszeit für diesen Job zu berechnen. Wenn keine detaillierte Adresse angegeben ist, versucht Cloud Talent Solution, die tatsächliche Adresse des Jobs abzuleiten.

Java

Weitere Informationen zum Installieren und Erstellen eines Cloud Talent Solution-Clients finden Sie unter Cloud Talent Solution-Clientbibliotheken.


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

Weitere Informationen zum Installieren und Erstellen eines Cloud Talent Solution-Clients finden Sie unter Cloud Talent Solution-Clientbibliotheken.

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

Weitere Informationen zum Installieren und Erstellen eines Cloud Talent Solution-Clients finden Sie unter Cloud Talent Solution-Clientbibliotheken.


// 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

Weitere Informationen zum Installieren und Erstellen eines Cloud Talent Solution-Clients finden Sie unter Cloud Talent Solution-Clientbibliotheken.

# 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

Pflichtfelder

  • commuteMethod: Die Beförderungsart, für die die Anfahrtszeit berechnet wird. Optionen sind DRIVING und TRANSIT. Alle Versionen seit V3p1beta1 enthalten auch die Transitmodi WALKING und CYCLING. Wander- und Radrouten spiegeln möglicherweise nicht die Gegebenheiten in der realen Welt wider (z. B. Baustellen) oder umfassen keine eindeutigen Wander- oder Radwege. Diese Antworten enthalten warnings im zurückgegebenen Ergebnis, das Sie Ihren Benutzern anzeigen müssen.

  • travelDuration: Die maximale Fahrtzeit in Sekunden. Der maximal zulässige Wert ist 3600s (eine Stunde). Format ist 123s.

  • startCoordinates: Der Breiten- und Längengrad des Ortes, der als Ausgangspunkt für die Berechnung der Anfahrtszeit dient. Akzeptiert ein LatLng -Objekt.

Optionale Felder

  • allowImpreciseAddresses: "Präzise" Adressen werden entweder als Straßenadressen oder als GPS-Koordinaten definiert. Wenn allowImpreciseAddresses auf true gesetzt ist, können auch Jobs mit "ungenauen" Adressen (nur Stadt, Bundesland oder Land) zurückgegeben werden. Für Adressen auf Stadtebene und höherer Ebene wird ein Textabgleich verwendet. Wenn dieses Feld auf false gesetzt oder nicht angegeben ist, werden nur Jobs mit genauen Adressen von der Pendelsuche zurückgegeben.
  • roadTraffic: Gibt die Verkehrsdichte an, die für die Berechnung der Anfahrtszeit verwendet werden soll. Optionen sind TRAFFIC_FREE oder BUSY_HOUR. Darf nicht vorhanden sein, wenn departureHourLocal angegeben ist.

  • departureTime: Die Abfahrtszeit zur Berechnung der Auswirkungen durch das Verkehrsaufkommen. Akzeptiert eine Ganzzahl zwischen 0 und 23, die die Stunde in der Zeitzone von startLocation darstellt. Darf nicht vorhanden sein, wenn roadTraffic angegeben ist.