Pratinjau: Produk atau fitur ini berada dalam status Pratinjau pra-GA. Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Konsep utama

Untuk membuat isokron, berikan API asal, mode perjalanan seperti mengemudi, bersepeda, atau berjalan kaki, dan batas waktu. Anda juga dapat menyesuaikan preferensi perutean dan tampilan visual poligon yang dihasilkan.

Horizon waktu

Batasan utama yang Anda berikan ke layanan adalah travel_duration. Hal ini menentukan cakupan waktu untuk penghitungan.

Durasi maksimum: API mendukung waktu perjalanan maksimum 3.600 detik (1 jam) untuk mode DRIVE, dan 7.200 detik (2 jam) untuk mode WALK dan BICYCLE.
Performa: Waktu penghitungan diskalakan dengan durasi yang diminta dan mode perjalanan yang dipilih. Isochrona mengemudi selama satu jam mencakup area geografis dan jaringan jalan yang jauh lebih besar daripada isokrona berjalan kaki selama satu jam, sehingga menghasilkan latensi yang lebih tinggi untuk permintaan mengemudi.
Pemformatan: Karena API menggunakan google.protobuf.Duration, durasi harus diformat sebagai string yang diakhiri dengan "s" (misalnya, "3600s"), bukan bilangan bulat.

Titik asal dan penyesuaian jalan

Anda dapat menentukan titik awal isokron dengan dua cara:

Koordinat: Pasangan lintang dan bujur (location).
ID Tempat: ID unik untuk tempat tertentu di Google Maps (place). Saat Anda memberikan ID tempat, layanan akan menggunakan sentroid tempat tersebut sebagai titik asal. Perhatikan bahwa API mengharapkan format nama resource, seperti places/ChIJ.... Untuk mengetahui informasi selengkapnya tentang ID tempat, lihat ID Tempat.

Terlepas dari metode input, API tidak menghitung waktu perjalanan dari titik fisik yang tepat jika titik tersebut tidak berada di jalan, seperti di dalam taman atau gedung. Untuk menangani situasi ini, layanan menggunakan penyesuaian jalan. Penyelarasan jalan memiliki fitur berikut:

Penyelarasan smart: Layanan ini mencoba menyelaraskan titik asal Anda ke segmen jalan yang dapat dilalui terdekat.
Kesadaran mode: Logika penarikan mempertimbangkan travel_mode Anda. Jika Anda meminta DRIVE, API akan mengabaikan jalur khusus pejalan kaki dan mencari jalan yang dapat dilalui kendaraan terdekat. Jika Anda meminta WALK, API akan memprioritaskan jalur dan trotoar yang dapat dilalui dengan berjalan kaki.
Kasus kegagalan: Jika API tidak dapat menemukan segmen jalan yang sesuai dalam jarak sekitar 100 meter dari titik asal Anda, API akan menampilkan error 404 NOT_FOUND. Biasanya, hal ini menunjukkan bahwa titik terlalu jauh dari jaringan jalan atau di area tempat data peta tidak mendukung mode perjalanan yang diminta.

Arah perjalanan (Masuk versus Keluar)

Anda dapat menghitung jangkauan masuk dan keluar menggunakan parameter travelDirection:

FROM (Keluar): Menghitung area yang dapat dijangkau dari titik asal dalam batas waktu yang ditentukan. Hal ini cocok untuk kasus penggunaan seperti zona pengiriman atau cakupan layanan.
TO (Masuk): Menghitung area dari tempat Anda dapat melakukan perjalanan ke titik asal dalam batas waktu yang ditentukan. Hal ini cocok untuk menentukan zona jangkauan, seperti tempat karyawan dapat melakukan perjalanan dari rumah ke kantor pusat.

Kesadaran lalu lintas

Kontrol pengaruh data lalu lintas terhadap poligon yang dihasilkan dengan parameter routing_preference:

TRAFFIC_UNAWARE (Default): Menggunakan batas kecepatan dan hierarki jalan untuk membuat poligon isokron. Hal ini menghasilkan bentuk deterministik yang tidak berfluktuasi berdasarkan waktu dalam sehari. Parameter ini ideal untuk analisis umum atau perencanaan skenario dasar.
TRAFFIC_AWARE: Menghitung isokron menggunakan kondisi lalu lintas live atau prediktif pada saat permintaan, sehingga area yang dapat dijangkau menyusut selama kemacetan dan meluas selama jam di luar jam sibuk. Catatan: Perutean yang sadar akan traffic hanya didukung jika travelMode ditetapkan ke DRIVE.

Penghalusan dan akurasi

Anda dapat menyesuaikan tampilan dan presisi poligon output menggunakan parameter polygon_fidelity dan enable_smoothing. Meskipun opsi ini independen, opsi ini bekerja sama untuk menentukan bentuk akhir.

polygon_fidelity: Mengontrol ukuran sel petak pokok yang digunakan untuk menghitung area yang dapat dijangkau.
- LOW: Menggunakan sel petak yang lebih besar. Paling cocok untuk mencakup area yang luas tanpa celah, sehingga menghasilkan bentuk umum.
- MEDIUM: Presisi seimbang.
- HIGH: Menggunakan sel petak yang lebih kecil. Menghasilkan kecocokan yang lebih baik dengan jaringan jalan, tetapi dapat menghasilkan area atau lubang kosong jika jaringan jalan jarang.
- POLYGON_FIDELITY_UNSPECIFIED: Jika tidak ditentukan, layanan akan memilih fidelitas secara dinamis berdasarkan durasi perjalanan yang diminta.
  
  Fidelitas poligon tinggi, sedang, dan rendah
enable_smoothing: Mengontrol apakah tepi tajam sel petak yang ditentukan oleh kualitas dibulatkan.
- false (Raw): Default. Menampilkan perhitungan geometris yang tepat. Tepi tampak bergerigi atau bertingkat. Paling baik untuk akurasi analitis, seperti pengujian titik dalam poligon yang ketat. Latensi lebih rendah daripada yang dihaluskan.
- true (Dihaluskan): Menerapkan algoritma pasca-pemrosesan untuk membulatkan sudut. Terbaik untuk tampilan visual di peta.
  
  Isochrone dengan dan tanpa perataan