Implementazione della ricerca basata sul tragitto giornaliero nell'interfaccia utente (v3)

Puoi integrare la ricerca per tragitto giornaliero nella tua UI per consentire alle persone in cerca di lavoro di cercare offerte di lavoro all'interno di un'area geografica impostata in base ai tempi del tragitto giornaliero. La ricerca basata sul tragitto giornaliero stima il tempo di percorrenza del tragitto in base alla modalità di trasporto pubblico selezionata dall'utente e all'ora del giorno in cui ha intenzione di viaggiare.

Implementazione della ricerca basata sul tragitto giornaliero

1. Prima di poter implementare la ricerca per pendolari, Cloud Talent Solution deve essere collegato alla tua UI. Segui le guide della quickstart per configurare Cloud Talent Solution.

2. La ricerca basata sul tragitto giornaliero utilizza i dati degli indirizzi che hai caricato con le tue offerte di lavoro durante l'implementazione di CTS per calcolare i tempi del tragitto giornaliero. Per attivare questa funzionalità nella UI di CTS esistente, invia una richiesta jobs.search e includi un oggetto CommuteFilter nel campo JobQuery.commuteFilter. commuteMethod, travelDuration e startCoordinates sono campi obbligatori.

   Java

   Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di 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

   Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di 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

   Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di 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

   Per saperne di più sull'installazione e sulla creazione di un client Cloud Talent Solution, consulta Librerie client di 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

Consigli per la tua UI

1. Cloud Talent Solution non consente la ricerca per distanza (utilizzando il filtro di località CTS) E per tempo di tragitto giornaliero. Per consentire a chi cerca lavoro di accedere a entrambe le opzioni, utilizza un approccio a due schede o simile.

2. Modifica il front-end della tua applicazione in modo che quando una persona in cerca di lavoro richiede una ricerca basata sul tragitto giornaliero, il backend compila le informazioni pertinenti nel filtro del tragitto giornaliero e chiama l'API come in una normale richiesta di ricerca.

3. Includi nell'interfaccia utente i seguenti elementi appena aggiunti:

   • Un'opzione per scegliere se si tratta di una ricerca di distanza o di un tragitto giornaliero. Ad esempio, la tua UI della Ricerca potrebbe essere simile all'esempio seguente:

     

   • Un menu a discesa con le opzioni relative ai metodi di tragitto giornaliero.

   • Un'opzione per regolare le condizioni del traffico.

   • Il tempo di percorrenza totale (il tempo di percorrenza massimo supportato è 60 minuti).

   • Ora di inizio del tragitto giornaliero.

4. Le informazioni sulla durata del tragitto giornaliero restituite dall'API vengono quindi utilizzate per mostrare a chi cerca lavoro. Nell'elenco dei risultati vengono restituiti solo i lavori pertinenti che si trovano nell'area del tragitto giornaliero. Consulta la documentazione sulle best practice per la ricerca di lavoro per una discussione su come modificare l'ordine e il numero di lavori restituiti in quest'area.

Generazione di una mappa con informazioni sul tragitto giornaliero (consigliato)

Puoi utilizzare l'API di Google Maps per generare una mappa basata sui tempi di percorrenza del tragitto giornaliero restituiti dall'API CTS e incorporarla nei risultati restituiti a chi cerca lavoro. La suite API di Google Maps offre diverse opzioni per la visualizzazione della mappa. Alcune opzioni dell'API di Google Maps sono più efficaci di altre. Ad esempio, la visualizzazione della mappa termica JavaScript di Google Maps abbinata al clustering degli indicatori è un ottimo modo per visualizzare le offerte di lavoro pertinenti restituite a una persona in cerca di lavoro all'interno dell'area determinata dalle preferenze per il tragitto giornaliero impostate. Al contrario, la modalità Directions non mostra tutti i job restituiti in una richiesta di ricerca e non è un'opzione consigliata.

Nota: l'API di Google Maps prevede varie strutture di determinazione dei prezzi. Questi prezzi NON sono coperti dall'utilizzo di Cloud Talent Solution. I prezzi di Cloud Talent Solution sono coperti solo per l'utilizzo delle API Cloud Talent Solution per richiedere i job entro i tempi di tragitto giornaliero specificati.

Per ulteriori informazioni sull'implementazione di una ricerca basata sul tragitto giornaliero, consulta la guida illustrativa di ricerca del tragitto giornaliero.