Demander des valeurs localisées

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 (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, mais aussi un texte localisé proposant cette mesure de distance en allemand unités impériales, donc « 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 infère 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 et IMPERIAL unités.
  • La méthode ComputeRouteMatrix utilise par défaut la langue "en-US" et les unités métriques.

Pour demander des valeurs localisées

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

  1. 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")

  2. 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 la page Langues acceptées.

    Par exemple, cet extrait de code spécifie la langue en allemand (de) et les unités métriques :

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