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

📥 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 | [email protected] |

🚀 Usage

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

📜 License

MIT © jobuntux