Panoramica di Compute Routes Matrix

Compute Route Matrix è un metodo del servizio API Routes che accetta una richiesta HTTPS e restituisce distanze e tempi di percorrenza per una matrice di percorsi 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 indicazioni stradali? Se ti interessano le indicazioni stradali, consulta la panoramica di Compute Routes.

Stai eseguendo la migrazione? Se stai eseguendo la migrazione dall'API Distance Matrix (legacy), consulta le istruzioni di 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 worker il compito di ritirare una serie di pacchi

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

Che cosa puoi fare con Compute Route Matrix?

Con Compute Route Matrix, puoi ottenere una matrice di possibili percorsi tra molte località di partenza e di arrivo. Puoi specificare più luoghi di partenza e destinazioni per richiesta lato server, con un numero di luoghi di partenza moltiplicato per il numero di destinazioni fino a 625. Puoi eseguire lo streaming degli elementi della risposta prima che l'intera matrice sia stata calcolata, riducendo la latenza della risposta.

Puoi richiedere questi tipi di dati del percorso per determinare il modo più efficiente per instradare passeggeri, spedizioni o worker tra più luoghi di partenza 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 HTTP POST con un corpo della richiesta JSON che contiene i dettagli della richiesta. Sono obbligatori almeno un luogo di partenza, due o più destinazioni, la modalità di viaggio 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 percorsi per la combinazione di tutti i waypoint di partenza e di destinazione.

Risorse

La tabella seguente riassume 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, vedi Librerie client.

Passaggi successivi

• Ottenere una matrice di percorsi
• Opzioni della matrice di percorsi disponibili
• Scegliere le informazioni da restituire
• Eseguire la migrazione dall'API Distance Matrix (legacy)
• Eseguire la migrazione dalla versione di anteprima dell'API Routes alla versione GA