Panoramica di Compute Routes Matrix

Compute Route Matrix è un metodo nel servizio API Routes che accetta una richiesta HTTPS e restituisce distanze e tempi di percorrenza per una matrice di itinerari tra diverse località di partenza e destinazione. Calcola i tempi di percorrenza e le distanze per più destinazioni per un massimo di 625 elementi di percorso.

Hai bisogno di itinerari? Se ti interessano le indicazioni stradali, consulta la panoramica di Compute Routes.

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 Route Matrix

Con Compute Route Matrix, puoi determinare i percorsi più efficienti per la pianificazione delle spedizioni, ad esempio:

• Qual è il modo migliore per assegnare a un insieme di lavoratori il ritiro di una serie di pacchi

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

Che cosa puoi fare con Compute Route Matrix?

Con Compute Route Matrix, puoi ottenere una matrice di possibili percorsi tra più punti di partenza e di arrivo. Puoi specificare più origini e destinazioni per richiesta lato server con il numero di origini moltiplicato per il numero di destinazioni fino a 625. Puoi trasmettere in streaming gli elementi della risposta prima che l'intera matrice sia stata calcolata, riducendo la latenza della risposta.

Puoi richiedere questi tipi di dati di itinerario per determinare il modo più efficiente per instradare passeggeri, spedizioni o lavoratori tra più origini e destinazioni:

• Distanza in chilometri o miglia per una modalità di viaggio selezionata

• Tempo di percorrenza stimato nel traffico

Come funziona Compute Route Matrix

Il metodo ComputeRouteMatrix accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente i dettagli della richiesta. Sono richiesti almeno un'origine, due o più destinazioni, travelMode e una maschera di campo per specificare i campi da restituire.

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 i possibili itinerari per la combinazione di tutti i waypoint di origine e destinazione.

Risorse

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

Come utilizzare Compute Route Matrix

Librerie client disponibili

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

Passaggi successivi

• Ottenere una matrice di itinerari
• Opzioni disponibili per la matrice dei percorsi
• Scegliere quali informazioni restituire
• Eseguire la migrazione dall'API Distance Matrix (legacy)
• Eseguire la migrazione dall'anteprima dell'API Routes alla GA