PHPackages nguyenquang2302/vietnam-maps-clone - 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. [Database & ORM](/categories/database) 4. / 5. nguyenquang2302/vietnam-maps-clone ActiveLibrary[Database & ORM](/categories/database) nguyenquang2302/vietnam-maps-clone ================================== Vietnam's area database. 04PHP Since Sep 11Pushed 2y agoCompare [ Source](https://github.com/nguyenquang2302/vietnam-maps-clone)[ Packagist](https://packagist.org/packages/nguyenquang2302/vietnam-maps-clone)[ RSS](/packages/nguyenquang2302-vietnam-maps-clone/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Vietnam Maps ------------ [](#vietnam-maps) Database of Vietnam's area. Data are taken directly from the General Statistics Office of Vietnam. [![Latest Version on Packagist](https://camo.githubusercontent.com/7fbbc7ddc5de45e4dc6a738284926d641170ff3296512cab9afaef6792265072/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f616e677068692f766965746e616d2d6d6170732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hoangphi/vietnam-maps)[![Total Downloads](https://camo.githubusercontent.com/6f557f38f60103b51bd2dfb805c51c3ec594a787a993b3f1245380eeed9264f6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f616e677068692f766965746e616d2d6d6170732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hoangphi/vietnam-maps) Install ------- [](#install) ``` composer require hoangphi/vietnam-maps ``` Extracting ---------- [](#extracting) ### Method 1: [](#method-1) Extract directly via command: ``` php artisan vietnam-map:install ``` ### Method 2: [](#method-2) #### Copy file config và migration [](#copy-file-config-và-migration) ``` php artisan vendor:publish --provider="HoangPhi\VietnamMap\VietnamMapServiceProvider" ``` #### Customize config và migration [](#customize-config-và-migration) 1. Rename table Open file `config/vietnam-maps.php` and config: ``` 'tables' => [ 'provinces' => 'provinces', 'districts' => 'districts', 'wards' => 'wards', ], ``` 2. Rename column Open file `config/vietnam-maps.php` and config: ``` 'columns' => [ 'name' => 'name', 'gso_id' => 'gso_id', 'province_id' => 'province_id', 'district_id' => 'district_id', ], ``` 3. Add column Open the following migration files and customize if you need: ``` database/migrations/{datetime}_create_vietnam_maps_table.php ``` #### Run migration [](#run-migration) ``` php artisan migrate ``` #### Download và import into database [](#download-và-import-into-database) ``` php artisan vietnam-map:download ``` Usage with Models ----------------- [](#usage-with-models) 1. Get all provinces, districts, wards ``` use HoangPhi\VietnamMap\Models\Province; use HoangPhi\VietnamMap\Models\District; use HoangPhi\VietnamMap\Models\Ward; class DevController extends Controller { ... public function dev() { $provinces = Province::all(); $districts = District::all(); $wards = Ward::all(); ... } } ``` 2. Get data using relationship ``` use HoangPhi\VietnamMap\Models\Province; class DevController extends Controller { ... public function dev() { $province = Province::first(); $districts = $province->districts; ... } } ``` 3. Relation in Province.php ``` class Province extends Model { ... public function districts() { return $this->hasMany(District::class); } } ``` 4. Relation in District.php ``` class District extends Model { ... public function province() { return $this->belongsTo(Province::class, config('vietnam-maps.columns.province_id'), 'id'); } public function wards() { return $this->hasMany(Ward::class); } } ``` 5. Relation in Ward.php ``` class Ward extends Model { ... public function district() { return $this->belongsTo(District::class, config('vietnam-maps.columns.district_id'), 'id'); } } ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Security -------- [](#security) If you discover any security-related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Phi Hoang](https://github.com/hoangphidev) - [All Contributors](../../contributors) References ---------- [](#references) 1. [General Statistics Office of Vietnam](https://www.gso.gov.vn/dmhc2015) 2. [Vietnam Zone](https://github.com/kjmtrue/vietnam-zone) License ------- [](#license) The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). ### Health Score 14 — LowBetter than 2% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community9 Small or concentrated contributor base Maturity21 Early-stage or recently created project Bus Factor1 Top contributor holds 54.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/d3df3b54a1d48ea973e3c7324c75a7273e0c4b2b1ebebdae1b9ed81fc54d3fa9?d=identicon)[nguyenquang2302](/maintainers/nguyenquang2302) --- Top Contributors [![hoangphidev](https://avatars.githubusercontent.com/u/32218935?v=4)](https://github.com/hoangphidev "hoangphidev (6 commits)")[![nguyenquang2302](https://avatars.githubusercontent.com/u/13691088?v=4)](https://github.com/nguyenquang2302 "nguyenquang2302 (4 commits)")[![amaisphihoang](https://avatars.githubusercontent.com/u/146047625?v=4)](https://github.com/amaisphihoang "amaisphihoang (1 commits)") ### Embed Badge ![Health badge](/badges/nguyenquang2302-vietnam-maps-clone/health.svg) ``` [![Health](https://phpackages.com/badges/nguyenquang2302-vietnam-maps-clone/health.svg)](https://phpackages.com/packages/nguyenquang2302-vietnam-maps-clone) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)