Nilai respons yang dilokalkan adalah kolom respons tambahan yang menyediakan teks yang dilokalkan untuk parameter value 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 sistem bahasa dan unit atau menggunakan nilai yang disimpulkan oleh API. Untuk mengetahui detailnya, lihat LocalizedValues.
Misalnya, jika Anda menentukan kode bahasa untuk unit bahasa Jerman (de) dan
imperial, Anda akan mendapatkan nilai untuk distanceMeters
sebesar 49889,7,
tetapi juga teks yang dilokalkan yang menyediakan pengukuran jarak tersebut 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 menentukan sistem unit atau bahasa, API akan menyimpulkan bahasa dan unit sebagai berikut:
- Metode
ComputeRoutes
menyimpulkan unit lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan pemilihan rute di AS, API menyimpulkan bahasaen-US
dan unitIMPERIAL
. - 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:
Minta nilai yang dilokalkan di mask kolom Anda. Contoh:
REST
-H X-Goog-FieldMask: routes.localized_values
RPC
const (fieldMask = "routes.localized_values")
Jika Anda ingin nilai yang dilokalkan dalam bahasa atau sistem unit tertentu, tentukan kode bahasa dan sistem unit:
"languageCode": "language_code", "units": "METRIC | IMPERIAL",
Untuk mengetahui informasi selengkapnya, lihat Dukungan Bahasa.
Misalnya, cuplikan kode ini menentukan bahasa sebagai unit bahasa Jerman (de), dan 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
Responsnya menampilkan nilai yang dilokalkan untuk kolom distance
, duration
, dan staticDuration
:
{ "localizedValues": { "distance": { "text": "15,5 km" }, "duration": { "text": "16 Minuten" }, "staticDuration": { "text": "16 Minuten" } } }