Le richieste di ricerca possono includere un filtro relativo alla durata del tragitto giornaliero che limita i lavori restituiti a quelli entro un tempo di percorrenza specificato da un punto di partenza. I risultati includono il tempo di percorrenza stimato in secondi per le offerte di lavoro corrispondenti.
Ricerca di tempi specifici per tragitto giornaliero
Per restituire i job entro un periodo di tempo specifico di un tragitto giornaliero, invia una richiesta jobs.search
e includi un oggetto CommuteFilter
nel campo JobQuery.commuteFilter
. Cloud Talent Solution utilizza il valore address
del job per calcolare il tempo necessario per raggiungere il lavoro. Quando non viene fornito un indirizzo dettagliato, Cloud Talent Solution tenta di dedurre l'indirizzo effettivo del job.
Java
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java CTS.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java CTS.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js CTS.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python CTS.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Campi obbligatori
commuteMethod
: il metodo di trasporto utilizzato per calcolare il tempo del tragitto giornaliero. Le opzioni sono le modalità di trasporto pubblicoDRIVING
,TRANSIT
,WALKING
eCYCLING
. I percorsi a piedi e in bicicletta potrebbero non riflettere condizioni reali, come i lavori in corso, o includere percorsi pedonali o ciclabili ben visibili. Queste risposte includonowarnings
nel risultato restituito, che devi mostrare agli utenti.travelDuration
: il tempo di percorrenza massimo in secondi. Il valore massimo consentito è3600s
(un'ora). Il formato è123s
.startCoordinates
: la latitudine e la longitudine della posizione da cui calcolare i tempi di percorrenza del tragitto giornaliero. Questo campo accetta un oggettoLatLng
.roadTraffic
odepartureTime
: i risultati di ricerca relativi al tragitto giornaliero si basano su dati storici e aggregati anziché sulle condizioni del traffico in tempo reale. Gli utenti ricevono gli stessi risultati di ricerca relativi al tragitto giornaliero a prescindere dall'ora del giorno in cui inviano una query.roadTraffic
: specifica la densità del traffico da utilizzare per il calcolo dei tempi di percorrenza del tragitto giornaliero. Le opzioniBUSY_HOUR
/TRAFFIC_FREE
corrispondono alle condizioni medie calcolate rispettivamente all'ora di punta e a mezzanotte. Questo campo non deve essere presente se è specificatodepartureTime
.departureTime
: l'ora di partenza da utilizzare per calcolare l'impatto sul traffico. Accetta un numero intero compreso tra 0 e 23, che rappresenta l'ora nel fuso orario distartLocation
. Le condizioni del traffico vengono calcolate in base alle condizioni storiche medie del traffico nell'ora specificata. Questo campo non deve essere presente seroadTraffic
è specificato.
Campi facoltativi
allowImpreciseAddresses
: gli indirizzi "esatti" sono definiti come indirizzi a livello stradale o coordinate GPS. SeallowImpreciseAddresses
è impostato sutrue
, potrebbero essere restituite anche le offerte di lavoro con indirizzi "imprecisi" (solo città, provincia o paese). Per gli indirizzi a livello di città e a livello più approssimativo, l'API utilizza la corrispondenza del testo per restituire i risultati. Se questo campo è impostato sufalse
o non è specificato, vengono restituiti solo i job che includono indirizzi precisi.