Yerelleştirilmiş değerler isteyin

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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. Seyahat süresi, mesafe ve birim sistemi (metrik veya İngiliz ölçü sistemi) için yerelleştirilmiş metin sağlanır. Alan maskesi kullanarak yerelleştirilmiş değerler isteyebilir, dili ve birim sistemini belirtebilir veya API tarafından çıkarılan değerleri kullanabilirsiniz. Ayrıntılar için LocalizedValues başlıklı makaleyi inceleyin.

Örneğin, Almanca (de) için bir dil kodu ve İngiliz birimleri belirtirseniz distanceMeters için 49889,7 değeri elde edersiniz. Ancak bu mesafe ölçümünü Almanca ve İngiliz birimleriyle sağlayan yerelleştirilmiş metin de elde edersiniz. Örneğin, "31 Meile".

Yerelleştirilmiş değerler için göreceğiniz örneği aşağıda bulabilirsiniz:

{ "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 aşağıdaki şekilde çıkarır:

  • ComputeRoutes yöntemi, konum ve mesafe birimlerini başlangıç yol noktasından çıkarır. Bu nedenle, ABD'deki bir yönlendirme isteği için API, en-US dili ve IMPERIAL birimleri çıkarır.
  • ComputeRouteMatrix yöntemi varsayılan olarak "en-US" dilini ve METRİK birimleri kullanır.

Yerelleştirilmiş değerler istemek için

Yanıtı yerelleştirilmiş değerlerle birlikte göndermek için aşağıdakileri yapmanız gerekir:

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

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

  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",

    Örneğin, bu kod snippet'i dili Almanca (de) ve birimleri METRIC olarak belirtir:

    "languageCode": "de",
"units": "METRIC",

    Daha fazla bilgi için Dil Desteği başlıklı makaleye bakın.

Ö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.localizedValues' \
'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"
        }
    }
}