Meminta nilai yang dilokalkan

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 satuan (metrik atau imperial). Anda meminta nilai yang dilokalkan menggunakan mask kolom, dan dapat menentukan bahasa dan sistem satuan atau menggunakan nilai yang disimpulkan oleh API. Untuk mengetahui detailnya, lihat LocalizedValues.

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

Berikut adalah contoh yang akan Anda lihat untuk 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 unit lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan pemilihan rute di Amerika Serikat, API akan menyimpulkan bahasa en-US dan unit IMPERIAL.
• Metode ComputeRouteMatrix ditetapkan secara default ke bahasa 'en-US' dan unit METRIC.

Untuk meminta nilai yang dilokalkan

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

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

   REST

   -H X-Goog-FieldMask: routes.localized_values

   RPC

   const (fieldMask = "routes.localized_values")

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

   Untuk informasi selengkapnya, lihat Dukungan Bahasa.

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

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

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