Yerelleştirilmiş değerler isteyin

Yerelleştirilmiş yanıt değerleri, döndürülen parametre değerleri için yerelleştirilmiş metin. 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 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}.
  }
}

Dili veya birim sistemini belirtmezseniz API, dili tahmin eder ve birimlere göre aşağıdaki şekilde oluşturulur:

  • 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" olur dil ve METRIC birimleri için geçerlidir.

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

    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 bkz. Dil Desteği.

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

    "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 alan:

{
    "localizedValues": {
        "distance": {
            "text": "15,5 km"
         },
        "duration": {
            "text": "16 Minuten"
        },
        "staticDuration": {
            "text": "16 Minuten"
        }
    }
}