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. Yolculuk süresi, mesafe ve birim sistem (metrik veya İngiliz ölçü birimi) için yerelleştirilmiş metin sağlanır. Yerelleştirilmiş değerleri alan maskesi kullanarak ister ve dili ve birim sistemini belirtebilir ya da API tarafından tahmin edilen değerleri kullanabilirsiniz. Ayrıntılar için LocalizedValues bölümüne bakın.
Örneğin, Almanca (de) ve İngiliz ölçü birimleri için bir dil kodu belirtirseniz 49889,7 distanceMeters
için bir değer elde edersiniz.Bununla birlikte, bu mesafe ölçümünü Almanca ve İngiliz ölçü birimlerinde sağlayacak şekilde yerelleştirilmiş metni de (yani "31 Meile") elde edersiniz.
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 şu şekilde tahmin eder:
ComputeRoutes
yöntemi, konum ve mesafe birimlerini başlangıç ara noktasından çıkarır. Yani API, ABD'deki bir yönlendirme isteği içinen-US
dilini veIMPERIAL
birimini belirler.ComputeRouteMatrix
yöntemi varsayılan olarak "en-US" dil ve METRIC birimlerine ayarlanır.
Yerelleştirilmiş değerler istemek için
Yanıta yerelleştirilmiş değerleri dahil etmek 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
TBG
const (fieldMask = "routes.localized_values")
Yerelleştirilmiş değerlerin belirli bir dilde veya birim sisteminde olmasını 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ünü inceleyin.
Örneğin, bu kod snippet'i dili Almanca (de) ve METRIC birimleri olarak belirtir:
"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" } } }