Una richiesta di matrice di route prende come input un array di tappe di origine 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 tappe di origine e due di destinazione, l'API calcola quattro route separate.
La risposta dell'API contiene un array, in cui ogni elemento array corrisponde al percorso da un waypoint di origine a una destinazione. Di conseguenza, se specifichi due tappe di origine e due 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 poi consentire all'utente di selezionare il percorso appropriato per i suoi requisiti.
Informazioni sulle maschere dei campi
Quando chiami un metodo per calcolare una route, devi specificare una maschera di campo che definisce i campi che devono essere 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 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 la route nella risposta
Utilizza le proprietà di risposta originIndex e destinationIndex per identificare ciascuna route nella risposta. Queste proprietà contengono l'indice basato su zero delle tappe origin di input e destination di input utilizzati per calcolare la route. Ciò significa che il primo waypoint di origine e quello di destinazione
nella richiesta sono in corrispondenza dell'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 percorso successivo:
"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 dell'array definisce la route da un waypoint di origine a uno 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)
}
}
…
]