Lokalisierte Werte anfordern

Entwickler im Europäischen Wirtschaftsraum (EWR)

Lokalisierte Antwortwerte sind ein zusätzliches Antwortfeld, das lokalisierten Text für zurückgegebene Parameterwerte enthält. Lokalisierter Text wird für die Dauer der Fahrt, die Entfernung und das Einheitensystem (metrisch oder imperial) bereitgestellt. Sie fordern lokalisierte Werte mit einer Feldmaske an und können entweder die Sprache und das Einheitensystem angeben oder die von der API abgeleiteten Werte verwenden. Weitere Informationen finden Sie unter LocalizedValues.

Wenn Sie beispielsweise einen Sprachcode für Deutsch (de) und imperiale Einheiten angeben, erhalten Sie einen Wert für distanceMeters von 49889,7, aber auch lokalisierten Text, der diese Entfernung in Deutsch und imperialen Einheiten angibt, also „31 Meilen“.

So fordern Sie lokalisierte Werte an:

  1. Fügen Sie das Feld localizedValues der Property fields des ComputeRoutesRequest hinzu.
  2. Optional können Sie die Sprache und das Einheitensystem mit den Attributen languageCode und units von ComputeRoutesRequest angeben.

Hier ein Beispiel für das Anfordern lokalisierter Werte:

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

Wenn Sie die Sprache oder das Einheitensystem nicht angeben, leitet die computeRoutes-Methode die Standort- und Entfernungseinheiten vom Ursprungs-Waypoint ab. Bei einer Routinganfrage in den USA leitet die API also die Sprache en-US und die Einheiten IMPERIAL ab.

Verwenden Sie route.localizedValues, um lokalisierte Werte zu lesen. Beispiel:

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