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. Seyahat süresi, mesafe ve birim sistemi (metrik veya İngiliz) için yerelleştirilmiş metin sağlanır. 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 LocalizedValues konusuna bakın.

Ö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ğinize dair bir örnek aşağıda verilmiştir:

{ "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 gibi tahmin eder:

  • ComputeRoutes yöntemi, konumu ve mesafe birimlerini başlangıç istem noktasından çıkarır. Bu nedenle, ABD'deki bir yönlendirme isteği için API, en-US dilini ve IMPERIAL birimlerini tahmin eder.
  • ComputeRouteMatrix yöntemi varsayılan olarak "en-US" dili ve METRIC birimleri 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 maskenize 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 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ü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"
        }
    }
}