Perché utilizzare l'API Routes
Con l'API Routes, puoi ottenere percorsi e informazioni su percorsi precisi utilizzando i dettagli sui trasporti, le condizioni aggiornate del traffico e delle strade e il percorso preferenze:
Tipo e capacità dei diversi mezzi di trasporto
La direzione in cui si sta muovendo un veicolo
Il lato della strada per i prelievi o le consegne
Condizioni del traffico e chiusure stradali
Problemi di sicurezza, ad esempio evitare aree pericolose o consentire un ritiro sicuro aree
Bilancia latenza, qualità e costi per tutte le tue esigenze di routing con un'opzione funzionalità come pedaggi e metadati delle corse, come tempo e distanza, e carburante efficienza
Puoi anche determinare i percorsi più efficienti per la pianificazione 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 posizioni di partenza e di arrivo.
Ottenere percorsi per una o più destinazioni
Con il metodo Compute Routes
dell'API Routes,
puoi calcolare tra le località:
Ricevi indicazioni stradali per diversi modi di viaggiare e per una o più destinazioni:
Modalità di trasporto, tra cui trasporto pubblico, guida, 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" o "CWF6+FWX Mountain View, California"
ID luogo
Coordinate di latitudine e longitudine, facoltativamente con orientamento del veicolo
Perfeziona le opzioni del 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, gas. Per ulteriori informazioni, consulta la sezione Ricevere un percorso ecosostenibile.
Imposta opzioni granulari per il calcolo del traffico, in modo da poter prendere decisioni in merito al bilanciamento tra qualità e latenza. Per maggiori dettagli, vedi Specifica come e se includere i dati sul traffico.
Imposta le informazioni sulla direzione di marcia e sul lato della strada per tappe per aumentare l'accuratezza dell'orario di arrivo stimato. Per maggiori dettagli, vedi Specifica l'orientamento del veicolo e il lato della strada.
Specifica le località di passaggio rispetto a quelle dei terminal e le località di sosta sicure. Per i dettagli, vedi Impostare una fermata lungo un percorso e Imposta un punto per il passaggio di 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 di cui hai bisogno utilizzando una maschera del campo, che consente di evitare tempi di elaborazione superflui e richiedere le tariffe di fatturazione. Per maggiori dettagli, vedi Scegli le informazioni da restituire.
Ottieni una matrice di percorsi possibili
Il metodo Compute Route Matrix
dell'API Routes fornisce una tabella di informazioni per i percorsi consigliati tra più punti di partenza e di arrivo, tra cui distanza e tempi di arrivo stimati, per aiutarti a scegliere le origini e le destinazioni migliori in base alle esigenze della tua attività. 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 sulla distanza, puoi determinare il modo più efficiente per calcolare il percorso a passeggeri, spedizioni o lavoratori tra più origini possibili e destinazioni.
Puoi trasmettere in streaming gli elementi della risposta prima che l'intera matrice venga di calcolo, 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 prevede due metodi: ComputeRoutes
e
ComputeRouteMatrix
.
ComputeRoutes
Il metodo ComputeRoutes
dell'API Routes accetta una richiesta POST HTTP con
il corpo di una 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
il corpo di una richiesta JSON contenente i dettagli della richiesta. I valori obbligatori sono almeno uno
origine, due o più destinazioni, TravelMode e una maschera di campo per
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 le possibili route per la combinazione di tutte le origini e le tappe di destinazione.
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Routes insieme ai dati che restituisce.
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 origine a una destinazione tappa successiva. |
Come utilizzare l'API Routes
1 | Configurazione | Inizia con Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
2 | Calcola una route e rivedi la risposta | Per ulteriori informazioni, vedi Ottenere un percorso e Esaminare le risposte del percorso. |
3 | Calcolo della matrice dei percorsi e revisione della risposta | Per ulteriori informazioni, consulta Ottenere una matrice di percorsi e Esaminare la risposta della matrice di percorsi. |
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Routes, consulta Librerie client.