FAQ Isochrones API

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

Batasan ini didasarkan pada kompleksitas komputasi penghitungan. Kendaraan menempuh jarak 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 maksimal 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" inbound (bepergian ke tujuan) versus isokron outbound (bepergian 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 (Ke dalam batas): Menghitung area yang dapat Anda tempuh dari titik asal to dalam batas waktu yang ditentukan. Hal ini cocok untuk aplikasi seperti fitur perjalanan ke kantor atau penentuan zona cakupan di sekitar kantor pusat atau hub transit.

Terkadang, poligon yang ditampilkan terlihat kotak-kotak atau memiliki tepi yang bergerigi dan bertahap, terutama untuk durasi yang lebih lama. Mengapa level detail berubah?

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

  • Durasi Lebih Singkat: Gunakan petak beresolusi tinggi yang sangat halus karena total area kecil, sehingga menghasilkan batas yang mendetail.
  • Durasi yang Lebih Panjang: 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 menyetel polygon_fidelity opsional ke HIGH, MEDIUM, atau LOW jika Anda memerlukan tingkat detail yang spesifik dan konsisten, terlepas dari durasinya.

Mengapa permintaan isokron untuk koordinat di dalam taman, danau, atau kompleks industri besar terkadang 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, penyesuaian akan gagal, dan API akan menampilkan error NOT_FOUND. Untuk mengatasinya, pastikan koordinat Anda diposisikan dekat dengan jalan atau jalur publik.

Mengapa saya mendapatkan error saat meminta perutean yang mengetahui lalu lintas untuk berjalan kaki atau bersepeda?

Kondisi lalu lintas real time (TRAFFIC_AWARE) didukung secara eksklusif untuk mode perjalanan DRIVE. Jika Anda mencoba meminta isokron untuk WALK atau BICYCLE dengan routingPreference yang disetel ke TRAFFIC_AWARE, API akan menampilkan error 400 INVALID_ARGUMENT.

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.

Dengan mengikuti standar GeoJSON (RFC 7946), Isochrones API menampilkan koordinat dalam urutan [longitude, latitude]. Namun, banyak SDK pemetaan dan objek geometri kustom mengharapkan koordinat dalam urutan [latitude, longitude].

Jika rendering peta Anda salah, periksa cara SDK peta Anda menangani GeoJSON:

  • Google Maps JavaScript API: Jika Anda menggunakan Lapisan Data (map.data.addGeoJson()), urutan ini ditangani secara native dan tidak ada tindakan yang diperlukan.
  • Objek kustom atau SDK lainnya: Jika Anda mengurai respons secara manual ke dalam objek LatLng, Anda harus mengulangi koordinat dalam GeoJSON payload dan mentransposisikan nilai [lng, lat] ke dalam pasangan [lat, lng] sebelum merender.

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

Area kosong mewakili area tanpa jalan yang dapat dijangkau dalam batas waktu. Hal ini umum terjadi di wilayah dengan hutan besar, perairan, bandara, atau properti pribadi yang tidak dapat dilalui kendaraan atau pejalan kaki.

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

  • Tetapkan parameter polygon_fidelity ke MEDIUM atau LOW untuk mendorong algoritma melakukan generalisasi dan penggabungan di atas kesenjangan internal ini.
  • Gunakan library GIS sisi klien (seperti Turf.js) untuk mengurai GeoJSON dan mengekstrak hanya ring koordinat pertama (shell luar), dengan menghapus ring dalam berikutnya (lubang).

Haruskah saya mengaktifkan opsi enable_smoothing untuk analisis spasial backend?

Tidak. Parameter enable_smoothing dirancang murni untuk estetika visual. Fungsi ini membulatkan sudut tajam pada petak perhitungan pokok untuk membuat bentuk terlihat alami di peta.

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