Meminta nilai yang dilokalkan

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

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

Berikut adalah contoh nilai 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 satuan lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan pemilihan rute di AS, API menyimpulkan bahasa en-US dan unit IMPERIAL.
  • Default metode ComputeRouteMatrix adalah bahasa 'en-US' dan unit METRIK.

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 sistem bahasa atau unit tertentu, tentukan kode bahasa dan sistem unit:

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

    Untuk informasi lebih lanjut, lihat Dukungan Bahasa.

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

    "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 akan menampilkan nilai yang dilokalkan untuk kolom distance, duration, dan staticDuration:

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