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). 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 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 Spracheen-US
undIMPERIAL
-Einheiten ab. - Die Standardsprache der
ComputeRouteMatrix
-Methode ist „en-US“ und die Standardeinheiten sind metrische Einheiten.
Um lokalisierte Werte anzufordern
So fügen Sie lokalisierte Werte in die Antwort ein:
Fordern Sie lokalisierte Werte in Ihrer Feldmaske an. Beispiel:
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
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.
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" } } }