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. 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 ve IMPERIAL 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:

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

    REST

    -H X-Goog-FieldMask: routes.localized_values

    RPC

    const (fieldMask = "routes.localized_values")

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