Una richiesta di matrice di percorsi accetta come input un array di waypoint di partenza e di destinazione. L'API Routes calcola quindi il percorso da ogni tappa di origine a ciascuna tappa di destinazione. Ad esempio, se specifichi due waypoint di partenza e due waypoint di destinazione, l'API calcola quattro percorsi distinti.
La risposta dell'API contiene un array, in cui ogni elemento dell'array corrisponde al percorso da un waypoint di partenza a un waypoint di destinazione. Pertanto, se specifichi due waypoint di partenza e due waypoint di destinazione, l'array di risposta contiene quattro elementi, uno per ogni percorso calcolato.
Utilizzando la risposta, puoi offrire ai tuoi clienti diverse opzioni di percorso e poi consentire all'utente di selezionare il percorso appropriato per le sue esigenze.
Informazioni sulle maschere dei campi
Quando chiami un metodo per calcolare un percorso, devi specificare una maschera di campi che definisce i campi da restituire nella risposta. Non esiste un elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore.
Gli esempi in questo documento mostrano l'intero oggetto di risposta senza prendere in considerazione le maschere di campo. In un ambiente di produzione, la risposta includerebbe solo i campi specificati esplicitamente nella maschera di campo.
Per ulteriori informazioni, consulta Scegliere le informazioni da restituire.
Informazioni sulla visualizzazione dei copyright
Quando mostri i risultati agli utenti, devi includere la seguente dichiarazione sul copyright:
Powered by Google, ©YEAR Google
Ad esempio:
Powered by Google, ©2023 Google
Identificare il percorso nella risposta
Utilizza le proprietà di risposta originIndex e destinationIndex per identificare ogni percorso nella risposta. Queste proprietà contengono l'indice a partire da zero dei waypoint di partenza e destinazione inseriti utilizzati per calcolare il percorso. Ciò significa che il primo waypoint di origine e il primo waypoint di destinazione
nella richiesta si trovano all'indice array 0.
Ad esempio, un percorso nella risposta contiene:
"originIndex": 1, "destinationIndex": 0
Queste proprietà indicano che il percorso è stato calcolato dal waypoint di partenza all'indice 1 nell'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 nell'array di input e dal waypoint di destinazione all'indice 1 nell'array di input.
Informazioni sulla risposta
L'oggetto JSON che rappresenta la risposta dell'API contiene un array, in cui ogni elemento dell'array definisce il percorso da un waypoint di partenza a un waypoint di destinazione.
Oltre alle proprietà originIndex e destinationIndex, ogni percorso contiene informazioni specifiche, ad esempio distanceMeters, duration e travelAdvisory.
La risposta ha il seguente 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)
}
}
…
]