I valori di risposta localizzati sono un campo di risposta aggiuntivo che fornisce il testo localizzato per i valori dei parametri restituiti. Vengono forniti testi localizzati per durata del viaggio, distanza e sistema di unità di misura (sistema metrico o imperiale). Puoi richiedere valori localizzati utilizzando una maschera di campo e puoi specificare la lingua e il sistema di unità oppure utilizzare i valori dedotti dall'API. Per maggiori dettagli, vedi LocalizedValues.
Ad esempio, se specifichi un codice lingua per le unità tedesche (de) e imperiali, viene restituito un valore distanceMeters
pari a 49889,7, ma viene utilizzato anche testo localizzato che fornisce la misura della distanza in tedesco e imperiale, 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 dalla tappa di origine. Pertanto, per una richiesta di routing negli Stati Uniti, l'API deduce la linguaen-US
e le unitàIMPERIAL
. - Per impostazione predefinita, il metodo
ComputeRouteMatrix
è impostato sulla lingua "en-US" e sulle unità METRIC.
Per richiedere valori localizzati
Per includere valori localizzati nella risposta, devi:
Richiedi valori localizzati nella maschera del campo. Ad esempio:
RESTO
-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 della lingua e il sistema di unità:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Per ulteriori informazioni, consulta la pagina relativa al supporto delle lingue.
Ad esempio, questo snippet di codice specifica la lingua come tedesco (de) e le 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 i campi distance
, duration
e staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }