Global Postal Codes and Radius Search

RapidAPI2026-09-04 更新2026-09-05 收录

地理编码与空间查询

邮政区域分析

数据链接：

https://rapidapi.com/payloadic/api/global-postal-codes-and-radius-search 数据链接链接失效反馈

官方服务：

资源简介：

Postal codes for 121 countries with real spatial search: radius, distance and cross-border lookup.

创建时间：

2026-09-04

原始信息汇总

数据集概览

Global Postal Codes and Radius Search 是一个全球邮政代码查询与半径搜索API，由 Payloadic 提供，所属类别为 Location。该数据集整合了全球邮政代码与城镇信息，支持跨边境的半径搜索、距离计算、反向地理编码等多种地理空间查询功能。

核心数据规模

邮政代码数量：1,828,113 个
城镇/城市数量：235,669 个
覆盖国家/地区：121 个
美国数据来源：经 USPS（美国邮政局）官方公告验证，共 43,623 条记录

主要功能特性

跨边境半径搜索：可围绕坐标或指定邮政代码设定半径（单位支持公里或英里），在不指定国家时自动跨越国境搜索，适配仓库临近边境等场景。
邮政代码与地点联合查询：查询某个邮政代码附近的城镇，返回人口、时区、行政区域等信息。
反向地理编码：由坐标获取最近城镇及距离。
地点搜索（消歧）：支持按国家及最小人口过滤，同名地点按人口降序排列。
跨国家距离计算：计算任意两国邮政代码之间的大圆距离，并返回是否跨国（crossBorder 标志）。
双向地点查询：既可由邮政代码解析其覆盖地点，也可列出某一地点下的所有邮政代码。
前缀自动补全：支持按国家或全球范围，对输入的编码前缀实时给出建议。
开发者友好返回：有效但无匹配的查询也返回 HTTP 200（found: false），非异常处理。

端点列表（RESTful，GET 方法，JSON 响应）

端点	功能描述
`/postal/v1/lookup/{country}/{postalCode}`	查询单一邮政代码及其覆盖的所有地点
`/postal/v1/radius`	搜索坐标指定半径内的所有邮政代码
`/postal/v1/nearby/{country}/{postalCode}`	搜索某邮政代码指定半径内的其他邮政代码
`/postal/v1/distance`	计算任意两国邮政代码之间的距离
`/postal/v1/by-place`	列出属于某一地点的所有邮政代码
`/postal/v1/suggest`	对邮政代码前缀进行自动补全
`/postal/v1/places/search`	按名称搜索城镇/城市，人口多者优先
`/postal/v1/places/nearest`	反向地理编码：获取最近城镇
`/postal/v1/places/radius`	搜索坐标半径内的城镇
`/postal/v1/places/near/{country}/{postalCode}`	获取某邮政代码附近的城镇
`/postal/v1/places/{geonameId}`	通过地点ID查询单一地点

订阅计划限制

计划	最大半径	单次响应最多行数
BASIC（免费）	25 km	50
PRO（$14.99/月）	100 km	250
ULTRA（$39.99/月）	500 km	1,000
MEGA（$99.99/月）	20,000 km	5,000

超出计划限制的请求会返回明确的 HTTP 400 错误，不会静默截断结果。

典型应用场景

配送区域划分与覆盖范围定义
门店定位器与结账邮编验证
跨国物流的运费计算与路线规划
销售或现场服务区域按邮编拆分
客户地址数据富化（附加坐标、地名、行政区）
表单输入自动补全以降低输入错误

技术细节

空间索引：基于 MySQL SRID 4326 点数据，使用空间索引加速查询。
延迟：通过 RapidAPI 代理通常低于 500 ms。
单位：所有距离与半径调用均支持 km 或 mi。
稳定性：有效请求一律返回 HTTP 200（含无匹配情况），可靠率为 100%（服务级别），历史延迟约 468 ms。
响应结构统一：所有端点采用一致的 JSON 结构，包含 metadata、success、found 和 data 字段，便于类型定义与校验。