Referensi API

Geo Dunia: Negara, Kota & Zona Waktu (GeoNames)

Kategori referensi geografi dunia: 252 negara dengan kode ISO2/ISO3, ibu kota, mata uang, bahasa, kode telepon dan populasi; 69.991 kota (cities5000: populasi di atas 5.000 atau pusat pemerintahan) dengan koordinat, provinsi/negara bagian, populasi dan zona waktu; pencarian kota terdekat dari koordinat; serta 418 zona waktu IANA dengan offset GMT/DST dan waktu lokal saat ini. Datanya dari dump resmi GeoNames berlisensi CC BY 4.0, jadi boleh dipakai komersial asalkan atribusi disertakan.

Data per · Sumber: Dump GeoNames

Endpoint utama
GET https://use.apiindonesia.id/api/v1/geo/negara
Jumlah endpoint
7
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: GeoNames (https://www.geonames.org), dump harian di https://download.geonames.org/export/dump/ (countryInfo.txt, cities5000.zip, admin1CodesASCII.txt, timeZones.txt), dilisensikan di bawah Creative Commons Attribution 4.0 International (CC BY 4.0) sesuai readme.txt dump tersebut. Setiap respons sukses menyertakan meta.attribution berisi kredit GeoNames beserta tautannya, nama dan tautan lisensi, tautan berkas sumber, serta penandaan perubahan, jadi cukup teruskan objek itu pada setiap penyajian ulang. Yang diubah API Indonesia: berkas dump dinormalisasi ke JSON, nama provinsi/negara bagian digabungkan ke data kota, kolom alternatenames dan berkas alternateNamesV2 tidak disertakan, dan waktu lokal pada endpoint zona waktu dihitung oleh API Indonesia. Layanan web GeoNames dan data Zillow tidak dipakai.
Ringkasan Produk

Apa yang Anda dapat dari API ini

Kategori referensi geografi dunia: 252 negara dengan kode ISO2/ISO3, ibu kota, mata uang, bahasa, kode telepon dan populasi; 69.991 kota (cities5000: populasi di atas 5.000 atau pusat pemerintahan) dengan koordinat, provinsi/negara bagian, populasi dan zona waktu; pencarian kota terdekat dari koordinat; serta 418 zona waktu IANA dengan offset GMT/DST dan waktu lokal saat ini. Datanya dari dump resmi GeoNames berlisensi CC BY 4.0, jadi boleh dipakai komersial asalkan atribusi disertakan.

Sumber data: GeoNames (https://www.geonames.org), dump harian di https://download.geonames.org/export/dump/ (countryInfo.txt, cities5000.zip, admin1CodesASCII.txt, timeZones.txt), dilisensikan di bawah Creative Commons Attribution 4.0 International (CC BY 4.0) sesuai readme.txt dump tersebut. Setiap respons sukses menyertakan meta.attribution berisi kredit GeoNames beserta tautannya, nama dan tautan lisensi, tautan berkas sumber, serta penandaan perubahan, jadi cukup teruskan objek itu pada setiap penyajian ulang. Yang diubah API Indonesia: berkas dump dinormalisasi ke JSON, nama provinsi/negara bagian digabungkan ke data kota, kolom alternatenames dan berkas alternateNamesV2 tidak disertakan, dan waktu lokal pada endpoint zona waktu dihitung oleh API Indonesia. Layanan web GeoNames dan data Zillow tidak dipakai.

Cakupan
7

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/geo/negara

Mengembalikan 252 negara dan wilayah dari countryInfo GeoNames, urut nama: ISO2, ISO3, kode numerik, ibu kota, benua, luas, populasi, mata uang, kode telepon (tanpa tanda +), bahasa, TLD, format kode pos, dan negara tetangga.

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.

  • Formulir & checkout internasional: dropdown negara dengan kode telepon dan mata uang, lalu kota per negara.
  • Aplikasi penjadwalan & HR global: tampilkan waktu lokal dan offset zona waktu rekan atau pelanggan di negara lain.
  • Logistik & travel: cari kota terdekat dari sebuah koordinat untuk geocoding kasar atau pengelompokan lokasi.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/geo/negara?q=indo" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "success": true,
  "data": [
    { "iso2": "ID", "iso3": "IDN", "iso_numeric": "360", "fips": "ID", "name": "Indonesia", "capital": "Jakarta", "continent": "AS", "area_km2": 1919440, "population": 285721236, "currency": { "code": "IDR", "name": "Rupiah" }, "phone_code": "62", "languages": ["id", "en", "nl", "jv"], "tld": ".id", "postal_code_format": "#####", "postal_code_regex": "^(\\d{5})$", "neighbours": ["PG", "TL", "MY"], "geonameid": 1643084 }
  ],
  "meta": {
    "total": 1, "page": 1, "per_page": 50, "total_pages": 1,
    "attribution": {
      "source": "GeoNames (https://www.geonames.org)",
      "license": "CC BY 4.0",
      "license_url": "https://creativecommons.org/licenses/by/4.0/",
      "source_url": "https://download.geonames.org/export/dump/",
      "attribution_page": "https://www.geonames.org",
      "notice": "Data diubah: subset cities5000, countryInfo, admin1 dan timeZones dinormalisasi ke format JSON API Indonesia; waktu lokal dihitung oleh API Indonesia"
    }
  }
}

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 Geo Dunia: Negara, Kota & Zona Waktu (GeoNames)

Dari mana data negara, kota, dan zona waktu ini?

Dari dump resmi GeoNames (download.geonames.org/export/dump), berlisensi CC BY 4.0. Layanan web GeoNames tidak dipakai.

Kota apa saja yang tercakup?

Berkas cities5000: tempat berpenduduk di atas 5.000 atau pusat pemerintahan, total 69.991 kota termasuk 485 di Indonesia.

Apakah waktu lokal di endpoint zona waktu selalu terkini?

Ya, waktu lokal dan offset saat ini dihitung pada setiap permintaan dan tidak di-cache. Offset GeoNames dari berkas tetap disertakan sebagai referensi.

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