Panoramica dell'API Routes

L'API Routes è un servizio che accetta una richiesta HTTPS e restituisce il percorso ideale tra due località o le distanze e i tempi di percorrenza per una matrice di percorsi tra località di partenza e di destinazione diverse.

Perché utilizzare l'API Routes

Con l'API Routes, puoi ottenere percorsi e informazioni sui viaggi accurati utilizzando dettagli sui trasporti, condizioni stradali e del traffico aggiornate e preferenze per i percorsi:

  • Tipo e funzionalità di 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 fornire zone di ritiro sicure

  • Bilancia la latenza, la qualità e il costo in base alle tue esigenze di routing con funzionalità facoltative come pedaggi e metadati dei viaggi, come tempo e distanza, nonché l'efficienza del carburante

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à a 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, tra cui trasporto pubblico, guida, veicoli a due ruote, camminata o 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, eventualmente con la direzione del veicolo

  • Perfeziona le opzioni di percorso in base alle tue esigenze e ai tuoi obiettivi:

  • Controlla la latenza e la qualità richiedendo solo i dati di cui hai bisogno 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 Scegliere le informazioni da restituire.

Ottenere una matrice di possibili percorsi

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 sulle distanze, puoi determinare il modo più efficiente per indirizzare passeggeri, spedizioni o lavoratori tra più possibili origini e destinazioni.

Puoi trasmettere in streaming gli elementi della risposta prima che l'intera matrice sia stata calcolata, riducendo la latenza della 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 passaggi per un percorso, con percorsi alternativi, se richiesti. 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 Configurare il progetto Google Cloud e completa le istruzioni di configurazione che seguono.
2 Calcolare un percorso e rivedere la risposta Per ulteriori informazioni, vedi Ricevere un itinerario e Esaminare le risposte all'itinerario.
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.

Passaggi successivi