Referensi API

POI Indonesia (Overture Maps Places)

Kategori lokasi: 1.376.228 tempat (POI) di Indonesia dari theme Places Overture Maps Foundation rilis 2026-10-21.0, mulai dari restoran, masjid, sekolah, kantor pemerintah, hotel, hingga toko, dalam 1.250 kategori. Cari berdasarkan awalan nama, kategori, atau kota (locality), cari POI terdekat dari sebuah koordinat, dan ambil detail satu POI. Hanya tempat dengan skor confidence Overture minimal 0,5 yang dimuat, dan setiap POI membawa skornya (0 sampai 1). Hanya theme Places yang dipakai (CDLA Permissive 2.0 dan Apache 2.0), tanpa data OpenStreetMap.

Data per · Sumber: Overture Maps Places (CDLA-P-2.0 / Apache-2.0)

Endpoint utama
GET https://use.apiindonesia.id/api/v1/poi
Jumlah endpoint
4
Autentikasi
Header x-api-key (buat gratis di dashboard)
Harga
2 kredit (Rp2) per request sukses; request gagal gratis
Format
JSON (REST), contoh cURL, JavaScript, Python
Sumber data
Sumber data: Overture Maps Foundation, theme Places (overturemaps.org), rilis 2026-10-21.0, berkas GeoParquet publik di s3://overturemaps-us-west-2/release/2026-10-21.0/theme=places/type=place/. Theme Places dirilis di bawah CDLA Permissive 2.0 (https://cdla.dev/permissive-2-0/) dan Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0) untuk rekaman Foursquare; rekaman AllThePlaces berlisensi CC0 1.0. Atribusi Foursquare: "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. All rights reserved. Available under Apache 2.0. Foursquare data was transformed to the Overture schema. Changed: 2026-03-18." beserta isi lengkap NOTICE.txt Foursquare (https://opensource.foursquare.com/places-notice-txt/), yang juga disertakan utuh di meta.attribution.third_party_notices setiap respons. Yang diubah API Indonesia: hanya rekaman dengan alamat country=ID yang diambil, kolom dipangkas ke yang disajikan, karakter kontrol dibuang dari teks, dan data dinormalisasi ke JSON. Kode wilayah Kemendagri tidak ditambahkan karena pemetaannya memerlukan data batas wilayah dari sumber berlisensi lain.
Ringkasan Produk

Apa yang Anda dapat dari API ini

Kategori lokasi: 1.376.228 tempat (POI) di Indonesia dari theme Places Overture Maps Foundation rilis 2026-10-21.0, mulai dari restoran, masjid, sekolah, kantor pemerintah, hotel, hingga toko, dalam 1.250 kategori. Cari berdasarkan awalan nama, kategori, atau kota (locality), cari POI terdekat dari sebuah koordinat, dan ambil detail satu POI. Hanya tempat dengan skor confidence Overture minimal 0,5 yang dimuat, dan setiap POI membawa skornya (0 sampai 1). Hanya theme Places yang dipakai (CDLA Permissive 2.0 dan Apache 2.0), tanpa data OpenStreetMap.

Sumber data: Overture Maps Foundation, theme Places (overturemaps.org), rilis 2026-10-21.0, berkas GeoParquet publik di s3://overturemaps-us-west-2/release/2026-10-21.0/theme=places/type=place/. Theme Places dirilis di bawah CDLA Permissive 2.0 (https://cdla.dev/permissive-2-0/) dan Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0) untuk rekaman Foursquare; rekaman AllThePlaces berlisensi CC0 1.0. Atribusi Foursquare: "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. All rights reserved. Available under Apache 2.0. Foursquare data was transformed to the Overture schema. Changed: 2026-03-18." beserta isi lengkap NOTICE.txt Foursquare (https://opensource.foursquare.com/places-notice-txt/), yang juga disertakan utuh di meta.attribution.third_party_notices setiap respons. Yang diubah API Indonesia: hanya rekaman dengan alamat country=ID yang diambil, kolom dipangkas ke yang disajikan, karakter kontrol dibuang dari teks, dan data dinormalisasi ke JSON. Kode wilayah Kemendagri tidak ditambahkan karena pemetaannya memerlukan data batas wilayah dari sumber berlisensi lain.

Cakupan
4

endpoint siap pakai dalam produk ini, dengan respons JSON dan pola error yang konsisten.

Akses
API key

Bisa dicoba dengan bonus 3.000 kredit saat daftar, lalu dipakai di production lewat satu API key API Indonesia.

Contoh resource
https://use.apiindonesia.id/api/v1/poi

Daftar POI urut nama. Filter q mencocokkan AWALAN nama tanpa membedakan huruf besar-kecil (q=masjid cocok dengan "Masjid Istiqlal", q=istiqlal tidak). category memakai kunci kategori dari /api/v1/poi/categories, dan locality (alias kota) mencocokkan kota/kabupaten persis seperti tertulis di alamat Overture, contoh "Jakarta Selatan" atau "Surabaya". Filter bisa digabung. per_page maksimum 100 dan offset maksimum 5.000.

Contoh skenario produk

Bagian ini membedakan halaman produk dari dokumentasi. Dokumentasi menjawab cara memanggil endpoint; halaman ini menjawab kenapa endpoint tersebut masuk akal untuk fitur Anda.

  • Aplikasi peta & lokasi: tampilkan tempat di sekitar pengguna (kafe, masjid, ATM, sekolah) tanpa membangun database POI sendiri.
  • Riset pasar & pemilihan lokasi: hitung kepadatan kategori usaha di sebuah kota sebelum membuka cabang.
  • Logistik & aplikasi lapangan: cocokkan titik pelanggan dengan tempat terdekat untuk patokan alamat.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/poi?q=monumen%20nasional&locality=Jakarta%20Pusat&per_page=1" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "success": true,
  "data": [
    {
      "id": "58fef60b-6916-4905-a28b-9dec369147f1",
      "name": "Monumen Nasional",
      "category": "monument",
      "basic_category": "monument",
      "category_hierarchy": ["cultural_and_historic", "memorial_site", "monument"],
      "alternate_categories": [],
      "confidence": 0.9699,
      "lat": -6.1753244,
      "lon": 106.8271812,
      "address": { "freeform": "Jalan Medan Merdeka", "locality": "Jakarta Pusat", "region": null, "postcode": "10310", "country": "ID" },
      "websites": ["http://en.wikipedia.org/wiki/National_Monument_(Indonesia)"],
      "phones": ["+62213823041"],
      "brand": null,
      "operating_status": null,
      "sources": [{ "dataset": "meta", "license": "CDLA-Permissive-2.0" }]
    }
  ],
  "meta": {
    "total": 1, "page": 1, "per_page": 1, "total_pages": 1,
    "attribution": {
      "source": "Overture Maps Foundation, Places theme (overturemaps.org)",
      "license": "CDLA-Permissive-2.0 dan Apache-2.0 (rekaman Foursquare); CC0-1.0 (rekaman AllThePlaces)",
      "license_url": "https://cdla.dev/permissive-2-0/",
      "source_url": "https://docs.overturemaps.org/guides/places/",
      "attribution_page": "https://docs.overturemaps.org/attribution/",
      "notice": "Data diubah oleh API Indonesia: ...",
      "release": "2026-10-21.0",
      "licenses": [ { "name": "CDLA-Permissive-2.0", "url": "https://cdla.dev/permissive-2-0/", "applies_to": "..." }, { "name": "Apache-2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0", "applies_to": "rekaman bersumber Foursquare" }, { "name": "CC0-1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/", "applies_to": "rekaman bersumber AllThePlaces" } ],
      "third_party_notices": [ "Data from Foursquare. Copyright 2024 Foursquare Labs, Inc. ...", "© 2026 Foursquare Labs, Inc. All rights reserved. ...", "Data from AllThePlaces (https://alltheplaces.xyz/). Available under CC0 1.0." ]
    }
  }
}

Artikel Terkait

Harga 2 kredit (Rp2) per request sukses; request gagal gratis. Bonus 3.000 kredit sekali saat daftar, tanpa kartu kredit dan tanpa jatah bulanan.

Butuh filenya saja? Data yang sama juga dijual sebagai file sekali beli, tanpa API key dan tanpa kredit per request.

Lihat semua dataset dan lisensinya

Pertanyaan seputar API POI Indonesia (Overture Maps Places)

Dari mana data POI ini?

Dari theme Places Overture Maps Foundation rilis 2026-10-21.0, difilter ke rekaman beralamat Indonesia (country=ID) dengan confidence minimal 0,5: 1.376.228 POI. Tidak ada data OpenStreetMap di dalamnya.

Bolehkah dipakai untuk aplikasi komersial?

Boleh. Theme Places berlisensi CDLA Permissive 2.0 dan Apache 2.0 (rekaman Foursquare). Teruskan meta.attribution, yang memuat tautan kedua lisensi dan NOTICE Foursquare, saat menyajikan ulang datanya.

Apa arti confidence?

Skor 0 sampai 1 dari Overture tentang seberapa yakin tempat itu benar-benar ada. Sekitar 65% POI Indonesia punya confidence 0,5 atau lebih; saring sendiri sesuai kebutuhan.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik