Global Postal Codes Zip Geocoding Matrix
收藏数据链接：
官方服务：
资源简介：
High throughput in memory indexed postal code intelligence database querying 1800000 worldwide postal and zip codes across 121 sovereign countries with sub 5ms latency.
创建时间：
2026-10-16
原始信息汇总
Global Postal Codes Zip Geocoding Matrix
基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Global Postal Codes Zip Geocoding Matrix |
| API 版本 | 1.0.0 (current) |
| 类别 | Location |
| API 创建者 | zordoon |
| 订阅者 | 1 |
| 基础调用地址 | https://global-postal-codes.p.rapidapi.com |
| 请求头 | X-RapidAPI-Key、X-RapidAPI-Host: global-postal-codes.p.rapidapi.com |
API 概览
- 高吞吐、内存索引的全球邮政编码智能数据库查询。
- 覆盖 1,826,904+ 全球邮政/邮政编码，跨 121 个主权国家，sub-5ms 延迟。
- 用于结账自动补全、运输地址验证、半径邻近搜索、多国地理编码。
- 数据源：官方国家邮政机构与 GeoNames。
- 数据库与运行时：内存内 B-Tree & R-Tree 索引 SQLite；Node.js Fastify 集群；内存映射 WAL SQLite；请求处理无外部 HTTP 依赖。
核心特性
- 1,826,904+ 索引邮政编码：覆盖美国、加拿大、英国、德国、法国、波兰、意大利、西班牙、澳大利亚、日本、巴西、印度等 121 个主权国家。
- sub-5ms 执行延迟。
- 大圆邻近查询：基于任意 GPS 坐标进行 Haversine 距离半径搜索。
- 智能格式归一化：自动处理空格、连字符、大小写，如
00-002、00002、SW1A 1AA、SW1A1AA、90210。 - 批量验证引擎：单次 sub-10ms API 调用最多验证 50 个国际地址。
端点
Endpoints 区列出的端点
| 方法 | 端点名称 |
|---|---|
| GET | searchPostalCodes |
| GET | lookupPostalCode |
| GET | getNearbyPostalCodes |
| GET | getPostalDatabaseStats |
| POST | batchLookupPostalCodes |
Complete Feature & Endpoint Matrix
| 端点 | 方法 | 描述 | 典型延迟 |
|---|---|---|---|
| https://global-postal-codes.p.rapidapi.com/v1/postal/lookup/{country}/{code} | GET | 将邮政编码解析为城市、州、县和 GPS 坐标 | < 3 ms |
| https://global-postal-codes.p.rapidapi.com/v1/postal/batch | POST | 最多 50 个邮政编码的高吞吐批量验证 | < 8 ms |
| https://global-postal-codes.p.rapidapi.com/v1/postal/nearby | GET | 围绕纬度和经度坐标的邻近半径搜索 | < 5 ms |
| https://global-postal-codes.p.rapidapi.com/v1/postal/search | GET | 按城市名或邮政编码前缀进行前缀搜索与自动补全 | < 3 ms |
| https://global-postal-codes.p.rapidapi.com/v1/postal/stats | GET | 总索引记录和国家数量的实时遥测 | < 1 ms |
调用示例要点
- 单邮编查询：GET https://global-postal-codes.p.rapidapi.com/v1/postal/lookup/US/90210，使用请求头
X-RapidAPI-Key、X-RapidAPI-Host: global-postal-codes.p.rapidapi.com。 - 批量验证：POST https://global-postal-codes.p.rapidapi.com/v1/postal/batch，请求体包含
items数组，最多 50 个。 - 邻近搜索：GET https://global-postal-codes.p.rapidapi.com/v1/postal/nearby?latitude=52.2297&longitude=21.0122&radiusKm=10&limit=5。
- 提供 cURL、Node.js Fetch、Python Requests 示例。
- 单条响应字段包含：
success、module、provider、country、code、count、data；data内包含countryCode、postalCode、placeName、stateOrRegion、stateCode、countyOrDistrict、latitude、longitude。
核心行业用例
- 电子商务结账优化：用户输入邮政编码后自动填充城市和州字段，减少购物车放弃。
- 本地配送半径与区域检查：验证客户邮政编码是否在门店本地配送范围内。
- 物流与运费计算：根据起点和终点邮政编码准确计算运输区域费率。
- 欺诈预防与地址验证（AVS）：将账单地址邮政编码与发卡银行元数据匹配。
- 房地产与门店定位：让客户按邮政编码查找最近分支机构或房产。
企业 SLA 与吞吐
- 零第三方上游依赖：整个 1.8M 数据库驻留在 Kubernetes 集群内存中。
- 确定性 sub-5ms 延迟：面向高容量企业流量设计。
- 99.99% 可用性保证。
定价
| 计划 | 价格 | 请求配额/超额 |
|---|---|---|
| Basic | $0.00 / 月 | 100 免费请求/月 |
| Pro | $19.99 / 月 | 50,000 请求/月，超额 $0.0005 |
| Ultra | $79.99 / 月 | 300,000 请求/月，超额 $0.0003 |
| Mega | $249.99 / 月 | 2,000,000 请求/月，超额 $0.0001 |
提供商信息
- API 创建者：zordoon
- 订阅者：1
- 类别：Location
