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 Strecke und das Einheitensystem (metrisches oder angloamerikanisches Einheitensystem) wird lokalisierter Text bereitgestellt. Sie fordern lokalisierte Werte mithilfe 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 für distanceMeters den Wert 49889.7, aber auch lokalisierten Text mit dieser Entfernungsmessung in deutsch- und angloamerikanischen Einheiten, 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 die Einheiten so ab:

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

Um lokalisierte Werte anzufordern

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 einem bestimmten Sprach- oder Einheitensystem verwenden möchten, 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 Deutsch (de) als Sprache und METRIC-Einheiten 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"
        }
    }
}