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 satuan (metrik atau imperial). Anda meminta nilai yang dilokalkan menggunakan mask kolom, dan dapat menentukan sistem satuan 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 untuk distanceMeters sebesar 49889,7, tetapi juga teks yang dilokalkan yang memberikan pengukuran jarak dalam satuan imperial dan bahasa Jerman, jadi "31 Meile".

Untuk meminta nilai yang dilokalkan, lakukan langkah-langkah berikut:

  1. Tambahkan kolom localizedValues ke properti fields dari ComputeRoutesRequest.
  2. Jika perlu, tentukan sistem bahasa dan satuan menggunakan properti languageCode dan units dari ComputeRoutesRequest.

Berikut adalah contoh permintaan nilai yang dilokalkan:

const requestWithLocalizedValues = {
  origin: 'San Diego, CA',
  destination: 'Ensenada, MX',
  travelMode: 'DRIVING',
  language: 'es',
  units: google.maps.UnitSystem.METRIC,
  fields: ['path', 'localizedValues', 'distanceMeters', 'durationMillis'],
};

Jika Anda tidak menentukan sistem bahasa atau satuan, metode computeRoutes akan menyimpulkan satuan lokasi dan jarak dari titik jalan asal. Jadi, untuk permintaan pemilihan rute di Amerika Serikat, API menyimpulkan bahasa en-US dan unit IMPERIAL.

Untuk membaca nilai yang dilokalkan, gunakan route.localizedValues. Contoh:

const localizedValues = route.localizedValues;
const distance = localizedValues.distanceMeters;
const duration = localizedValues.duration;
const durationStatic = localizedValues.staticDuration;