Panoramica dell'API Routes

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

Perché utilizzare l'API Routes

Con l'API Routes, puoi ottenere informazioni precise sui percorsi e sulle corse utilizzando i dettagli di trasporto, le condizioni aggiornate del traffico e delle strade e le preferenze di percorso:

  • Tipologia e funzionalità dei diversi mezzi di trasporto

  • In quale direzione si sta dirigendo un veicolo

  • Il lato della strada per la salita o la discesa

  • Condizioni del traffico e chiusure stradali

  • Preoccupazioni di sicurezza, ad esempio evitare aree pericolose o fornire aree di prelievo sicure

  • Bilancia latenza, qualità e costi in tutte le tue esigenze di routing con funzionalità facoltative come pedaggi e metadati di corsa come tempo, distanza e risparmio di carburante

Puoi anche determinare i percorsi più efficienti per la pianificazione delle spedizioni, ad esempio:

  • Il modo migliore per assegnare un gruppo di worker per il prelievo di una serie di pacchetti

  • Determina il magazzino migliore da cui spedire i pacchi alla destinazione finale

Che 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 percorsi possibili tra molte località 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à:

  • Ottieni indicazioni stradali per diversi mezzi di trasporto e per una o più destinazioni:

    • Modalità di trasporto, compresi trasporto pubblico, auto, veicoli a due ruote, a piedi o in bicicletta.

    • Una serie di tappe che puoi ottimizzare per viaggiare nel modo più efficiente possibile.

  • Vari 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 la direzione del veicolo

  • Perfeziona i percorsi in base alle tue esigenze e ai tuoi obiettivi:

  • Controlla la latenza e la qualità richiedendo solo i dati necessari utilizzando una maschera di campo, il che consente di evitare tempi di elaborazione superflui e tariffe di fatturazione delle richieste più elevate. Per maggiori dettagli, vedi Scegliere le informazioni da restituire.

Visualizza una matrice di percorsi possibili

Il metodo Compute Route Matrix dell'API Routes fornisce una matrice di informazioni sui percorsi consigliati tra più punti di partenza e di arrivo, compresi la distanza e gli orari di arrivo stimati, per aiutarti a scegliere i luoghi di partenza 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ù possibili origini e destinazioni.

Puoi trasmettere gli elementi della risposta prima che l'intera matrice sia stata calcolata, riducendo così 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 ha due metodi: ComputeRoute e ComputeRouteMatrix.

ComputeRoute

Il metodo ComputeRoute dell'API Routes accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente i dettagli della richiesta. I campi da restituire sono un'origine, una destinazione, un viaggioMode e una maschera di campo.

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 possibili route per la combinazione di tutti i punti di partenza 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 del reso
ComputeRoute Restituisce percorsi, tappe e passi per un percorso, con percorsi alternativi, se richiesti. JSON
ComputeRouteMatrix Restituisce un array di route da un Waypoint di origine a un Waypoint di destinazione.

Come utilizzare l'API Routes

1 Configurazione Per iniziare, consulta Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Calcolare un percorso ed esaminare la risposta Per saperne di più, vedi Trovare un percorso e Esaminare le risposte al 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, consulta Librerie client.

Passaggi successivi