Yerelleştirilmiş yanıt değerleri, döndürülen parametre değerleri için yerelleştirilmiş metin sağlayan ek bir yanıt alanıdır. Yerelleştirilmiş metin şunun için sağlanmıştır: seyahat süresi, mesafe ve birim sistem (metrik veya İngiliz ölçü birimi) Bir alan maskesi kullanarak yerelleştirilmiş değerler istersiniz ve dili ve birim sistemini belirtebilir veya API tarafından tahmin edilen değerleri kullanabilirsiniz. Ayrıntılar için bkz. LocalizedValues.
Örneğin, Almanca (de) ve İngiliz birimleri için bir dil kodu belirtirseniz distanceMeters
için 49889,7 değerini alırsınız. Ayrıca, bu mesafe ölçümünü Almanca ve İngiliz birimleri cinsinden sağlayan yerelleştirilmiş metin de alırsınız. Yani "31 Meile".
Yerelleştirilmiş değerler için göreceğiniz bir örneği aşağıda bulabilirsiniz:
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
Dil veya birim sistemini belirtmezseniz API, dili ve birimleri aşağıdaki şekilde tahmin eder:
ComputeRoutes
yöntemi, konumu ve mesafe birimlerini, başlangıç istem noktasından çıkarır. ABD'deki bir yönlendirme isteği için API,en-US
dil veIMPERIAL
birim çıkar.ComputeRouteMatrix
yöntemi varsayılan olarak "en-US" dilini ve METRIC birimlerini kullanır.
Yerelleştirilmiş değerler istemek için
Yanıta yerelleştirilmiş değerler eklemek için aşağıdakileri yapmanız gerekir:
Alan maskenizde yerelleştirilmiş değerler isteyin. Örneğin:
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Yerelleştirilmiş değerlerin belirli bir dilde veya birim sisteminde gösterilmesini istiyorsanız dil kodunu ve birim sistemini belirtin:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Daha fazla bilgi için Dil desteği bölümüne bakın.
Örneğin, bu kod snippet'inde dil Almanca (de) ve METRIC birimleri belirtilmiştir:
"languageCode": "de", "units": "METRIC",
Örnek istek
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'
Örnek yanıt
Yanıt, distance
, duration
ve staticDuration
alanları için yerelleştirilmiş değerler döndürür:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }