Les valeurs de réponse localisées sont un champ de réponse supplémentaire qui fournit texte localisé pour les valeurs de paramètres renvoyées. Le texte localisé est fourni pour durée du trajet, distance et système d'unités (système métrique ou impérial). Vous demandez localisées à l'aide d'un masque de champ, et peuvent spécifier la langue et d'unités ou d'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 l'impérial,
unités, vous obtenez une valeur distanceMeters
de 49 889,7,
ainsi qu'un texte localisé proposant cette mesure de distance en allemand
unités impériales, donc « 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 de langue ou de système d'unités, l'API déduit la langue et les unités, comme suit:
- La méthode
ComputeRoutes
déduit l'emplacement et la distance. à partir du point de cheminement d'origine. Pour une requête de routage aux États-Unis, déduit :en-US
langue etIMPERIAL
unités. - La méthode
ComputeRouteMatrix
est définie par défaut sur "en-US". langue et 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 obtenir les valeurs localisées 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 Langues acceptées.
Par exemple, cet extrait de code indique que la langue est l'allemand (de). 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 éléments distance
, duration
et
Champs staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }