Richiedi valori localizzati

I valori di risposta localizzati sono un campo di risposta aggiuntivo che fornisce testo localizzato per i valori dei parametri restituiti. Il testo localizzato è fornito per la durata della corsa, la distanza e il sistema di unità di misura (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 il tedesco (de) e le unità imperiali, ottieni un valore per distanceMeters pari a 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 vedrai 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 deducono la lingua e le unità come segue:

• Il metodo ComputeRoutes deducono le unità di misura della posizione e della distanza dal waypoint di partenza. Pertanto, per una richiesta di routing negli Stati Uniti, l'API deduce la lingua en-US e le unità IMPERIAL.
• Il metodo ComputeRouteMatrix ha come valore predefinito la lingua "en-US" e le unità di misura METRIC.

Per richiedere valori localizzati

Per includere i valori localizzati nella risposta, devi procedere nel seguente modo:

1. Richiedi valori localizzati nella maschera del campo. Ad esempio:

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

2. 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 Assistenza linguistica.

   Ad esempio, questo snippet di codice specifica la lingua tedesca (de) e le unità di misura METRIC:

   "languageCode": "de",
   "units": "METRIC",

Richiesta di esempio

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"
        }
    }
}