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 sistem unit dan bahasa atau menggunakan nilai yang disimpulkan oleh API. Untuk mengetahui detailnya, lihat LocalizedValues.

Misalnya, jika Anda menentukan kode bahasa untuk Jerman (de) dan satuan imperial, Anda akan mendapatkan nilai distanceMeters sebesar 49889,7, tetapi juga teks yang dilokalkan yang memberikan pengukuran jarak tersebut dalam satuan imperial dan bahasa Jerman, 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 satuan, API akan menyimpulkan bahasa dan satuan sebagai berikut:

  • Metode ComputeRoutes menyimpulkan satuan lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan pemilihan rute di Amerika Serikat, API menyimpulkan bahasa en-US dan satuan IMPERIAL.
  • Metode ComputeRouteMatrix secara default menggunakan bahasa 'en-US' dan satuan 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 satuan tertentu, tentukan kode bahasa dan sistem satuan:

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

    Misalnya, cuplikan kode ini menentukan bahasa sebagai Jerman (de), dan satuan 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"
        }
    }
}