Mega Batch POI Scraper — Panduan Instal / Installation Guide

📦 1. Instalasi Plugin1. Installing the Plugin

Buka QGIS → menu Plugins → Manage and Install Plugins → Install from ZIP.

Pilih file MEGA_BATCH_POI_SCRAPPER_v2.zip, klik Install Plugin. Jika sebelumnya sudah pernah pasang versi 1.0.2, QGIS akan menimpanya secara otomatis.

Pastikan centang aktif di daftar plugin ("Mega Batch POI Scraper Global"). Ikon toolbar 🟢 dan menu Vector → Mega Batch POI Scraper... akan muncul.

Alternatif manual: ekstrak folder MEGA_BATCH_POI_SCRAPPER langsung ke folder profil plugin QGIS Anda, biasanya:
Windows: %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
Lalu restart QGIS.

Open QGIS → Plugins → Manage and Install Plugins → Install from ZIP.

Select MEGA_BATCH_POI_SCRAPPER_v2.zip and click Install Plugin. If v1.0.2 was already installed, QGIS overwrites it automatically.

Make sure it's checked in the plugin list ("Mega Batch POI Scraper Global"). A toolbar icon and the Vector → Mega Batch POI Scraper... menu entry will appear.

Manual alternative: extract the MEGA_BATCH_POI_SCRAPPER folder directly into your QGIS plugins profile folder, typically:
Windows: %APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\
Then restart QGIS.

🧩 2. Dependensi Opsional — Overture Maps2. Optional Dependency — Overture Maps

Sumber OpenStreetMap dan Wikidata langsung jalan tanpa instalasi tambahan. Untuk memakai sumber Overture Maps (opsional, tapi disarankan sebagai cadangan), pasang satu paket Python berikut:

Buka OSGeo4W Shell (Windows) — cari di Start Menu — atau terminal yang memakai Python bawaan QGIS.

Jalankan perintah berikut, lalu tunggu sampai selesai:

pip install overturemaps

Restart QGIS. Opsi sumber "Overture Maps" dan "OSM → Overture" akan langsung bisa dipakai.

Jika lupa memasangnya, plugin tidak akan error — akan muncul pesan yang jelas berisi perintah pip install overturemaps di atas.

OpenStreetMap and Wikidata work out of the box with no extra install. To use the Overture Maps source (optional, but recommended as a fallback), install one Python package:

Open the OSGeo4W Shell (Windows) — find it in the Start Menu — or any terminal using QGIS's own Python.

Run the following command and wait for it to finish:

pip install overturemaps

Restart QGIS. The "Overture Maps" and "OSM → Overture" source options will be ready to use.

Forgetting to install it won't crash the plugin — you'll get a clear message showing the pip install overturemaps command above.

⚙️ 3. Cara Kerja Tiap Sumber Data3. How Each Data Source Works

OpenStreetMap Gratis

Query Overpass memakai tag kunci=nilai yang tepat per kategori (mis. Masjid = amenity=place_of_worship + religion=muslim), bukan pencarian teks bebas. Ini yang memperbaiki bug "0 POI" di versi lama.

Overpass queries use the exact key=value tag per category (e.g. Mosque = amenity=place_of_worship + religion=muslim), not free-text search. This is what fixes the old "0 POI" bug.

Overture Maps Gratis

Membaca dataset "places" global langsung dari bucket publik Overture Maps Foundation, tanpa API key atau kuota.

Reads the global "places" dataset directly from the Overture Maps Foundation's public bucket — no API key, no quota.

OSM → Overture Gratis

Coba OSM dulu; kalau hasilnya 0 untuk satu kombinasi kategori/wilayah, otomatis coba Overture sebagai cadangan.

Tries OSM first; if a category/area combination returns 0 results, automatically retries with Overture as a fallback.

Wikidata Gratis

Cocok untuk landmark/objek terkenal saja, cakupannya lebih sempit.

Best for well-known landmarks only — narrower coverage.

Google Places Butuh API Key

Cakupan sangat luas, tapi berbayar setelah kuota gratis habis.

Very broad coverage, but billed once the free quota runs out.

Foursquare / HERE Butuh API Key

Alternatif berbayar, cakupan bervariasi per wilayah.

Paid alternatives, coverage varies by region.

▶️ 4. Menjalankan Scraper4. Running the Scraper

Klik ikon toolbar atau menu Vector → Mega Batch POI Scraper...
Tab Source & Area: pilih mesin sumber, lalu pilih layer batas administrasi (opsional) atau isi Kelurahan/Kecamatan/Kabupaten-Kota/Provinsi secara manual.
Tab Categories: cari dan centang kategori yang diinginkan.
Tab Run & Log: pilih lokasi file keluaran (.gpkg / .shp), klik Jalankan Scraper.
Pantau progress bar dan log; hasil otomatis dimuat ke kanvas peta setelah selesai.

Click the toolbar icon or Vector → Mega Batch POI Scraper... menu entry.
Source & Area tab: pick a source engine, then either an admin boundary layer (optional) or manual Kelurahan/Kecamatan/Regency-City/Province.
Categories tab: search and check the categories you want.
Run & Log tab: choose an output file (.gpkg / .shp), click Run Scraper.
Watch the progress bar and log; the result auto-loads onto the map canvas when done.

🛠️ 5. Pemecahan Masalah5. Troubleshooting

Gejala	Symptom	—

Masih 0 hasil untuk kategori tertentu: wajar untuk kategori yang memang jarang di-tag di OSM (mis. Pos Ronda). Coba aktifkan mode "OSM → Overture", atau centang "Gunakan batas poligon presisi".
Pesan "overturemaps package not installed": jalankan pip install overturemaps lewat OSGeo4W Shell lalu restart QGIS (lihat bagian 2).
Overpass timeout / error jaringan: plugin otomatis mencoba beberapa server cadangan (mirror); coba lagi beberapa saat, atau kecilkan wilayah pencarian.
Field kolom kota/provinsi kosong di dropdown: pastikan layer batas administrasi sudah dipilih terlebih dahulu di combo box "Layer batas administrasi".

Still 0 results for a category: normal for categories rarely tagged in OSM (e.g. neighborhood guard posts). Try "OSM → Overture" mode, or enable "Use precise polygon boundary".
"overturemaps package not installed" message: run pip install overturemaps via the OSGeo4W Shell then restart QGIS (see section 2).
Overpass timeout / network error: the plugin automatically retries several mirror servers; try again shortly, or narrow the search area.
City/state field dropdowns empty: make sure an admin boundary layer is selected first in the "Admin boundary layer" combo box.