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

ConceptMap Evolution

PSGC codes change between quarterly releases. A conformant server SHALL compute and expose evolution mappings as ConceptMap resources, queryable via $translate.

Mapping Types

Compare Release A to Release Bcode exists in both?yesnoDIRECT (equivalent)Match by area name0name matches found?ABOLISHED (unmatched)1exactly 1 match?>1 matchesRENUMBERED (equivalent)SPLIT (narrower)


Mapping Type FHIR Equivalence Meaning
DIRECT equal Code unchanged between releases
RENUMBERED equivalent Same area, different code
SPLIT narrower Old code divided into multiple new codes
MERGED wider Multiple old codes combined into one
ABOLISHED unmatched Code no longer exists, no replacement

Example: $translate

GET /fhir/ConceptMap/$translate?code=1500000000&source=Q2_2021&target=Q3_2022

{
  "resourceType": "Parameters",
  "parameter": [
    {"name": "result", "valueBoolean": true},
    {"name": "match", "part": [
      {"name": "equivalence", "valueCode": "narrower"},
      {"name": "concept", "valueCoding": {
        "system": "https://psa.gov.ph/classification/psgc",
        "code": "1500100000",
        "display": "Maguindanao del Norte"
      }}
    ]},
    {"name": "match", "part": [
      {"name": "equivalence", "valueCode": "narrower"},
      {"name": "concept", "valueCoding": {
        "system": "https://psa.gov.ph/classification/psgc",
        "code": "1500200000",
        "display": "Maguindanao del Sur"
      }}
    ]}
  ]
}

Real-World Evolution Events

Event Quarter What happened
Maguindanao split Q3 2022 Divided into del Norte and del Sur
NIR abolished Q3 2017 Negros Island Region dissolved
NIR restored Q1 2025 Re-established via RA 12000
Davao de Oro Q4 2019 Compostela Valley renamed