Meminta nilai yang dilokalkan

Nilai respons yang dilokalkan adalah isian respons tambahan yang memberikan 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 {i>field mask<i}, dan dapat menentukan bahasa dan sistem unit iklan atau menggunakan nilai yang disimpulkan oleh API. Untuk mengetahui detailnya, lihat LocalizedValues.

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

Berikut adalah contoh tampilan 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 menetapkan bahasa atau sistem unit, API akan menyimpulkan bahasa dan unit sebagai berikut:

• Metode ComputeRoutes menyimpulkan lokasi dan jarak unit dari titik jalan asal. Jadi, untuk permintaan perutean di AS, API menyimpulkan en-US bahasa dan IMPERIAL unit.
• Metode ComputeRouteMatrix ditetapkan secara default ke 'en-US' bahasa dan 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 ingin nilai yang dilokalkan dalam bahasa atau sistem unit tertentu, menetapkan kode bahasa dan sistem unit:

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

   Untuk informasi selengkapnya, lihat Dukungan Bahasa.

   Misalnya, cuplikan kode ini menetapkan bahasa sebagai bahasa 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 distance, duration, dan Kolom staticDuration:

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