Esamina la risposta della matrice del percorso

Una richiesta di matrice delle tratte prende come input un array di waypoint di partenza e di arrivo. L'API Routes calcola quindi il percorso da ogni waypoint di partenza a ogni waypoint di destinazione. Ad esempio, se specifichi due waypoint di origine e due waypoint di destinazione, l'API calcola quattro itinerari separati.

La risposta dell'API contiene un array, in cui ogni elemento corrisponde alla rotta da un waypoint di origine a un waypoint di destinazione. Pertanto, se specifichi due tappe di partenza e due tappe di destinazione, l'array di risposta contiene quattro elementi, uno per ogni percorso calcolato.

Utilizzando la risposta, puoi fornire ai tuoi clienti diverse opzioni di percorso e poi lasciare che l'utente selezioni il percorso appropriato per le sue esigenze.

Informazioni sulle maschere di campo

Quando chiami un metodo per calcolare un itinerario, devi specificare una maschera del campo che definisce i campi che vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito di campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore.

Gli esempi in questo documento mostrano l'intero oggetto risposta senza prendere in considerazione le maschere di campo. In un ambiente di produzione, la risposta includerebbe solo i campi specificati esplicitamente nella maschera del campo.

Per saperne di più, vedi Scegliere le informazioni da restituire.

Informazioni sulla visualizzazione dei copyright

Quando mostri i risultati agli utenti, devi includere la seguente dichiarazione di copyright:

Powered by Google, ©YEAR Google

Ad esempio:

Powered by Google, ©2023 Google

Identificare l'itinerario nella risposta

Utilizza le proprietà di risposta originIndex e destinationIndex per identificare ogni percorso nella risposta. Queste proprietà contengono l'indice basato su zero dei waypoint origine e destinazione dell'input utilizzati per calcolare l'itinerario. Ciò significa che il primo waypoint di origine e il primo waypoint di destinazione nella richiesta si trovano all'indice 0 dell'array.

Ad esempio, un itinerario nella risposta contiene:

"originIndex": 1,
"destinationIndex": 0

Queste proprietà indicano che il percorso è stato calcolato dal waypoint di partenza all'indice 1 dell'array di input e dal waypoint di destinazione all'indice 0.

Per il percorso successivo:

"originIndex": 4,
"destinationIndex": 1

Il percorso è stato calcolato dal waypoint di partenza all'indice 4 dell'array di input e dal waypoint di destinazione all'indice 1 dell'array di input.

Informazioni sull'itinerario nella risposta

La risposta dell'API contiene un array, in cui ogni elemento dell'array definisce il percorso da un waypoint di origine a un waypoint di destinazione. Questi elementi sono RouteMatrixElements nel metodo gRPC o nel corpo della risposta nella risposta HTTP.

Oltre alle proprietà originIndex e destinationIndex, ogni elemento contiene solo informazioni di base specifiche per quell'itinerario, come distanceMeters, duration e travelAdvisory. Per ottenere informazioni più dettagliate su un percorso, ad esempio una polilinea, utilizza computeRoutes.

La risposta ha il formato:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]