Repository navigation
Releases
PSGC 3Q 2026 (v1.0.1)
Philippine administrative boundaries matched to PSA's PSGC of 3Q 2026.
PSGC updates in this release
None.
Data corrections
November 2026: Manila's sub-municipalities have shapes. In Level 4 (both dist/ and
dist/complete/), Manila's 14 sub-municipalities (1380601000 Tondo I/II to 1380614000 Santa
Ana) had no shape and lengths and areas of 0. Each is now the union of its barangays, with
geom_src dissolved and its length and area measured from that union. Their barangays are
unchanged, so within Level 4 a sub-municipality overlaps its own barangays: to total an area, keep
geo_level == "Bgy". No other row changes. (#1)
Check the downloads against SHA256SUMS. See the README for the columns and the two Level 4 versions.
PSGC 3Q 2026 (v1.0.0)
Philippine administrative boundaries matched to PSA's PSGC of 3Q 2026.
PSGC updates in this release
- Third Quarter 2026 PSGC Updates: Correction of the Name of One Barangay (October 12, 2026): ✅
- Second Quarter 2026 PSGC Updates: Renaming of One Municipality and One Barangay, and Correction of 15 Geographic Names (July 13, 2026): ✅
- First Quarter 2026 PSGC Updates: Merging of Two Barangays, and Correction of the Names of One Municipality and Seven Barangays (April 13, 2026): ✅
- Fourth Quarter 2025 PSGC Updates: Correction of the Names of Three Barangays (January 13, 2026): ✅
- Third Quarter 2025 PSGC Updates: Correction of the Names of Two Barangays (October 13, 2025): ✅
- The Province of Sulu Officially Transferred to Region IX (Zamboanga Peninsula) (August 29, 2025): ✅
- Second Quarter 2025 PSGC Updates: Correction of the Names of Three Barangays (July 8, 2025): ✅
- First Quarter 2025 PSGC Updates: Correction of the Names of One Municipality and Six Barangays (April 23, 2025): ✅
- Fourth Quarter 2024 PSGC Updates: Correction of the Names of Three Barangays (January 30, 2025): ✅
- Third Quarter 2024 PSGC Updates: Creation of Two Barangays, Division of One Barangay into Six Independent Barangays, and Correction of the Names of Four Barangays (October 18, 2024): ✅
- Second Quarter 2024 PSGC Updates: Creation of the Negros Island Region and Correction of the Names of Two Barangays (July 12, 2024): ✅
- Eight New Municipalities in the Bangsamoro Autonomous Region in Muslim Mindanao (May 8, 2024): ✅
- First Quarter 2024 PSGC Updates: Three New Barangays, Transferring of One Barangay, and Correction of the Names of 20 Barangays (April 23, 2024): ✅
Data corrections
October 2026: the shapefiles moved to Releases. The zips are no longer in dist/: each PSGC
quarter is a GitHub release with
its zips, its CSVs and a SHA256SUMS, and releases/latest/download/<file> always serves the newest
quarter. Complete's Level 4 zip is PH_Adm4_BgySubMuns_complete.shp.zip there. dist/ keeps the
CSVs, and dist/README.md lists the new addresses. Nothing in the repository needs git-lfs any
more. The files' contents are unchanged.
October 2026: geom_src and dist/complete/ in Level 4. PH_Adm4_BgySubMuns gains a
geom_src column, after geo_level, saying where each shape comes from (source, dissolved,
plotted, approximated or none). A second copy of Level 4, dist/complete/, approximates the
shapes dist/ leaves out. Levels 0–3 are unchanged in columns.
October 2026: one layer per shapefile zip. Each .shp.zip now holds a single layer in
EPSG:32651 (WGS 84 / UTM zone 51N), and its attribute table matches the level's CSV row for row,
including the parent-code corrections below. If you read these files:
- One layer, renamed members. The zip holds
PH_AdmN_*.shp,.dbf,.shx,.prjand
.cpg(it wasPH_AdmN_*.shp.shpand so on). An older WGS84 lat/long layer (Regions.shp,
Provdists.shp,Municities.shp,BgySubMuns.shp) stored first in the Level 1–4 zips is gone,
and with it the PSA columns it carried (pop_2015,pop_2020,city_class,inc_class,
urb_rur,status). Join the PSGC datafile by PSGC
code for those. - Names trimmed. 80 Level 3 and 2,774 Level 4 names lost a trailing space, in the zips and the
CSVs. Codes, row counts and boundaries are unchanged. - UTF-8. Each
.cpgnow declares UTF-8 (it said ISO-8859-1), so names such as "Las Piñas" read
correctly in tools that honour it.
October 2026: parent codes in the Level 2–4 CSVs. Every parent code (adm1_psgc, adm2_psgc,
adm3_psgc) in PH_Adm2_ProvDists.csv, PH_Adm3_MuniCities.csv and PH_Adm4_BgySubMuns.csv now
exists in the level above. Row counts are unchanged. If you join on these files:
- Level 2: the BARMM interim province is now
1999900000, "Interim Province Code for 63
barangays of BARMM…" (it was1909900000, with no name). - Level 3: cities that PSA places under no province now carry their geographic province or NCR
district asadm2_psgc(e.g. City of Angeles → Pampanga305400000, Caloocan → NCR Third
District1307500000, Davao City → Davao del Sur1102400000), not their own code. - Level 4: those cities' barangays carry the same
adm2_psgc; Manila's 14 sub-municipalities
and their barangays are under the City of Manila (1380600000), not0or a sub-municipality
code; two non-barangay areas are named (Manila North Cemetery, Tutuban Mall).
Check the downloads against SHA256SUMS. See the README for the columns and the two Level 4 versions.
Raw sources
The raw source files this repo builds from (data/sources.toml lists each, with its SHA-256).
PSGC 4Q 2023 (psgc-2023-4q)
Philippine administrative boundaries matched to PSA's PSGC of 4Q 2023.
PSGC updates in this release
None.
Data corrections
October 2026: the shapefiles moved to Releases. The zips are no longer in dist/: each PSGC
quarter is a GitHub release with
its zips, its CSVs and a SHA256SUMS, and releases/latest/download/<file> always serves the newest
quarter. Complete's Level 4 zip is PH_Adm4_BgySubMuns_complete.shp.zip there. dist/ keeps the
CSVs, and dist/README.md lists the new addresses. Nothing in the repository needs git-lfs any
more. The files' contents are unchanged.
October 2026: geom_src and dist/complete/ in Level 4. PH_Adm4_BgySubMuns gains a
geom_src column, after geo_level, saying where each shape comes from (source, dissolved,
plotted, approximated or none). A second copy of Level 4, dist/complete/, approximates the
shapes dist/ leaves out. Levels 0–3 are unchanged in columns.
October 2026: one layer per shapefile zip. Each .shp.zip now holds a single layer in
EPSG:32651 (WGS 84 / UTM zone 51N), and its attribute table matches the level's CSV row for row,
including the parent-code corrections below. If you read these files:
- One layer, renamed members. The zip holds
PH_AdmN_*.shp,.dbf,.shx,.prjand
.cpg(it wasPH_AdmN_*.shp.shpand so on). An older WGS84 lat/long layer (Regions.shp,
Provdists.shp,Municities.shp,BgySubMuns.shp) stored first in the Level 1–4 zips is gone,
and with it the PSA columns it carried (pop_2015,pop_2020,city_class,inc_class,
urb_rur,status). Join the PSGC datafile by PSGC
code for those. - Names trimmed. 80 Level 3 and 2,774 Level 4 names lost a trailing space, in the zips and the
CSVs. Codes, row counts and boundaries are unchanged. - UTF-8. Each
.cpgnow declares UTF-8 (it said ISO-8859-1), so names such as "Las Piñas" read
correctly in tools that honour it.
October 2026: parent codes in the Level 2–4 CSVs. Every parent code (adm1_psgc, adm2_psgc,
adm3_psgc) in PH_Adm2_ProvDists.csv, PH_Adm3_MuniCities.csv and PH_Adm4_BgySubMuns.csv now
exists in the level above. Row counts are unchanged. If you join on these files:
- Level 2: the BARMM interim province is now
1999900000, "Interim Province Code for 63
barangays of BARMM…" (it was1909900000, with no name). - Level 3: cities that PSA places under no province now carry their geographic province or NCR
district asadm2_psgc(e.g. City of Angeles → Pampanga305400000, Caloocan → NCR Third
District1307500000, Davao City → Davao del Sur1102400000), not their own code. - Level 4: those cities' barangays carry the same
adm2_psgc; Manila's 14 sub-municipalities
and their barangays are under the City of Manila (1380600000), not0or a sub-municipality
code; two non-barangay areas are named (Manila North Cemetery, Tutuban Mall).
Check the downloads against SHA256SUMS. See the README for the columns and the two Level 4 versions.