Lokalisierte Werte anfordern

Lokalisierte Antwortwerte sind ein zusätzliches Antwortfeld, das lokalisierten Text für zurückgegebene Parameterwerte enthält. Für Fahrtdauer, Entfernung und Maßeinheit (metrisch oder imperial) wird lokalisierter Text bereitgestellt. Sie fordern lokalisierte Werte mithilfe eines Feldmaskens an und können entweder die Sprache und das Maßsystem 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 Maßeinheiten angeben, erhalten Sie für distanceMeters den Wert 49.889,7, aber auch lokalisierten Text, der diese Entfernungsmessung auf Deutsch und in imperialen Maßeinheiten angibt, 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 die Sprache oder das Maßsystem nicht angeben, leitet die API die Sprache und die Einheiten so ab:

• Die Methode ComputeRoutes leitet die Standort- und Entfernungseinheiten vom Startpunkt ab. Für eine Routinganfrage in den USA leitet die API also die Sprache en-US und die Einheiten IMPERIAL ab.
• Die Standardsprache der ComputeRouteMatrix-Methode ist „en-US“ und die Standardeinheiten sind metrische Einheiten.

So fordern Sie lokalisierte Werte an:

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

1. Fordern Sie in Ihrer Feldmaske lokalisierte Werte 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 die Felder distance, duration und staticDuration zurück:

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