Referensi API

Pelabuhan Indonesia: Pelabuhan Laut & Penyeberangan (RIPN)

Kategori transportasi: 1.082 pelabuhan sesuai Rencana Induk Pelabuhan Nasional (RIPN).

Data per · Sumber: RIPN KP 432/2017, OpenStreetMap (ODbL) & World Port Index

Endpoint utama
GET https://use.apiindonesia.id/api/v1/pelabuhan
Jumlah endpoint
3
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 daftar, hierarki, dan kelas penyeberangan: KP 432 Tahun 2017 tentang RIPN jo. KM 30 Tahun 2020 (peraturan tidak dilindungi hak cipta); Hierarki memakai kolom periode 2022; nilai 2017, 2027, dan 2037 juga disertakan; Belum diterapkan: perubahan KM 172 Tahun 2021 dan sebagian besar KM 217 Tahun 2022; Sumber koordinat: OpenStreetMap ((c) kontributor OpenStreetMap, ODbL 1.0), NGA World Port Index (domain publik), UN/LOCODE (UNECE), dan Wikidata (CC0), hanya bila lolos validasi; terverifikasi (178) berarti minimal dua sumber independen sepakat dalam 5 km dan provinsinya cocok dengan RIPN; sebagian (290) berarti satu sumber dengan provinsi dan kabupaten/kota yang cocok; Pelabuhan lain dimuat tanpa koordinat (lat/lng null, validasi tanpa_koordinat), tidak diisi perkiraan; Setiap respons menyertakan meta.attribution
Ringkasan Produk

Apa yang Anda dapat dari API ini

Kategori transportasi: 1.082 pelabuhan sesuai Rencana Induk Pelabuhan Nasional (RIPN).

  • 637 pelabuhan laut dengan hierarki resmi (28 utama, 164 pengumpul, 165 pengumpan regional, 279 pengumpan lokal)
  • 445 pelabuhan penyeberangan dengan kelas I/II/III
  • Setiap pelabuhan punya provinsi dan kabupaten/kota (kode Kemendagri)
  • 468 pelabuhan punya koordinat yang lolos validasi, 133 punya kode UN/LOCODE, dan 84 punya detail World Port Index
  • Pencarian pelabuhan terdekat dari sebuah koordinat
  • Sumber daftar, hierarki, dan kelas penyeberangan: KP 432 Tahun 2017 tentang RIPN jo. KM 30 Tahun 2020 (peraturan tidak dilindungi hak cipta)
  • Hierarki memakai kolom periode 2022; nilai 2017, 2027, dan 2037 juga disertakan
  • Belum diterapkan: perubahan KM 172 Tahun 2021 dan sebagian besar KM 217 Tahun 2022
  • Sumber koordinat: OpenStreetMap ((c) kontributor OpenStreetMap, ODbL 1.0), NGA World Port Index (domain publik), UN/LOCODE (UNECE), dan Wikidata (CC0), hanya bila lolos validasi
  • terverifikasi (178) berarti minimal dua sumber independen sepakat dalam 5 km dan provinsinya cocok dengan RIPN; sebagian (290) berarti satu sumber dengan provinsi dan kabupaten/kota yang cocok
  • Pelabuhan lain dimuat tanpa koordinat (lat/lng null, validasi tanpa_koordinat), tidak diisi perkiraan
  • Setiap respons menyertakan meta.attribution
Cakupan
3

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/pelabuhan

Mengembalikan 1.082 pelabuhan laut dan penyeberangan dengan hierarki atau kelas, wilayah, UN/LOCODE, koordinat bila tervalidasi, dan status validasi. Filter bisa digabung.

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.

  • Logistik laut: cari pelabuhan terdekat dan hierarkinya untuk perencanaan rute kapal atau ekspedisi.
  • Aplikasi penyeberangan & wisata: tampilkan pelabuhan penyeberangan per kabupaten/kota.
  • Riset & kebijakan: analisis sebaran pelabuhan utama, pengumpul, dan pengumpan per provinsi.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/pelabuhan?hierarki=utama&provinsi=31&per_page=2" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "success": true,
  "data": [
    {
      "id": "tg-priok-jakarta-utara",
      "nama": "Tg. Priok",
      "jenis": "laut",
      "hierarki": "utama",
      "kelas": null,
      "status_operasi": null,
      "provinsi": "Daerah Khusus Ibukota Jakarta",
      "provinsi_kode": "31",
      "kabupaten": "Kota Administrasi Jakarta Utara",
      "kabupaten_kode": "31.72",
      "unlocode": "IDJKT",
      "lat": -6.104507,
      "lng": 106.882862,
      "validasi": "terverifikasi"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 2,
    "total_pages": 1,
    "attribution": {
      "source": "Rencana Induk Pelabuhan Nasional (KP 432 Tahun 2017); © OpenStreetMap contributors; NGA World Port Index; UN/LOCODE; Wikidata",
      "license": "ODbL 1.0 (koordinat dari OpenStreetMap); WPI public domain; Wikidata CC0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://msi.nga.mil/Publications/WPI",
      "attribution_page": "https://www.openstreetmap.org/copyright",
      "notice": "Data diubah: daftar RIPN dicocokkan dengan sumber koordinat terbuka; koordinat hanya diisi bila lolos validasi, oleh API Indonesia",
      "sources": [
        {
          "name": "KP 432 Tahun 2017 tentang Rencana Induk Pelabuhan Nasional (dan perubahannya)",
          "url": "https://jdih.kemenhub.go.id",
          "used_for": "daftar pelabuhan, hierarki, kelas penyeberangan"
        },
        {
          "name": "OpenStreetMap",
          "url": "https://www.openstreetmap.org/copyright",
          "used_for": "koordinat"
        },
        {
          "name": "NGA World Port Index (Pub. 150)",
          "url": "https://msi.nga.mil/Publications/WPI",
          "used_for": "koordinat, atribut pelabuhan"
        },
        {
          "name": "UN/LOCODE (UNECE)",
          "url": "https://unece.org/trade/cefact/unlocode-code-list-country-and-territory",
          "used_for": "kode UN/LOCODE, koordinat"
        },
        {
          "name": "Wikidata",
          "url": "https://www.wikidata.org",
          "used_for": "validasi koordinat"
        }
      ]
    }
  }
}

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.

Pertanyaan seputar API Pelabuhan Indonesia: Pelabuhan Laut & Penyeberangan (RIPN)

Dari mana daftar pelabuhan ini?

Dari Rencana Induk Pelabuhan Nasional: KP 432 Tahun 2017 jo. KM 30 Tahun 2020. Perubahan KM 172 Tahun 2021 dan sebagian besar KM 217 Tahun 2022 belum diterapkan.

Kenapa sebagian pelabuhan tidak punya koordinat?

Koordinat hanya diisi bila lolos validasi (468 pelabuhan). Pelabuhan lain tetap ada dengan lat/lng null dan validasi tanpa_koordinat, bukan diisi perkiraan.

Apa arti terverifikasi dan sebagian?

terverifikasi (178) berarti minimal dua sumber independen (OpenStreetMap, World Port Index, UN/LOCODE) sepakat dalam 5 km dan provinsinya cocok dengan RIPN. sebagian (290) berarti satu sumber dengan provinsi dan kabupaten/kota yang cocok.

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