Panoramica dell'API Routes

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

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 aree 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:

  • Come assegnare al meglio 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:

  • Percorsi da una località verso 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 le località tra:

  • Ottieni 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 tappe, che puoi ottimizzare in base all'ordine di arrivo 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, USA" 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:

  • 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, vedi Scegliere le informazioni da 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 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 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 instradare passeggeri, spedizioni o lavoratori tra più origini e destinazioni possibili.

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 il 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 che contiene i dettagli della richiesta. Sono obbligatori un'origine, destinazione, TravelMode 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 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 che contiene i dettagli della richiesta. Sono obbligatori almeno un'origine, due o più destinazioni, TravelMode e una maschera dei campi 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 le possibili route per la combinazione di tutte le tappe 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 di reso
ComputeRoutes Restituisce percorsi, tratti e passi per un percorso, con percorsi alternativi, se richiesto. JSON
ComputeRouteMatrix Restituisce un array di route da un waypoint di origine a uno 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 e rivedi la risposta Per ulteriori informazioni, vedi Ottenere un percorso e Esaminare le risposte del percorso.
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.

Passaggi successivi