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à.

Cosa puoi fare con Compute Routes?

Con il metodo Compute Routes dell'API Routes, puoi:

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

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

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

  • Utilizza 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 luogo

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

  • Perfeziona le opzioni di 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 di campo, che ti aiuta a evitare tempi di elaborazione non necessari e tariffe di fatturazione delle richieste più elevate. Per maggiori dettagli, consulta Scegli le informazioni da restituire.

Come funziona Compute Routes

Il metodo ComputeRoutes dell'API Routes accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente 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 il percorso richiesto e restituisce i campi che hai richiesto.

Risorse

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

Risorse di dati Dati restituiti Formato di reso
ComputeRoutes Restituisce percorsi, tappe e passaggi per un percorso, con itinerari alternativi, se richiesto. JSON

Come utilizzare Compute Routes

1 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Scopri come viene fatturata l'API Routes Per informazioni, consulta Utilizzo e fatturazione.
3 Calcola un percorso ed esamina la risposta Per saperne di più, consulta Ottieni un percorso e Esamina le risposte relative al percorso.

Librerie client disponibili

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

Passaggi successivi