FAQ Isochrones API

Mengapa saya dapat meminta isokron berjalan kaki atau bersepeda hingga 2 jam, tetapi mengemudi dibatasi hingga 1 jam?

Batasan ini didasarkan pada kompleksitas komputasi perhitungan. Kendaraan menempuh perjalanan yang jauh lebih jauh daripada pejalan kaki atau pengendara sepeda dalam durasi yang sama, yang berarti jaringan jalan yang mendasarinya yang harus dianalisis berkembang secara eksponensial. Mengemudi dibatasi hingga maksimum 1 jam (3.600 detik) untuk memastikan API dapat menampilkan respons dalam jendela sinkron real-time yang cepat, sementara berjalan kaki dan bersepeda didukung hingga 2 jam (7.200 detik).

Bagaimana cara menghitung isokron "perjalanan ke kantor" masuk (perjalanan ke tujuan) versus isokron keluar (perjalanan dari asal)?

Perhitungan masuk dan keluar didukung di v1 API menggunakan parameter travel_direction:

  • FROM (Keluar): Menghitung area yang dapat dijangkau from 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 to titik asal dalam batas waktu yang ditentukan. Hal ini cocok untuk aplikasi seperti fitur perjalanan ke kantor atau menentukan zona cakupan di sekitar kantor pusat atau hub transportasi.

Terkadang poligon yang ditampilkan terlihat kotak-kotak atau memiliki tepi yang bergerigi dan bertingkat, terutama untuk durasi yang lebih lama. Mengapa tingkat detailnya berubah?

Isochrones API menyesuaikan resolusi petak perhitungan spasialnya secara dinamis berdasarkan travel_duration dan travel_mode yang diminta:

  • Durasi yang Lebih Singkat: Menggunakan petak resolusi tinggi yang sangat halus karena total area kecil, sehingga menghasilkan batas yang mendetail.
  • Durasi yang Lebih Lama: Bertransisi ke petak yang lebih kasar dan beresolusi lebih rendah untuk mencakup area geografis yang luas secara efisien tanpa menyebabkan latensi yang parah.

Anda dapat menetapkan polygon_fidelity opsional ke HIGH, MEDIUM, atau LOW jika memerlukan tingkat detail yang spesifik dan konsisten, terlepas dari durasinya.

Mengapa terkadang meminta isokron untuk koordinat di dalam taman, danau, atau kompleks industri besar menampilkan error "Tidak Ditemukan"?

Isochrones API menghitung waktu tempuh menggunakan jalan dan jalur. API harus "menempelkan" titik ke segmen yang kompatibel terdekat sebelum memulai perhitungan jika koordinat asal yang Anda minta tidak berada di jalan yang dikenali.

Setiap mode perjalanan memiliki nilai minimum jarak penempelan maksimum tertentu:

  • DRIVE: 200 meter (mengabaikan jalur khusus pejalan kaki).
  • BICYCLE: 180 meter.
  • WALK: 150 meter.

Jika koordinat asal Anda terletak lebih jauh dari segmen jalan yang valid dan kompatibel dengan mode daripada nilai minimum ini, penempelan akan gagal, dan API akan menampilkan error NOT_FOUND. Untuk mengatasi masalah ini, pastikan koordinat Anda diposisikan dekat dengan jalan atau jalur umum.

Saat saya merender respons GeoJSON di peta, bentuknya ditampilkan di tempat yang salah, terdistorsi, atau gagal dirender. Apa penyebabnya?

Hal ini hampir selalu disebabkan oleh ketidakcocokan urutan koordinat.

Mengikuti standar GeoJSON (RFC 7946), Isochrones API menampilkan koordinat dalam urutan [longitude, latitude]. Namun, banyak SDK pemetaan, termasuk Google Maps JavaScript API dan berbagai komponen peta seluler, mengharapkan koordinat atau objek LatLng dalam urutan [latitude, longitude].

Jika rendering peta Anda salah, Anda harus melakukan loop melalui koordinat dalam payload GeoJSON dan mentransposisi nilai sebelum meneruskannya ke SDK peta.

Mengapa ada "lubang" kosong di dalam poligon isokron saya, dan bisakah saya mendapatkan bentuk padat?

Lubang mewakili area tanpa jalan yang dapat dijangkau dalam batas waktu. Hal ini umum terjadi di wilayah dengan hutan besar, badan air, bandara, atau properti pribadi tempat kendaraan atau pejalan kaki tidak dapat melakukan perjalanan.

v1 API eksternal tidak mengekspos parameter untuk menghapus lubang secara otomatis. Jika aplikasi Anda memerlukan batas yang solid, misalnya, untuk melakukan pemeriksaan penampungan titik dalam poligon, Anda dapat:

  • Menetapkan parameter polygon_fidelity ke MEDIUM atau LOW untuk mendorong algoritma menggeneralisasi dan menggabungkan celah internal ini.
  • Menggunakan library GIS sisi klien (seperti Turf.js) untuk mengurai GeoJSON dan hanya mengekstrak cincin koordinat pertama (shell eksterior), dengan mengabaikan cincin interior berikutnya (lubang).

Haruskah saya mengaktifkan opsi enable_smoothing untuk analisis spasial backend?

Tidak. Parameter enable_smoothing dirancang murni untuk estetika visual. Parameter ini membulatkan sudut tajam petak perhitungan yang mendasarinya agar bentuknya terlihat organik di peta.

Penghalusan tidak direkomendasikan untuk analisis spasial yang akurat karena mengubah verteks dan menggeser batas sedikit. Untuk perhitungan backend, kueri database, atau pengujian titik dalam poligon, tetapkan enable_smoothing ke false untuk memastikan Anda menggunakan batas yang dihitung secara matematis.