Lokalisierte Werte anfordern

Entwickler im Europäischen Wirtschaftsraum (EWR)

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

Hier ein Beispiel dafür, wie lokalisierte Werte aussehen könnten:

{ "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 die Einheiten wie folgt ab:

  • Die ComputeRoutes Methode leitet die Standort- und Entfernung Einheiten vom Ursprungs-Wegpunkt ab. Bei einer Routenanfrage in den USA leitet die API die Sprache en-US und die Einheiten IMPERIAL ab.
  • Die Methode ComputeRouteMatrix verwendet standardmäßig die Sprache „en-US“ und metrische Einheiten.

Lokalisierte Werte anfordern

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

  1. Fordern Sie in Ihrer Feldmaske lokalisierte Werte an. 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 erhalten möchten, geben Sie den Sprachcode und das Einheitensystem an:

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

    In diesem Code-Snippet wird beispielsweise die Sprache 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"
        }
    }
}