Lokalisierte Werte anfordern

Lokalisierte Antwortwerte sind ein zusätzliches Antwortfeld, das lokalisierten Text für zurückgegebene Parameterwerte enthält. Für die Fahrtdauer, die Entfernung und das Einheitensystem (metrische oder angloamerikanische) wird lokalisierter Text bereitgestellt. Sie fordern mithilfe einer Feldmaske lokalisierte Werte an und geben entweder die Sprache und das Einheitensystem an oder verwenden die von der API abgeleiteten Werte. Weitere Informationen finden Sie unter LocalizedValues.

Wenn Sie beispielsweise einen Sprachcode für deutsche (de) und imperiale Einheiten angeben, erhalten Sie für distanceMeters den Wert 49889.7, aber auch lokalisierten Text, der die Entfernungsmessung in deutsch- und imperialen Einheiten angibt, also „31 Meile“.

Hier ist 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 weder die Sprache noch das Einheitensystem angeben, leitet die API die Sprache und Einheiten so ab:

  • Mit der Methode ComputeRoutes werden der Standort und die Entfernungseinheiten vom ursprünglichen Wegpunkt abgeleitet. Bei einer Routinganfrage in den USA leitet die API also die Sprache en-US und IMPERIAL-Einheiten ab.
  • Für die Methode ComputeRouteMatrix werden standardmäßig „en-US“ und die Maßeinheit „METRIC“ verwendet.

Um lokalisierte Werte anzufordern

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

  1. Fordere lokalisierte Werte in deiner 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 wünschen, geben Sie den Sprachcode und das Einheitensystem an:

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

    Weitere Informationen finden Sie unter Sprachunterstützung.

    Dieses Code-Snippet gibt beispielsweise die Sprache als Deutsch (de) und die Maßeinheiten METRIC an:

    "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"
        }
    }
}