Panoramica di Compute Routes

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

Compute Routes è un metodo del servizio Routes API che accetta una richiesta HTTPS e restituisce l'itinerario 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 itinerari? Se ti interessa una matrice di itinerari, consulta la panoramica di Compute Routes Matrix.

Esegui la migrazione? Se esegui 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 pianificare i percorsi dei 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 fare le seguenti cose:

  • Ottieni 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 raggiungere la destinazione nell'ordine più efficiente.

  • Utilizza più modi per specificare origini, destinazioni e tappe intermedie:

    • 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 le opzioni del percorso 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, che ti aiuta a evitare tempi di elaborazione non necessari e tariffe di fatturazione delle richieste più elevate. Per maggiori 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, 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 l'itinerario richiesto e restituisce i campi che hai richiesto.

Risorse

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

Risorse di dati Dati restituiti Formato del reso
ComputeRoutes Restituisce itinerari, tratte e indicazioni per un percorso, con itinerari alternativi, se richiesti. JSON

Come utilizzare Compute Routes

1 Configurazione Inizia con Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Scopri come funziona la fatturazione dell'API Routes Per informazioni, vedi Utilizzo e fatturazione.
3 Calcolare un percorso e rivedere la risposta Per saperne di più, consulta Ottenere un itinerario e Esaminare le risposte dell'itinerario.

Librerie client disponibili

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

Passaggi successivi