Philippine Location Lookup API

Look up Philippine regions, provinces, cities, municipalities, and barangays using official PSGC (Philippine Standard Geographic Code) data. Features include cascading dropdown support, fuzzy search, ZIP code lookup, reverse ZIP, batch PSGC resolution, address hierarchy validation, island group filtering, and aggregate statistics. Ideal for building address forms, logistics systems, HR platforms, and any app serving Philippine users.

原始信息汇总

数据集概述

数据集名称： Philippine Location Lookup API

数据集来源： 基于菲律宾官方标准地理代码（PSGC）数据。

覆盖范围：

• 18 个大区
• 82 个省
• 150 个市
• 1,493 个镇
• 42,010 个描笼涯（Barangay）

核心功能： 该API提供程序化访问菲律宾地理编码数据，支持多种查询和检索方式，包括：

• 查找（Lookup）操作：

  • 按 ZIP 码查询描笼涯（GET /v1/lookup/zip）
  • 按名称查询描笼涯（GET /v1/lookup/barangay）
  • 按 PSGC ID 查询层级结构（GET /v1/lookup/psgc/{id}）
  • 级联下拉菜单支持（GET /v1/lookup/cascade）
  • 反向 ZIP 码查询（GET /v1/lookup/zip/{psgc_id}）
  • 地址层级验证（GET /v1/lookup/validate）

• 搜索（Search）操作：

  • 模糊搜索所有地点类型（GET /v1/search）

• 区域数据查询（Endpoints）:

  • 获得所有大区列表及详情（GET /v1/regions, GET /v1/regions/{id}）
  • 获得所有省份列表及详情（GET /v1/provinces, GET /v1/provinces/{id}）
  • 获得所有市镇列表及详情（GET /v1/cities-municipalities, GET /v1/cities-municipalities/{id}）
  • 获得所有描笼涯列表及详情（GET /v1/barangays, GET /v1/barangays/{id}）
  • 岛群查询（GET /v1/island-groups, GET /v1/island-groups/{group}/regions）

• 统计（Statistics）操作：

  • 聚合统计不同层级的地点数量（GET /v1/stats, GET /v1/stats/{level}/{id}）

• 批量（Batch）操作：

  • 批量解析 PSGC ID（POST /v1/batch/lookup）

数据格式： 使用菲律宾标准地理代码（PSGC）作为地点标识符。在ZIP码查询中，返回的PSGC ID为9位格式；在其他查询中，PSGC ID为10位标准格式。

认证方式： 通过 RapidAPI 市场使用 x-rapidapi-proxy-secret 头部进行验证。自托管时通过环境变量 PH_LOCATION_RAPIDAPI_PROXY_SECRET 配置。

基础URL：

• RapidAPI: https://ph-location-lookup.p.rapidapi.com
• 本地开发: http://localhost:8000

适用场景：

• 地址验证（物流、配送）
• 电商结账表单的级联地址选择框
• 政府及人口统计应用
• 基于 ZIP 码的位置查找
• PSGC 层级结构的数据完整性校验