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) için yerelleştirilmiş metin sağlanır. Alan maskesi kullanarak yerelleştirilmiş değerler istersiniz. Dil ve birim sistemini belirtebilir veya API tarafından tahmin edilen değerleri kullanabilirsiniz. Ayrıntılı bilgi için LocalizedValues.

Örneğin, Alman (de) ve İngiliz ölçü birimleri için dil kodu belirtirseniz 49889,7 olan distanceMeters değerini alırsınız ve bu mesafe ölçümünü Almanca ve İngiliz ölçü birimleriyle sağlayan yerelleştirilmiş metin de "31 Meile" olur.

Aşağıda, yerelleştirilmiş değerler için görebileceğiniz bir örnek verilmiştir:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

Dili veya birim sistemini belirtmezseniz API, dili ve birimleri şu şekilde tahmin eder:

• ComputeRoutes yöntemi, konum ve uzaklık birimlerini başlangıç noktası noktasından elde eder. Dolayısıyla ABD'deki bir yönlendirme isteği için API, en-US dili ve IMPERIAL birimleri tahmin eder.
• 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ğerler eklemek 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 sayfasını inceleyin.

   Örneğin, bu kod snippet'i dili Almanca (de) ve METRİK 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"
        }
    }
}