Demander des valeurs localisées

Développeurs de l'Espace économique européen (EEE)

Les valeurs de réponse localisées sont un champ de réponse supplémentaire qui fournit du texte localisé pour les valeurs de paramètre renvoyées. Le texte localisé est fourni pour la durée du trajet, la distance et le système d'unités (métrique ou impérial). Vous demandez des valeurs localisées à l'aide d'un masque de champ. Vous pouvez spécifier la langue et le système d'unités, ou utiliser les valeurs déduites par l'API. Pour en savoir plus, consultez LocalizedValues.

Par exemple, si vous spécifiez un code de langue pour l'allemand (de) et des unités impériales, vous obtenez une valeur de 49889,7 pour distanceMeters, mais aussi un texte localisé indiquant cette mesure de distance en allemand et en unités impériales, soit "31 Meile".

Voici un exemple de ce que vous verrez pour les valeurs localisées :

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

Si vous ne spécifiez pas la langue ni le système d'unités, l'API les déduit comme suit :

  • La méthode ComputeRoutes déduit les unités de localisation et de distance du point de cheminement d'origine. Ainsi, pour une requête de routage aux États-Unis, l'API déduit la langue en-US et les unités IMPERIAL.
  • La méthode ComputeRouteMatrix utilise par défaut la langue "en-US" et les unités METRIC.

Pour demander des valeurs localisées

Pour inclure des valeurs localisées dans la réponse, vous devez procéder comme suit :

  1. Demandez des valeurs localisées dans votre masque de champ. Exemple :

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

  2. Si vous souhaitez obtenir les valeurs localisées dans une langue ou un système d'unités spécifiques, indiquez le code de langue et le système d'unités :

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    Par exemple, cet extrait de code spécifie l'allemand (de) comme langue et les unités METRIC :

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

    Pour en savoir plus, consultez la page Langues acceptées.

Exemple de requête

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.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemple de réponse

La réponse renvoie des valeurs localisées pour les champs distance, duration et staticDuration :

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}