1.0.1 • Published 10 months ago
@dropdowns/psgc v1.0.1
About
A list of Philippine Standard Geographic Code that can be used in form dropdown options.
The list is broken down by:
- Barangays
- Cities / Municipalities
- Provinces
- Regions
PSGC Publication Date
- Q1-2022 (Summary of Changes)
Collection Samples
Barangay
{ "name": "Bayanan", "bgy_code": "042103004", "mun_code": "042103000" }City/Municipality
{ "name": "City of Bacoor", "mun_code": "042103000", "prv_code": "042100000" }Province
{ "name": "Cavite", "prv_code": "042100000", "reg_code": "040000000" }Region
{ "name": "Region IV-A (CALABARZON)", "reg_code": "040000000" }Installation
$ npm install @dctsph/psgcUsage
Import the package in your application.
import psgc from "@dropdowns/psgc";Available Methods
| Method | Description | Example |
|---|---|---|
| getAllRegions() | Show all regions. | psgc.getAllRegions() |
| getAllProvinces() | Show all provinces. Usage:Use this if you want to start the filter by province instead of region and use the getRegionByProvince method to get the selected province's region. | psgc.getAllProvinces() |
| getBarangaysByMunicipality(mun_code) | Get all barangays by municipality. | psgc.getBarangaysByMunicipality('042103000') |
| getMunicipalitiesByProvince(prv_code) | Get all municipalities by province. | psgc.getMunicipalitiesByProvince('042100000') |
| getProvincesByRegion(reg_code) | Get all provinces by region. | psgc.getProvincesByRegion('040000000') |
| getBarangaysByProvince(prv_code) | Get all barangays by province. | psgc.getBarangaysByProvince('042100000') |
| getRegionByProvince(prv_code) | Get region by province. | psgc.getRegionByProvince('042100000') |
⚠️ Note:
- Getting the list of all barangays will not be added to avoid any performance issues due to its large number of items.
References
License
Licensed under MIT