Yerelleştirilmiş değerler isteyin

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çin en-US dilini ve IMPERIAL 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:

1. Alan maskenizde yerelleştirilmiş değerler isteyin. Örneğin:

   REST

   -H X-Goog-FieldMask: routes.localized_values

   TBG

   const (fieldMask = "routes.localized_values")

2. 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"
        }
    }
}