Laravel NusaData Administratif Indonesia

Mengapa Laravel Nusa? ​

Laravel Nusa memecahkan tantangan umum dalam mengintegrasikan data administratif Indonesia ke dalam aplikasi Laravel. Daripada mengimpor dan memelihara dataset besar secara manual, Anda mendapatkan:

• Pengaturan Instan: Database SQLite yang sudah dikemas dengan semua data siap pakai
• Data Resmi: Bersumber dari database pemerintah yang berwenang
• Kinerja: Struktur database yang dioptimalkan dengan pengindeksan yang tepat
• Pemeliharaan: Pembaruan otomatis saat data resmi berubah
• Privasi: Versi distribusi tidak termasuk data koordinat sensitif

🏢 Paling Cocok Untuk ​

• E-Commerce: Optimalkan rute pengiriman dan tentukan zona pengiriman yang efisien untuk menyederhanakan logistik.
• Kesehatan: Kelola cakupan fasilitas dan pahami demografi pasien untuk perencanaan layanan yang lebih baik
• Layanan Publik: Berdayakan manajemen warga dan sederhanakan pelaporan administratif dengan wawasan spasial.
• Aplikasi Bisnis: Analisis kinerja regional dan rencanakan ekspansi strategis dengan analitik berbasis lokasi

🚀 Mulai Cepat ​

Instal paket melalui Composer:

composer require creasi/laravel-nusa

Mulai gunakan segera:

use Creasi\Nusa\Models\Province;

// Dapatkan semua provinsi
$provinces = Province::all();

// Cari berdasarkan nama atau kode
$jateng = Province::search('Jawa Tengah')->first();
$jateng = Province::search('33')->first();

// Dapatkan data terkait
$regencies = $jateng->regencies;
$districts = $jateng->districts;
$villages = $jateng->villages;

🌐 Contoh API ​

Akses data melalui endpoint RESTful yang bersih:

# Dapatkan semua provinsi
GET /nusa/provinces

# Dapatkan provinsi tertentu
GET /nusa/provinces/33

# Dapatkan kabupaten/kota di provinsi
GET /nusa/provinces/33/regencies

# Cari dengan parameter kueri
GET /nusa/villages?search=jakarta&codes[]=31.71

📍 Manajemen Alamat ​

Integrasikan fungsionalitas alamat dengan mudah ke dalam model Anda:

use Creasi\Nusa\Contracts\HasAddresses;
use Creasi\Nusa\Models\Concerns\WithAddresses;

class User extends Model implements HasAddresses
{
    use WithAddresses;
}

// Sekarang pengguna Anda dapat memiliki alamat
$user->addresses()->create([
    'province_code' => '33',
    'regency_code' => '33.75',
    'district_code' => '33.75.01',
    'village_code' => '33.75.01.1002',
    'address_line' => 'Jl. Merdeka No. 123'
]);