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) } } … ]