World Postal Codes

The ultimate global geolocation and address validation API. Instantly resolve 1.8M+ postal codes across 250 countries with ultra-low latency, IP-to-Postal mapping, and multi-language support. Postman collection: https://documenter.getpostman.com/view/16754454/2sBXirk91o

原始信息汇总

数据集概述：World Postal Codes API

该数据集是一个企业级、高性能的地理数据 API，提供全球邮政信息查询服务。

核心数据规模

• 记录总数：超过 1,826,595 条全球邮政记录。
• 地理覆盖：支持 250+ 个国家和地区。

主要功能特性

• 通用覆盖：提供 250 多个国家和地区的完整邮政数据。
• IP 到邮政编码映射：根据用户 IP 地址自动检测其邮政编码。
• 智能搜索：支持高级模糊匹配，可处理拼写错误并提供智能建议。
• 多语言支持：支持 25+ 种本地语言返回结果。
• 超低延迟：通过 Redis 缓存实现亚 50 毫秒响应时间。

端点分类

1. 搜索与自动补全
   • /v1/search：按城市、代码或国家进行统一搜索。
   • /v1/autocomplete：为前端城市下拉框优化的低延迟自动补全。
2. 邮政编码查询
   • /v1/lookup：查询单个邮政编码的完整元数据（坐标、州、城市）。
   • /v1/lookup/batch：批量处理最多 100 个邮政编码的查询。
3. 地理边界
   • /v1/geo/countries：获取所有支持的国家列表。
   • /v1/geo/states：获取特定国家内的州/省。
   • /v1/geo/cities：获取特定州内的城市列表。
   • /v1/country：获取特定 ISO 代码国家的深度元数据。
4. 位置智能
   • /v1/geo/nearest：根据经纬度查找最近的邮政编码。
   • /v1/geo/distance：计算两个全球邮政编码之间的直线距离。
   • /v1/geo/ip：将 IPv4/IPv6 地址解析为最近的邮政编码。
   • /health、/v1/health：健康检查端点。

应用场景

• 电子商务结账：根据邮政编码自动填写城市和州，减少购物车放弃率。
• 物流与运输：在处理订单前验证送货地址。
• 用户本地化：根据 IP 检测到的用户区域定制内容和定价。
• 欺诈检测：将用户提供的地址与其 IP 地理位置进行匹配，用于安全验证。

认证与性能

• 认证方式：通过 RapidAPI Gateway 进行，需在请求头中包含 x-rapidapi-key。
• 平均延迟：全球平均响应时间低于 100 毫秒。
• 缓存策略：大多数结果缓存 24 小时。
• 响应格式：统一的 JSON 格式。

订阅计划功能限制

功能名称	包含端点	免费版	Pro 版	Ultra 版	Mega 版
基本查询	查询、国家、国家列表、州列表、城市列表、健康检查	✅	✅	✅	✅
模糊搜索	搜索	❌	✅	✅	✅
自动补全	自动补全	❌	✅	✅	✅
地理空间逻辑	最近、距离	❌	❌	✅	✅
IP 地理定位	地理/IP	❌	❌	✅	✅
批量处理	批量查询	❌	❌	❌	✅