Una richiesta di matrice di route accetta come input un array di waypoint di origine e di destinazione. L'API Routes calcola quindi la route da ogni waypoint di origine a ogni waypoint di destinazione. Ad esempio, se specifichi due waypoint di origine e due waypoint di destinazione, l'API calcola 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 risposte contiene quattro elementi, uno per ogni route calcolata.
Utilizzando la risposta, puoi fornire ai tuoi clienti diverse opzioni di route e consentire all'utente di selezionare la route appropriata per le sue esigenze.
Informazioni sulle maschere di campo
Quando chiami un metodo per calcolare una route, devi specificare una maschera di 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 di risposta senza tenere conto delle maschere di campo. In un ambiente di produzione, la risposta includerebbe solo i campi che hai specificato esplicitamente nella maschera di campo.
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 di 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 ogni route nella risposta. Queste proprietà contengono l'indice basato su zero dei waypoint di origine e di destinazione di input 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 la route successiva:
"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 route nella risposta
La risposta dell'API contiene un array in cui ogni elemento dell'array definisce la route 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 quella route, come distanceMeters, duration e travelAdvisory. Per ottenere informazioni più dettagliate su una route, ad esempio una polilinea, utilizza computeRoutes.
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) } } … ]