PSGC Terminology FHIR Implementation Guide
0.1.0 - ci-build Philippines flag

PSGC Terminology FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

PSGC Terminology Server Capability Statement

Defines what a conformant PSGC-capable FHIR terminology server SHALL and SHOULD support.

Behavior: Operation Definitions

These are custom operations that can be supported by and/or invoked by systems conforming to this implementation guide.

Expand PSGC (full-text search)

Search PSGC area names using full-text matching. Returns a ValueSet expansion.

Geographic Hierarchy

Resolve the full geographic ancestry path for a PSGC code — from region down to the code's own level.

Geographic Lookup

Find PSGC codes by parent code prefix and/or geographic level. Exploits the positional encoding of the 10-digit PSGC code.

Resolve PSGC from Coordinates

Reverse geocoding: resolve latitude/longitude to the PSGC code hierarchy via point-in-polygon spatial query.

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

PSGC Publication Entry

A single row in the PSA PSGC Publication Datafile. Two XLSX layouts exist (modern Q1 2022+ and legacy pre-2022). Legacy 9-digit codes are normalised to 10 digits by appending a trailing zero.

PSGC Quarterly Release

A quarterly snapshot of the full PSGC dataset as published by PSA. Each release is authoritative from its effective date until superseded. Version identifier pattern: Q{1-4}_{year} (e.g. Q1_2026).

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

All PSGC Codes

All codes in the Philippine Standard Geographic Code (all levels)

PSGC Barangays

All barangays in the Philippine Standard Geographic Code

PSGC Cities

All cities in the Philippine Standard Geographic Code

PSGC City Classification

Legal classification of Philippine cities

PSGC Entry Status

Administrative designation of a PSGC entry

PSGC Geographic Level

Geographic classification levels used in the Philippine Standard Geographic Code

PSGC Income Classification

DOF income classification of LGUs based on average annual income

PSGC Provinces

All provinces and districts in the Philippine Standard Geographic Code

PSGC Publication Format
PSGC Regions

All regions in the Philippine Standard Geographic Code

PSGC Urban/Rural Classification

Based on Census of Population and Housing

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

PSGC City Classification Codes
PSGC Entry Status Codes
PSGC Geographic Level CodeSystem

Codes for the geographic classification tiers in PSGC

PSGC Income Classification Codes

Per DOF Department Order (latest: DO No. 074.2024)

PSGC Publication Format Codes
PSGC Urban/Rural Codes
Philippine Standard Geographic Code

The official geographic classification of all areas in the Philippines, published quarterly by the Philippine Statistics Authority (PSA).