Perché utilizzare l'API Routes
Con l'API Routes, puoi ottenere informazioni precise sui percorsi e sulle corse utilizzando dettagli sui trasporti, informazioni aggiornate sulle condizioni del traffico e delle strade e le preferenze sui percorsi:
Tipo e capacità dei diversi mezzi di trasporto
La direzione di marcia di un veicolo
Lato della strada in cui è possibile scendere o salire a bordo
Condizioni del traffico e chiusure stradali
Problemi di sicurezza, ad esempio evitare aree pericolose o fornire zone di ritiro sicure
Bilancia latenza, qualità e costi per tutte le tue esigenze di routing con funzionalità facoltative come pedaggi e metadati di corsa, come tempo e distanza, e consumo di carburante
Puoi anche determinare i percorsi più efficienti per la programmazione delle spedizioni, ad esempio:
Il modo migliore per assegnare un insieme di lavoratori per il ritiro di una serie di pacchetti
Determina il magazzino migliore da cui spedire i pacchi alla loro destinazione finale
Che cosa puoi fare con l'API Routes?
Con l'API Routes, puoi ottenere due categorie principali di informazioni sul routing:
Percorsi da una località verso una o più destinazioni
Una matrice di possibili percorsi tra molte località di partenza e di arrivo.
Ottenere percorsi per una o più destinazioni
Con il metodo Compute Routes
dell'API Routes,
puoi calcolare la distanza tra le località:
Ricevi indicazioni stradali per diversi modi di viaggiare e per una o più destinazioni:
Modalità di trasporto, inclusi trasporto pubblico, auto, veicoli a due ruote, a piedi o in bicicletta.
Una serie di waypoint che puoi ottimizzare in base all'ordine più efficiente per percorrerli.
Esistono diversi modi per specificare origini, destinazioni e punti di passaggio:
Stringhe di testo. Ad esempio: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043, USA" o "CWF6+FWX Mountain View, California"
ID luogo
Coordinate di latitudine e longitudine, eventualmente con la direzione del veicolo
Perfeziona le opzioni di percorso in base alle tue esigenze e ai tuoi obiettivi:
Seleziona percorsi a basso consumo di carburante o energia per il tipo di motore del tuo veicolo: Diesel, Elettrico, Ibrido, Benzina. Per ulteriori informazioni, consulta Scegliere un percorso ecosostenibile.
Imposta opzioni granulari per il calcolo del traffico, in modo da poter scegliere un compromesso tra qualità e latenza. Per maggiori dettagli, consulta Specificare come e se includere i dati sul traffico.
Imposta la direzione di marcia del veicolo e le informazioni sul lato della strada per le tappe per aumentare l'accuratezza dell'orario di arrivo stimato. Per maggiori dettagli, consulta Specificare la direzione e il lato della strada del veicolo.
Specifica le posizioni del passthrough, dei terminal e delle fermate sicure. Per maggiori dettagli, consulta Impostare una fermata lungo un percorso e Impostare un punto di passaggio per un percorso.
Richiedi le informazioni sui pedaggi, la distanza del percorso e l'orario di arrivo stimato. Per maggiori dettagli, consulta Calcolare le tariffe per i pedaggi di un itinerario.
Controlla la latenza e la qualità richiedendo solo i dati necessari mediante una maschera di campo, che ti consente di evitare tempi di elaborazione non necessari e tariffe più elevate per la fatturazione delle richieste. Per maggiori dettagli, consulta Scegliere le informazioni da restituire.
Ottenere una matrice di possibili percorsi
Il metodo Compute Route Matrix
dell'API Routes fornisce
una matrice di informazioni per i percorsi consigliati tra più punti di partenza e di arrivo, tra cui la distanza e l'ora di arrivo stimata, per aiutarti a scegliere le origini e le destinazioni migliori in base alle tue esigenze aziendali. Puoi richiedere i seguenti tipi di dati sulle distanze:
Distanza per una modalità di viaggio selezionata
Distanza in chilometri o miglia
Tempo di percorrenza stimato in base al traffico
Con i dati sulle distanze, puoi determinare il modo più efficiente per indirizzare passeggeri, spedizioni o lavoratori tra più possibili origini e destinazioni.
Puoi inviare flussi di elementi della risposta prima che venga calcolata l'intera matrice, riducendo la latenza di risposta.
Puoi specificare più origini e destinazioni per richiesta lato server con un massimo di 625 origini moltiplicate per il numero di destinazioni.
Come funziona l'API Routes
L'API Routes ha due metodi: ComputeRoutes
e
ComputeRouteMatrix
.
ComputeRoutes
Il metodo ComputeRoutes
dell'API Routes accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente i dettagli della richiesta. Sono obbligatori un'origine, una destinazione, un modo di viaggio e una maschera di campo per specificare i campi da restituire.
Esempio
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Il servizio calcola quindi il percorso richiesto e restituisce i campi che hai richiesto.
ComputeRouteMatrix
L'API Routes ComputeRouteMatrix
accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente i dettagli della richiesta. Sono obbligatori almeno un'origine, due o più destinazioni, travelMode e una maschera di campo per specificare i campi da restituire.
Esempio
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
La risposta contiene i possibili percorsi per la combinazione di tutti i waypoint di partenza e di destinazione.
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Routes e i dati restituiti.
Risorse di dati | Dati restituiti | Formato di reso |
---|---|---|
ComputeRoutes | Restituisce percorsi, tratti e passi per un percorso, con percorsi alternativi, se richiesto. | JSON |
ComputeRouteMatrix | Restituisce un array di percorsi da un waypoint di partenza a un waypoint di destinazione. |
Come utilizzare l'API Routes
1 | Configurazione | Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
2 | Calcolare un percorso e esaminare la risposta | Per ulteriori informazioni, vedi Ricevere un itinerario e Esaminare le risposte all'itinerario. |
3 | Calcola la matrice delle route ed esamina la risposta | Per ulteriori informazioni, consulta Recuperare una matrice di route e Esaminare la risposta della matrice di route. |
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Routes, consulta Librerie client.