Demander des valeurs localisées

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

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

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è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. 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 49 889,7 pour distanceMeters, mais aussi un texte localisé indiquant cette mesure de distance en allemand et en unités impériales, soit "31 Meile".

Remarque : Vous obtenez deux valeurs pour la durée prévue : duration utilise le modèle de trafic que vous spécifiez, et staticDuration ne tient pas compte du trafic. Par conséquent, si le modèle de trafic demandé est TRAFFIC_UNAWARE, ces heures sont identiques.

Pour demander des valeurs localisées, procédez comme suit :

1. Ajoutez le champ localizedValues à la propriété fields de ComputeRoutesRequest.
2. Vous pouvez éventuellement spécifier la langue et le système d'unités à l'aide des propriétés languageCode et units de ComputeRoutesRequest.

Voici un exemple de demande de valeurs localisées :

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};
  

Si vous ne spécifiez pas la langue ni le système d'unités, la méthode computeRoutes déduit les unités de localisation 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 langue en-US et les unités IMPERIAL.

Pour lire les valeurs localisées, utilisez route.localizedValues. Exemple :

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;