Una richiesta della matrice di route prende come input un array di waypoint di origine e destinazione. L'API Routes calcola quindi la route da ciascun waypoint di origine a ogni waypoint di destinazione. Ad esempio, se specifichi due waypoint di origine e due di destinazione, l'API calcola quindi quattro route separate.
La risposta dell'API contiene un array in cui ogni elemento dell'array corrisponde alla route da un waypoint di origine a un waypoint di destinazione. Pertanto, se specifichi due waypoint di origine e due waypoint di destinazione, l'array di risposta contiene quattro elementi, uno per ogni route calcolata.
Utilizzando la risposta, puoi fornire ai clienti diverse opzioni di percorso e consentire all'utente di selezionare il percorso appropriato per i loro requisiti.
Informazioni sulle maschere dei campi
Quando chiami un metodo per calcolare una route, devi specificare una maschera di campo che definisca 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 includerà solo i campi specificati esplicitamente nella maschera dei campi.
Per ulteriori informazioni, vedi Scegliere quali informazioni restituire.
Informazioni sulla visualizzazione di contenuti protetti da copyright
Devi includere la seguente dichiarazione sul copyright quando mostri i risultati agli utenti:
Powered by Google, ©YEAR Google
Ad esempio:
Powered by Google, ©2023 Google
Identificare il percorso nella risposta
Utilizza le proprietà della risposta originIndex e destinationIndex per identificare
ciascuna route nella risposta. Queste proprietà contengono l'indice in base zero dei waypoint origin e di input destination utilizzati per calcolare la route. Ciò significa che il primo waypoint di origine e il primo waypoint di destinazione nella richiesta si trovano all'indice dell'array 0.
Ad esempio, una route nella risposta contiene:
"originIndex": 1, "destinationIndex": 0
Queste proprietà indicano che la route è stata calcolata dal waypoint di origine all'indice 1 nell'array di input e dal waypoint di destinazione all'indice 0.
Per il prossimo percorso:
"originIndex": 4, "destinationIndex": 1
La route è stata calcolata dal waypoint di origine 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 array definisce la route da un waypoint di origine a un waypoint di destinazione.
Insieme alle proprietà originIndex e destinationIndex, ogni percorso contiene informazioni specifiche per quel percorso, come 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)
}
}
…
]