Les valeurs de réponse localisées sont un champ de réponse supplémentaire qui fournit un texte localisé pour les valeurs de paramètres 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, et vous pouvez soit spécifier la langue et le système d'unités, soit 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 les unités impériales, vous obtenez une valeur de distanceMeters
de 49889,7, mais également le texte localisé fournissant cette mesure de distance en allemand et en unités impériales, soit "31 Meile".
Voici un exemple de ce que vous verriez 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 déduit la langue et les unités comme suit:
- La méthode
ComputeRoutes
déduit les unités de position et de distance du point de cheminement de départ. Ainsi, pour une requête de routage aux États-Unis, l'API déduit la langueen-US
et les unitésIMPERIAL
. - Par défaut, la méthode
ComputeRouteMatrix
utilise 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, procédez comme suit:
Demandez des valeurs localisées dans votre masque de champ. Exemple :
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Si vous souhaitez que les valeurs localisées soient dans une langue ou un système d'unités spécifique, spécifiez le code de langue et le système d'unités:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Pour en savoir plus, consultez la page Langues acceptées.
Par exemple, cet extrait de code spécifie la langue en allemand (de) et en unités METRIC:
"languageCode": "de", "units": "METRIC",
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.localized_values' \ '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" } } }