PH-Address

A collection of philippine geographic data based on PSGC

Installing

Package manager

Using npm:

$ npm install @aivangogh/ph-address

Using yarn:

$ yarn add @aivangogh/ph-address

Using pnpm:

$ pnpm add @aivangogh/ph-address

Using bun:

$ bun add @aivangogh/ph-address

Once the package is installed, you can import the library using import or require approach:

import {
  getAllRegions,
  getAllProvinces,
  getMunicipalitiesByProvince,
  getBarangaysByMunicipality,
  getBarangaysByMunicipalityAndProvince,
} from "@aivangogh/ph-address";

| Function | Param | Description | | ------------------------------- | ------------- | ------------------------------------------------------------ | | getAllRegions() | | Returns all regions available. | | getAllProvinces() | | An array of TProvince objects sorted alphabetically by name. | | getProvincesByRegion() | code {string} | The code of the region to filter province by. | | getMunicipalitiesByProvince() | code {string} | The code of the province to filter municipalities by. | | getBarangaysByMunicipality() | code {string} | The code of the municipality to filter barangays by. |

Example

import {
  getMunicipalitiesByProvince,
  getBarangaysByMunicipality,
} from "@aivangogh/ph-address";

// All municipaliy/city in Bohol
console.log(getMunicipalitiesByProvince("071200000"));

// All barangays in the city of Cebu City
console.log(getBarangaysByMunicipality("072217000"));

Types

You can use this types as well.

import {
  type TBarangay,
  type TMunicipality,
  type TProvince,
  type TRegion
} from "@aivangogh/ph-address"

type TBarangay = {
  name: string;
  psgcCode: string;
  municipalCityCode: string;
};

type TMunicipality = {
  name: string;
  psgcCode: string;
  provinceCode: string;
};

type TProvince = {
  name: string;
  psgcCode: string;
  regionCode: string;
};

type TRegion = {
  name: string;
  psgcCode: string;
  designation: string;
};

Reference

• PSA-PSGC Publications

License

MIT