Meminta nilai yang dilokalkan

Developer Wilayah Ekonomi Eropa (EEA)

Nilai respons yang dilokalkan adalah kolom respons tambahan yang menyediakan teks yang dilokalkan untuk nilai parameter yang ditampilkan. Teks yang dilokalkan disediakan untuk durasi perjalanan, jarak, dan sistem unit (metrik atau imperial). Anda meminta nilai yang dilokalkan menggunakan mask kolom, dan dapat menentukan bahasa dan sistem unit atau menggunakan nilai yang disimpulkan oleh API. Untuk mengetahui detailnya, lihat LocalizedValues.

Misalnya, jika Anda menentukan kode bahasa untuk bahasa Jerman (de) dan unit imperial, Anda akan mendapatkan nilai untuk distanceMeters sebesar 49889,7, tetapi juga teks yang dilokalkan yang memberikan pengukuran jarak tersebut dalam bahasa Jerman dan unit imperial, yaitu "31 Meile".

Berikut adalah contoh tampilan nilai yang dilokalkan:

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

Jika Anda tidak menentukan bahasa atau sistem unit, API akan menyimpulkan bahasa dan unit sebagai berikut:

  • Metode ComputeRoutes menyimpulkan unit lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan perutean di Amerika Serikat, API menyimpulkan bahasa en-US dan unit IMPERIAL.
  • Metode ComputeRouteMatrix secara default menggunakan bahasa 'en-US' dan unit METRIK.

Untuk meminta nilai yang dilokalkan

Untuk menyertakan nilai yang dilokalkan dalam respons, Anda harus melakukan hal berikut:

  1. Minta nilai yang dilokalkan di mask kolom Anda. Contoh:

    REST

    -H X-Goog-FieldMask: routes.localizedValues

    RPC

    const (fieldMask = "routes.localizedValues")

  2. Jika Anda menginginkan nilai yang dilokalkan dalam bahasa atau sistem unit tertentu, tentukan kode bahasa dan sistem unit:

    "languageCode": "language_code",
"units": "METRIC | IMPERIAL",

    Misalnya, cuplikan kode ini menentukan bahasa sebagai bahasa Jerman (de), dan unit METRIK:

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

    Untuk mengetahui informasi selengkapnya, lihat Dukungan Bahasa.

Contoh permintaan

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'

Contoh respons

Respons menampilkan nilai yang dilokalkan untuk kolom distance, duration, dan staticDuration:

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