Panoramica dell'API Routes

L'API Routes è un servizio che accetta una richiesta HTTPS e restituisce il percorso ideale tra due luoghi oppure distanze e viaggi per una matrice di percorsi tra diverse località di partenza e di destinazione.

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 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 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 programmazione delle spedizioni, ad esempio: come:

  • 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. destinazione

Cosa puoi fare con l'API Routes?

Con l'API Routes, puoi ottenere due categorie principali di percorsi informazioni:

  • 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 tra le località:

  • Ottenere indicazioni stradali per diversi modi di viaggiare e per uno o più modi destinazioni:

    • Modalità di trasporto, tra cui trasporto pubblico, guida, veicoli a due ruote, a piedi o in bicicletta.

    • Una serie di tappe, che puoi ottimizzare per ottenere l'ordine più efficiente trasportarli.

  • 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 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 un'istanza matrice di informazioni per i percorsi consigliati tra più punti di partenza e di arrivo tra cui la distanza e le ore di arrivo stimate, per aiutarti a scegliere il le migliori origini e destinazioni in base a 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 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 il numero di origini moltiplicate per il numero di destinazioni, fino a un massimo di 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 il corpo di una richiesta JSON contenente i dettagli della richiesta. I valori obbligatori sono un'origine, destinazione, TravelMode 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 Calcola la matrice delle route ed esamina la risposta Per ulteriori informazioni, consulta la sezione Ottenere una matrice del percorso. e Rivedi la risposta della matrice del percorso.

Librerie client disponibili

Per un elenco delle librerie client disponibili per l'API Routes, vedi Librerie client.

Passaggi successivi