Download the PHP package aliziodev/laravel-indonesia-regions without Composer
On this page you can find all versions of the php package aliziodev/laravel-indonesia-regions. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aliziodev/laravel-indonesia-regions
More information about aliziodev/laravel-indonesia-regions
Files in aliziodev/laravel-indonesia-regions
Package laravel-indonesia-regions
Short Description Laravel package for Indonesia regions selection with postal codes | Package Laravel untuk pemilihan wilayah Indonesia lengkap dengan kode pos
License MIT
Informations about the package laravel-indonesia-regions
Laravel Indonesia Regions (Laravel Wilayah Indonesia)
Package Laravel untuk data wilayah Indonesia lengkap dengan kode pos. Package ini menyediakan data provinsi, kota/kabupaten, kecamatan, dan desa/kelurahan.
Fitur
- Data wilayah Indonesia lengkap dan terupdate (sesuai dengan Kepmendagri No 100.1.1-6117 Tahun 2022)
- Kode pos untuk setiap desa/kelurahan
- Koordinat latitude dan longitude untuk setiap wilayah
- 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
- Kustomisasi nama negara
Instalasi
Kemudian jalankan command instalasi:
Gaya Penulisan Parameter
Package ini mendukung dua gaya penulisan parameter:
1. Regular Parameters (Traditional)
2. Named Parameters
Kedua gaya penulisan akan memberikan hasil yang sama. Named parameters (PHP 8.0+) memiliki beberapa keunggulan:
- Lebih mudah dibaca dan dipahami
- Mengurangi kesalahan dalam urutan parameter
- Memungkinkan untuk melewati parameter opsional di tengah
- Self-documenting code
- IDE support yang lebih baik Pilih gaya penulisan yang sesuai dengan kebutuhan dan versi PHP yang Anda gunakan.
Penggunaan
Mengambil Data Wilayah (getRegions)
Perlu diingat bahwa jika parameter columns
tidak diisi (null), maka akan menggunakan default columns yaitu ['code', 'name', 'postal_code']
. Untuk mengambil semua kolom, Anda perlu secara eksplisit menentukan columns: ['*']
.
Pencarian (search)
Pencarian dengan Alamat Lengkap (searchWithAddress)
Pencarian Full Text (searchWithFullText)
Mencari Berdasarkan Kode (findByCode)
Format Dropdown/Select (getForSelect)
Informasi Detail Wilayah (getRegionInfo)
Alamat Lengkap (getFullAddress)
Pencarian Kode Pos (findByPostalCode)
Validasi Kode (validateCode)
Mendapatkan Tipe Wilayah (getRegionType)
Cache Management
Struktur Kode Wilayah
- Provinsi: 2 digit (contoh: 11)
- Kota/Kabupaten: 5 digit (contoh: 11.01)
- Kecamatan: 8 digit (contoh: 11.01.01)
- Desa/Kelurahan: 13 digit (contoh: 11.01.01.2001)
Kolom Database
- code : Kode wilayah (primary key)
- name : Nama wilayah
- postal_code : Kode pos (untuk desa/kelurahan)
- latitude : Koordinat garis lintang
- longitude : Koordinat garis bujur
- status : Status wilayah aktif/tidak aktif (optional)
Method Parameters
getRegions
parentCode
(string|null) : Kode wilayah parent (opsional)columns
(array|null) : Kolom yang akan diambil (default: ['code', 'name', 'postal_code'])perPage
(int|null) : Jumlah data per halaman untuk pagination (opsional)
search
term
(string) : Kata kunci pencariantype
(string|null) : Tipe wilayah ('province'|'city'|'district'|'village')perPage
(int|null) : Jumlah data per halaman untuk pagination (opsional)
searchWithAddress
term
(string) : Kata kunci pencariantype
(string|null) : Tipe wilayah ('province'|'city'|'district'|'village')perPage
(int|null) : Jumlah data per halaman untuk pagination (opsional)columns
(array|null) : Kolom yang akan diambilcountryName
(string|null) : Nama negara untuk alamat lengkap (default: 'Indonesia')
searchWithFullText
term
(string) : Kata kunci pencarianlimit
(int|null) : Batas jumlah hasil pencarian (default: 15)countryName
(string|null) : Nama negara untuk alamat lengkap (default: 'Indonesia')
findByCode
code
(string) : Kode wilayahcolumns
(array|null) : Kolom yang akan diambil (default: ['*'])
getForSelect
parentCode
(string|null) : Kode wilayah parent (opsional)
getRegionInfo
code
(string) : Kode wilayahcolumns
(array|null) : Kolom yang akan diambil (default: ['code', 'name', 'postal_code'])countryName
(string|null) : Nama negara untuk alamat lengkap (default: 'Indonesia')
getFullAddress
villageCode
(string) : Kode desa/kelurahancountryName
(string|null) : Nama negara untuk alamat lengkap (default: 'Indonesia')
findByPostalCode
postalCode
(string) : Kode pos
validateCode
code
(string) : Kode wilayah yang akan divalidasi
getRegionType
code
(string) : Kode wilayah
Ucapan Terima Kasih
Package ini menggunakan data wilayah dari cahyadsn/wilayah . Terima kasih kepada @cahyadsn yang telah menyediakan dan memelihara data wilayah Indonesia.
Kontribusi
Silakan buat issue atau pull request untuk kontribusi.
Lisensi
Package ini di bawah lisensi MIT.