Panoramica di Compute Routes

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

Compute Routes è un metodo del servizio API Routes che accetta una richiesta HTTPS e restituisce il percorso ideale tra due località. Fornisci indicazioni stradali con traffico in tempo reale su come spostarsi tra più luoghi con mezzi di trasporto pubblico, in bicicletta, in auto, con veicoli a motore a due ruote o a piedi.

Hai bisogno di matrici di percorsi? Se ti interessa una matrice di percorsi, consulta la panoramica di Compute Route Matrix.

Stai eseguendo la migrazione? Se stai eseguendo la migrazione dall'API Distance Matrix (legacy), consulta le istruzioni per la migrazione a partire da Perché eseguire la migrazione all'API Routes.

Perché utilizzare Compute Routes

Con Compute Routes, grazie a un'ampia gamma di dettagli sui percorsi, puoi instradare i tuoi veicoli o pacchi in base alle tue preferenze, ottimizzando al contempo costi e qualità.

Che cosa puoi fare con Compute Routes?

Con il metodo Compute Routes dell'API Routes puoi eseguire le seguenti operazioni:

  • Ricevere indicazioni stradali per diversi modi di viaggiare e per una o più destinazioni:

    • Mezzi di trasporto: trasporto pubblico, auto, veicoli a due ruote, a piedi o in bicicletta.

    • Una serie di tappe che puoi ottimizzare per l'ordine più efficiente in cui raggiungerle.

  • Utilizzare più 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 posizione

    • Coordinate di latitudine e longitudine, facoltativamente con la direzione del veicolo

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

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

Come funziona Compute Routes

Il metodo ComputeRoutes dell'API Routes accetta una richiesta HTTP POST con un corpo della richiesta JSON che contiene i dettagli della richiesta. Sono obbligatori un'origine, una destinazione, una 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 richiesti.

Risorse

La tabella seguente riassume le risorse disponibili tramite il metodo Compute Routes dell'API Routes, insieme ai dati che restituisce.

Risorse dati Dati restituiti Formato di restituzione
ComputeRoutes Restituisce percorsi, tratte e passaggi per un percorso, con percorsi alternativi, se richiesti. JSON

Come utilizzare Compute Routes

1 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Comprendere come viene fatturata l'API Routes Per informazioni, vedi Utilizzo e fatturazione.
3 Calcolare un percorso e rivedere la risposta Per maggiori informazioni, vedi Ottenere un percorso e Rivedere le risposte del percorso.

Librerie client disponibili

Per un elenco delle librerie client disponibili per Compute Routes, vedi Librerie client.

Passaggi successivi