Package Exports

@jobuntux/psgc
@jobuntux/psgc/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@jobuntux/psgc) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

PSGC (Philippine Standard Geographic Code)

A TypeScript-ready NPM package providing up-to-date Philippine Standard Geographic Code (PSGC) data, including Regions, Provinces, Municipalities/Cities, and Barangays, based on the official releases of the Philippine Statistics Authority (PSA).

✨ Features

📦 Pre-packaged JSON data (no database setup required).
🔍 Strongly typed with TypeScript.
🗂️ Easy utilities to query regions, provinces, municipalities/cities, and barangays.
🔄 Updated quarterly in sync with PSA’s official releases.
🚀 Ready for both Node.js (backend) and modern frontend frameworks.

🗂 PSGC Code Structure

The PSA defines PSGC codes using a 10-digit format:

RR PPP MM BBB

RR → Region code
PPP → Provincial code / Highly Urbanized City (HUC) / Independent Component City (ICC) / Component City (CC)
MM → Municipality/City code
BBB → Barangay code

Derived identifiers:

PPPMM → Municipality/City identifier
PPPMMBBB → Barangay identifier

📌 Example:

0434040000 → Calamba City
0434040057 → Barangay Milagrosa (Tulo), Calamba City

pgsc-new-coding-structure

📥 Installation

npm install @jobuntux/psgc
# or
yarn add @jobuntux/psgc
# or
pnpm add @jobuntux/psgc

📊 Data Counts (2025-2Q)

The dataset includes:

18 Regions
83 Provinces (including NCR as pseudo-province)
1,656 Municipalities & Cities (149 Cities, 1,493 Municipalities, 14 Sub-Municipalities)
42,011 Barangays

📅 Latest Official PSGC Update

Field	Details
Title	Philippine Standard Geographic Code (PSGC)
Originator	Philippine Statistics Authority (PSA)
Publication Date	30 June 2025
Abstract	The PSGC is a systematic classification and coding of geographic areas in the country based on the four hierarchical levels: region, province, city/municipality, and barangay.
Process	Updated based on official changes in the administrative structure of the country through Republic Acts and local ordinances ratified via plebiscites conducted by the COMELEC.
Progress	Ongoing (updated quarterly)
Access Constraints	None
Use Constraints	Acknowledgement of the Philippine Statistics Authority (PSA) as the source
Disclaimer	- Distributed without warranty of any kind, expressed or implied. - Responsibility for interpretation and use lies with the user. - PSA is not liable for damages arising from its use.
Primary Contact	Statistical Classifications Division (SCD), Standards Service
Contact Persons	Emerson M. Aquino / Von Jeric F. Adona / Emmanuel V. Prades
Organization	Philippine Statistics Authority (PSA)
Telephone	(+632) 8376-1867
Fax	None
Email	scd.staff@psa.gov.ph

Source: https://psa.gov.ph/classification/psgc/

🚀 Usage

Refer to https://jobuntux.github.io/psgc/

@jobuntux/psgc