Lokalisierte Werte anfordern

Lokalisierte Antwortwerte sind ein zusätzliches Antwortfeld, lokalisierten Text für zurückgegebene Parameterwerte. Es wird lokalisierter Text bereitgestellt für Fahrtdauer, Strecke und Einheitensystem (metrisch oder imperial). Ihre Anfrage mithilfe einer Feldmaske lokalisierte Werte und kann entweder die Sprache und oder die vom API abgeleiteten Werte verwenden. Weitere Informationen finden Sie unter LocalizedValues

Wenn Sie beispielsweise einen Sprachcode für Deutsch (de) und angloamerikanisches erhalten Sie für distanceMeters einen Wert von 49889, 7, sondern auch lokalisierten Text auf Deutsch und imperiale Einheiten, also "31 Meile".

Hier 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 keine Sprache oder kein Einheitensystem angeben, leitet die API die Sprache ab. und Einheiten wie folgt:

• Die Methode ComputeRoutes leitet Standort und Entfernung ab Einheiten vom Ausgangswegpunkt entfernt. Für eine Routinganfrage in den USA leitet die API also die Sprache en-US und die Einheiten IMPERIAL ab.
• Die Methode ComputeRouteMatrix ist standardmäßig auf „en-US“ festgelegt. Sprache und METRIC-Einheiten.

So fordern Sie lokalisierte Werte an:

So fügen Sie lokalisierte Werte in die Antwort ein:

1. Fordern Sie lokalisierte Werte in Ihrer Feldmaske an. Beispiel:

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

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

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

   Weitere Informationen finden Sie unter Sprachunterstützung.

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

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

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

Beispielantwort

Die Antwort gibt lokalisierte Werte für distance, duration und staticDuration-Felder:

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