Le richieste di ricerca possono includere un filtro relativo alla durata del tragitto giornaliero che limita le richieste restituite a quelli all'interno del tempo di percorrenza specificato da un punto di partenza. I risultati includono il tempo di tragitto giornaliero stimato in secondi per le offerte di lavoro corrispondenti.
Ricerca di specifici tempi di percorrenza del tragitto giornaliero
Per restituire i job entro un tempo di percorrenza specifico, invia una richiesta jobs.search
e includi un oggetto CommuteFilter
nel campo JobQuery.commuteFilter
. Cloud Talent Solution utilizza la classe address
del job
per calcolare il tempo necessario per raggiungere quel lavoro. Quando non viene fornito un indirizzo dettagliato, Cloud Talent Solution tenta di dedurre l'indirizzo stradale effettivo della posizione di lavoro.
Java
Per scoprire come installare e utilizzare la libreria client per CTS, consulta Librerie client CTS. Per ulteriori informazioni, consulta API Java di CTS documentazione di riferimento.
Per autenticarti a CTS, configura le 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 ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Java.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per informazioni su come installare e utilizzare la libreria client per CTS, consulta Librerie client di CTS. Per ulteriori informazioni, consulta API Node.js di CTS documentazione di riferimento.
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 ulteriori informazioni, consulta la documentazione di riferimento dell'API CTS Python.
Per eseguire l'autenticazione su CTS, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Campi obbligatori
commuteMethod
: il metodo di trasporto utilizzato per calcolare il dei tragitti giornalieri. Le opzioni sonoDRIVING
,TRANSIT
,WALKING
eCYCLING
per le modalità di trasporto pubblico. I percorsi a piedi e in bicicletta potrebbero non riflettere il mondo reale come la costruzione di un'area o che includono piste ciclabili o percorribili a piedi. Queste risposte includonowarnings
nel risultato restituito, che devi mostrare ai tuoi utenti.travelDuration
: il tempo di percorrenza massimo in secondi. Il numero massimo consentito il valore è3600s
(un'ora). Il formato è123s
.startCoordinates
: la latitudine e la longitudine della posizione da cui calcolare il tempo di percorrenza. Questo campo accettaLatLng
.roadTraffic
odepartureTime
: i risultati di ricerca relativi ai percorsi giornalieri si basano su dati storici e aggregati anziché sulle condizioni del traffico in tempo reale. Gli utenti ricevono gli stessi risultati di ricerca per i tragitti giornalieri indipendentemente dall'ora del giorno in cui inviano una query.roadTraffic
: specifica la densità del traffico da utilizzare per il calcolo dei tragitti giornalieri. Le opzioniBUSY_HOUR
/TRAFFIC_FREE
corrispondono alle condizioni di traffico medio calcolate rispettivamente all'ora di punta mattutina e a mezzanotte. Questo campo non deve essere presente sedepartureTime
è specificato.departureTime
: l'ora di partenza da utilizzare per calcolare l'impatto del 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 alla media la cronologia delle condizioni del traffico all'ora del giorno specificata. Questo campo non deve essere presente se è specificatoroadTraffic
.
Campi facoltativi
allowImpreciseAddresses
: gli indirizzi "esatti" sono definiti come indirizzi a livello di strada o coordinate GPS. SeallowImpreciseAddresses
è impostato sutrue
, potrebbero essere restituiti anche i job con indirizzi "imprecisissimi" (solo città, stato o paese). Per gli indirizzi a livello di città e a livelli più generici, 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.