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. Isokron mengemudi satu jam mencakup area geografis dan jaringan jalan yang jauh lebih besar daripada isokron berjalan kaki satu jam, sehingga menghasilkan latensi yang lebih tinggi untuk permintaan mengemudi.

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 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 penempelan ke jalan. Penempelan ke jalan memiliki fitur berikut:

  • Penyelarasan smart: Layanan ini mencoba menyelaraskan titik asal Anda ke segmen jalan yang dapat dilalui terdekat.
  • Kesadaran mode: Logika penempelan 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.

Kesadaran lalu lintas

Kontrol pengaruh data lalu lintas pada 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.

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 secara dinamis kualitas berdasarkan durasi perjalanan yang diminta.
      Fidelitas poligon tinggi, sedang, dan rendah
      Kualitas 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 penghalusan
      Isochrone dengan dan tanpa perataan