I valori localizzati della risposta sono un campo di risposta aggiuntivo che fornisce testo localizzato per i valori dei parametri restituiti. Viene fornito un testo localizzato per durata del viaggio, distanza e sistema di unità (sistema metrico o imperiale). Puoi richiedere valori localizzati utilizzando una maschera di campo e puoi specificare la lingua e il sistema di unità o utilizzare i valori dedotti dall'API. Per i dettagli, consulta LocalizedValues.
Ad esempio, se specifichi un codice lingua per il tedesco (de) e le unità imperiali, il valore distanceMeters
è 49889,7, ma anche il testo localizzato che prevede la misurazione della distanza in tedesco e nelle unità imperiali, ad esempio "31 Meile".
Ecco un esempio di ciò che vedresti per i valori localizzati:
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
Se non specifichi la lingua o il sistema di unità, l'API deduce la lingua e le unità come segue:
- Il metodo
ComputeRoutes
deduce le unità di posizione e distanza dal tappa di origine. Di conseguenza, per una richiesta di routing negli Stati Uniti, l'API deduce la linguaen-US
e le unitàIMPERIAL
. - Per impostazione predefinita, il metodo
ComputeRouteMatrix
utilizza la lingua "en-US" e le unità METRIC.
Per richiedere valori localizzati
Per includere valori localizzati nella risposta, devi:
Richiedi valori localizzati nella maschera dei campi. Ad esempio:
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Se desideri che i valori localizzati in una lingua o un sistema di unità specifico, specifica il codice lingua e il sistema di unità:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Per ulteriori informazioni, consulta la pagina Supporto delle lingue.
Ad esempio, questo snippet di codice specifica la lingua come tedesco (de) e unità METRICHE:
"languageCode": "de", "units": "METRIC",
Esempio di richiesta
curl -X POST -d '{ "origin": { "location": { "latLng": { "latitude": 37.7873146, "longitude": -122.4159327 } } }, "destination": { "location": { "latLng": { "latitude": 37.7621008, "longitude": -122.4382503 } } }, "travelMode": "DRIVE", "computeAlternativeRoutes": true, "languageCode": "de", "units": "METRIC" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.localized_values' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Esempio di risposta
La risposta restituisce valori localizzati per i campi distance
, duration
e staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }