README

Laravel Areanesia是一个用于保存印度尼西亚地区数据的Laravel包，从省、市/县、区/街道到村/社区。该包将在您的项目中添加迁移、种子（用于导入数据到数据库）和模型。

所有数据都将存储在数据库中，获取数据的方式与通常通过模型获取数据相同（参见用法部分）。

这些数据来自Pemutakhiran MFD和MBS Badan Pusat Statistik网站（http://mfdonline.bps.go.id/）于2018年1月11日。来源：https://github.com/edwardsamuel/Wilayah-Administratif-Indonesia。

快速安装

# Install package
composer require riipandi/laravel-areanesia

# Publish files
php artisan areanesia:publish

# Dump load composer
composer dump-autoload

注册服务提供商

Laravel

如果您使用的是5.5及以上版本的Laravel，您可以跳过此部分，因为该包已经使用了包自动发现。

但是，如果您正在工作的项目仍然使用低于5.5的版本，那么请打开文件config/app.php，然后将AreanesiaServiceProvider类添加到服务提供商数组中

// Provider Lain
Riipandi\Areanesia\AreanesiaServiceProvider::class,

Lumen

如果您想在该Lumen项目中使用此包，那么您需要在bootstrap/app.php文件中注册服务提供商，添加以下内容

$app->register(Riipandi\Areanesia\AreanesiaServiceProvider::class);

迁移和种子

运行以下命令以运行迁移和种子

php artisan migrate

# Import semua data dari Provinsi sampai Kelurahan sekaligus
php artisan db:seed --class=AreanesiaSeeder   # Import data Provinsi, Kota/Kabupaten, Kecamatan/Distrik dan Desa/Kelurahan

# Anda juga bisa melakukan Import data satu per satu, mulai dari Provinsi sampai Kelurahan
php artisan db:seed --class=AreanesiaProvinceSeeder      # Import data provinsi
php artisan db:seed --class=AreanesiaRegencySeeder       # Import data kota/kabupaten
php artisan db:seed --class=AreanesiaDistrictSeeder      # Import data kecamatan/distrik
php artisan db:seed --class=AreanesiaVillageSeeder       # Import data desa/kelurahan

基本用法

您可以使用以下类，就像使用模型一样。

<?php

use App\Models\Province;
use App\Models\Regency;
use App\Models\District;
use App\Models\Village;

// Get semua data
$provinces = Province::all();
$regencies = Regency::all();
$districts = District::all();
$villages = Village::all();

// Cari berdasarkan nama
$provinces = Province::where('name', 'JAWA BARAT')->first();
$regencies = Regency::where('name', 'LIKE', '%SUKABUMI%')->first();
$districts = District::where('name', 'LIKE', 'BANDUNG%')->get();
$villages = Village::where('name', 'SURADE')->first();

高级用法

<?php

// Get Kecamatan dari sebuah Provinsi.
$districts = $province->districts;

// Cek jika provinsi memiliki kabupaten terkait menggunakan logika OR bedasarkan nama kabupaten.
$province->hasDistrictName(["SELAKAU TIMUR", "PEMANGKAT", "SEMPARUK", "JAWAK"]);

// Cek jika provinsi memiliki kabupaten terkait menggunakan logika AND bedasarkan nama kabupaten.
$province->hasDistrictName(["SELAKAU TIMUR", "PEMANGKAT", "SEMPARUK", "JAWAI"], true);

// Cek jika provinsi memiliki kabupaten terkait menggunakan logika OR bedasarkan id kabupaten.
$province->hasDistrictId([6101, 6102, 6103, 6104]);

// Cek jika provinsi memiliki kabupaten terkait menggunakan logika AND bedasarkan id kabupaten.
$province->hasDistrictId([6101, 6102, 6103, 6104], true);

// Get Kabupaten/Kota dari sebuah Provinsi
$regencies = $province->regencies;

// Get Kecamatan dari sebuah Kabupaten/Kota
$districts = $regency->districts;

// Get Desa/Kelurahan dari sebuah Kabupaten/Kota
$villages = $regency->villages;

// Cek jika kabupaten memiliki desa/kelurahan terkait menggunakan logika AND bedasarkan nama desa/kelurahan.
$regency->hasVillageName(["PARIT SETIA", "PELIMPAAN", "SEMPARUK"], true);

// Cek jika kabupaten memiliki desa/kelurahan terkait menggunakan logika AND bedasarkan id desa/kelurahan.
$regency->hasVillageId([6101050014, 6101040025, 6101060023, 6101020014]);

// Get Desa/Kelurahan dari sebuah Kecamatan
$villages = $district->villages;

// Cek Desa ada di sebuah Provinsi
$village->isProvince(61);

// Cek Desa ada di sebuah Kabupaten
$village->isRegency(6102);

// Cek Desa ada di sebuah Kecamatan
$village->isDistrict(6101050);

// Cek Kecamatan ada di sebuah Provinsi
$district->isProvince(61);

// Cek Kecamatan ada di sebuah Kabupaten
$village->isRegency(6102);

// Get Kabupaten dari sebuah Desa
$village->regency;

// Get Provinsi dari sebuah Desa
$village->province;

// Get Provinsi dari sebuah Kecamatan
$district->province;

授权

Copyright (c) 2020 Aris Ripandi.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://apache.ac.cn/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

有关更多信息，请参阅授权文件。