PHPackages                             aliziodev/laravel-indonesia-regions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. aliziodev/laravel-indonesia-regions

ActiveLibrary[Utility & Helpers](/categories/utility)

aliziodev/laravel-indonesia-regions
===================================

Laravel package for Indonesia regions selection with postal codes | Package Laravel untuk pemilihan wilayah Indonesia lengkap dengan kode pos

v1.0.16(1mo ago)25391↓65%3MITPHPPHP ^8.2|^8.3|^8.4CI passing

Since Mar 6Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/aliziodev/laravel-indonesia-regions)[ Packagist](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)[ GitHub Sponsors](https://github.com/sponsors/aliziodev)[ RSS](/packages/aliziodev-laravel-indonesia-regions/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (18)Used By (0)

Laravel Indonesia Regions (Laravel Wilayah Indonesia)
=====================================================

[](#laravel-indonesia-regions-laravel-wilayah-indonesia)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c2f96f55fe4ff8f8d188ba15e15c41c7b5579275896812d9ab6ddb796100949e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c697a696f6465762f6c61726176656c2d696e646f6e657369612d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)[![Total Downloads](https://camo.githubusercontent.com/5030538cad3cb60319e636ceb5d13d0e7b7caf842cc358b68011df9f098e84f5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c697a696f6465762f6c61726176656c2d696e646f6e657369612d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)[![PHP Version](https://camo.githubusercontent.com/cf774a5b26219f393c1371af9cabfa6857b0e9707486e69d1c5995a25be877bf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f616c697a696f6465762f6c61726176656c2d696e646f6e657369612d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)[![Laravel Version](https://camo.githubusercontent.com/b0ed3341bf03bc1527750f5897b2f21d0fd01815215e74be4d7b17fa534637bf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e782d7265643f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)[![Laravel Version](https://camo.githubusercontent.com/e2ab74c900c407c3d7b80cd3689bb5c8f2767230a906c7b2c1e6f0ff8da66157/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d7265643f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aliziodev/laravel-indonesia-regions)

Package Laravel untuk data wilayah Indonesia lengkap dengan kode pos. Package ini menyediakan data provinsi, kota/kabupaten, kecamatan, dan desa/kelurahan.

Package ini dipertahankan sebagai package kompatibilitas untuk integrasi lama. Dataset package ini disinkronkan dari repo upstream `aliziodev/laravel-wilayah` dan disimpan sebagai file PHP agar install dan update tetap lintas database.

Fitur
-----

[](#fitur)

- Data wilayah Indonesia lengkap dan terupdate (sesuai Kepmendagri No 300.2.2-2138 Tahun 2025)
- Kode pos untuk setiap desa/kelurahan
- Cache system untuk performa optimal
- Facade untuk penggunaan yang mudah
- Support untuk Laravel 11.x dan 12.x
- Pencarian wilayah
- Pencarian dengan alamat lengkap
- Pencarian full text hingga level desa
- Hirarki/Info wilayah
- Format untuk dropdown/select
- Pagination support
- Format nama negara terbatas ke `Indonesia` atau `ID`
- Sync dataset via command setelah `composer update`
- Pencarian case-insensitive termasuk di PostgreSQL
- Endpoint API bawaan yang siap dipakai

Instalasi
---------

[](#instalasi)

```
composer require aliziodev/laravel-indonesia-regions
```

Kemudian jalankan command instalasi:

```
php artisan indonesia-regions:install
```

Untuk menyinkronkan dataset terbaru setelah package diupdate:

```
php artisan indonesia-regions:sync
```

Opsional, publish konfigurasi cache package:

```
php artisan vendor:publish --tag=indonesia-regions-config
```

Sumber Data
-----------

[](#sumber-data)

Data package ini digenerate dari repo upstream berikut:

```
https://github.com/aliziodev/laravel-wilayah

```

Saat workflow sync berjalan, package akan mengambil dataset dari repo upstream tersebut, menyalinnya ke folder `data/`, lalu aplikasi pengguna cukup menjalankan `php artisan indonesia-regions:sync` untuk melakukan `upsert` ke database.

API Bawaan
----------

[](#api-bawaan)

Package ini menyediakan endpoint API bawaan tanpa perlu membuat controller sendiri. Secara default route akan aktif dengan prefix:

```
/api/indonesia-regions

```

Konfigurasi tersedia di `config/indonesia-regions.php`:

```
'api' => [
    'enabled' => true,
    'prefix' => 'api/indonesia-regions',
    'middleware' => ['api'],
    'responder' => null,
],
```

Jika aplikasi Anda memiliki wrapper response sendiri, Anda bisa mengganti responder bawaan package:

```
'api' => [
    'enabled' => true,
    'prefix' => 'api/indonesia-regions',
    'middleware' => ['api'],
    'responder' => App\Support\Api\RegionApiResponder::class,
],
```

Class tersebut harus mengimplementasikan `Aliziodev\IndonesiaRegions\Contracts\ApiResponderInterface`.

Contoh implementasi:

```