Lokalisierte Werte anfordern

Lokalisierte Antwortwerte sind ein zusätzliches Antwortfeld, das lokalisierten Text für zurückgegebene Parameterwerte enthält. Lokalisierter Text wird für die Fahrtdauer, 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 die Entfernung in Deutsch und in imperialen Einheiten angibt, also „31 Meilen“.

Hier sehen Sie ein Beispiel für lokalisierte Werte:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

Wenn Sie die Sprache oder das Einheitensystem nicht angeben, leitet die API die Sprache und Einheiten so ab:

• Die Methode ComputeRoutes leitet 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.
• Die ComputeRouteMatrix-Methode verwendet standardmäßig die Sprache „en-US“ und METRISCHE Einheiten.

Lokalisierte Werte anfordern

Wenn Sie lokalisierte Werte in die Antwort einfügen möchten, müssen Sie Folgendes tun:

1. Lokalisierte Werte in Ihrer Feldmaske anfordern Beispiel:

   REST

   -H X-Goog-FieldMask: routes.localizedValues

   RPC

   const (fieldMask = "routes.localizedValues")

2. Wenn Sie die lokalisierten Werte in einer bestimmten Sprache oder einem bestimmten Einheitensystem abrufen möchten, geben Sie den Sprachcode und das Einheitensystem an:

   "languageCode": "language_code",
   "units": "METRIC | IMPERIAL",

   In diesem Code-Snippet wird die Sprache beispielsweise als Deutsch (de) und die Einheiten als METRIC angegeben:

   "languageCode": "de",
   "units": "METRIC",

   Weitere Informationen finden Sie unter Sprachunterstützung.

Beispielanfrage

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.localizedValues' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Beispielantwort

Die Antwort gibt lokalisierte Werte für die Felder distance, duration und staticDuration zurück:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}