Perché utilizzare l'API Routes
Con l'API Routes, puoi ottenere informazioni accurate sui percorsi e sulle corse utilizzando i dettagli di trasporto, le condizioni aggiornate del traffico e delle strade e le preferenze di percorso:
Tipo e capacità dei diversi mezzi di trasporto
In quale direzione si sta dirigendo un veicolo
Il lato della strada per le fermate o le fermate
Condizioni del traffico e chiusure stradali
Problemi di sicurezza, come evitare aree pericolose o fornire aree di prelievo sicure
Bilancia latenza, qualità e costi per tutte le tue esigenze di calcolo di percorso con funzionalità facoltative come pedaggi e metadati delle corse, come tempo e distanza,
Puoi anche determinare i percorsi più efficienti per la pianificazione delle spedizioni, ad esempio:
Qual è il modo migliore per assegnare un gruppo di worker per il ritiro di una serie di pacchetti
Determinare il magazzino migliore da cui spedire i pacchi alla destinazione finale
Cosa puoi fare con l'API Routes?
Con l'API Routes, puoi ottenere due categorie principali di informazioni di routing:
Itinerari da una località a una o più destinazioni
Una matrice di possibili percorsi tra molte posizioni di partenza e di arrivo.
Visualizza percorsi per una o più destinazioni
Con il metodo Compute Routes
dell'API Routes,
puoi calcolare tra le località:
Visualizza le indicazioni stradali per diversi modi di viaggiare e per una o più destinazioni:
Modalità di trasporto, ad esempio trasporto pubblico, auto, veicoli a due ruote, a piedi o in bicicletta.
Una serie di waypoint, che puoi ottimizzare per l'ordine più efficiente.
Diversi modi per specificare origini, destinazioni e tappe:
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 intestazione 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, Gas. Per maggiori informazioni, consulta Scegli un percorso ecosostenibile.
Imposta opzioni granulari per il calcolo del traffico, in modo da prendere decisioni di compromesso tra qualità e latenza. Per maggiori dettagli, consulta Specificare come e se includere i dati sul traffico.
Imposta le informazioni di orientamento del veicolo (direzione di marcia) e sul lato della strada per i waypoint per aumentare la precisione dell'orario di arrivo stimato. Per maggiori dettagli, consulta Specificare l'orientamento e il lato della strada del veicolo.
Specifica le posizioni di pass-through, quelle dei terminal e le località di sosta sicure. Per maggiori dettagli, consulta Impostare una fermata lungo un percorso e Impostare un punto di attraversamento di un percorso.
Richiedi informazioni sui pedaggi, la distanza del percorso e l'orario di arrivo stimato. Per maggiori dettagli, vedi Calcolare i pedaggi per un percorso.
Controlla latenza e qualità richiedendo solo i dati necessari utilizzando una maschera di campo, che ti consente di evitare tempi di elaborazione non necessari e tariffe di fatturazione delle richieste più elevate. Per maggiori dettagli, consulta la sezione Scegliere quali informazioni restituire.
Ottieni una matrice di percorsi possibili
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 distanza e orari di arrivo stimati, per aiutarti a scegliere i luoghi di partenza e di arrivo
migliori in base alle tue
esigenze aziendali. Puoi richiedere i seguenti tipi di dati sulla distanza:
Distanza per una modalità di viaggio selezionata
Distanza in chilometri o miglia
Tempo di percorrenza stimato nel traffico
Con i dati sulla distanza, puoi determinare il modo più efficiente per indirizzare passeggeri, spedizioni o lavoratori tra più destinazioni e destinazioni possibili.
Puoi trasmettere elementi della risposta prima che sia stata calcolata l'intera matrice, riducendo la latenza di risposta.
Puoi specificare più origini e destinazioni per richiesta lato server con un numero di origini moltiplicato per il numero di destinazioni (fino a 625).
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 un corpo della richiesta JSON contenente i dettagli della richiesta. Sono obbligatori un'origine,
destinazione, viaggioMode e una maschera di campo per specificare quali campi 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 la route richiesta e restituisce i campi richiesti.
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 quali campi 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 route possibili per la combinazione di tutti i waypoint di origine e di destinazione.
Risorse
La seguente tabella riassume le risorse disponibili tramite l'API Routes insieme ai dati che restituisce.
Risorse di dati | Dati restituiti | Formato restituito |
---|---|---|
ComputeRoutes | Restituisce percorsi, tratti e passaggi per un percorso, con percorsi alternativi, se richiesto. | JSON |
ComputeRouteMatrix | Restituisce un array di route da un waypoint di origine 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 | Calcola una route ed esamina la risposta | Per ulteriori informazioni, vedi Ottenere un percorso e Esaminare le risposte sul percorso. |
3 | Calcola la matrice delle route ed esamina la risposta | Per maggiori informazioni, consulta Ottenere 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, vedi Librerie client.