I valori di risposta localizzati sono un campo di risposta aggiuntivo che fornisce testo localizzato per i valori parametro restituiti. Il testo localizzato è fornito per la durata della corsa, la distanza e il sistema di unità di misura (metrico o imperiale). Hai richiesto localizzati mediante una maschera di campo e puoi specificare la lingua e di unità di misura o utilizzare i valori dedotti dall'API. Per maggiori dettagli, vedi LocalizedValues.
Ad esempio, se specifichi un codice lingua per il tedesco (de) e il sistema imperiale
unità, si ottiene il valore distanceMeters
di 49889,7,
ma anche un testo localizzato che fornisce
la misurazione della distanza in tedesco e
unità imperiali, quindi "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 unità di misura come segue:
- Il metodo
ComputeRoutes
deduce la posizione e la distanza dalla tappa iniziale. Quindi, per una richiesta di routing negli Stati Uniti, deduceen-US
lingua eIMPERIAL
unità. - Per impostazione predefinita, il metodo
ComputeRouteMatrix
è "en-US" lingua e METRIC.
Per richiedere valori localizzati
Per includere valori localizzati nella risposta, devi:
Richiedi valori localizzati nella maschera del campo. Ad esempio:
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Se vuoi che i valori localizzati siano in una lingua o in un sistema di unità specifico, specifica il codice lingua e il sistema di unità:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Per ulteriori informazioni, vedi Lingue supportate.
Ad esempio, questo snippet di codice specifica la lingua come tedesco (de) e Unità METRIC:
"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 distance
, duration
e
staticDuration
campi:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }