Zippopotam.us

简介

Zippopotam.us 把邮编解析为地名和坐标——反向亦然——覆盖约 40 个国家，只有一个免密钥的 REST 端点。是地址表单、运费计算和邮编自动补全的实用组件。

快速开始

查询美国邮编（实测可用）：

curl "https://api.zippopotam.us/us/90210"

{
  "post code": "90210",
  "country": "United States",
  "country abbreviation": "US",
  "places": [
    {
      "place name": "Beverly Hills",
      "state": "California",
      "state abbreviation": "CA",
      "latitude": "34.0901",
      "longitude": "-118.4065"
    }
  ]
}

按地名反向查询：

curl "https://api.zippopotam.us/us/CA/Beverly%20Hills"

其他国家同理：

curl "https://api.zippopotam.us/de/10115"     # 德国
curl "https://api.zippopotam.us/fr/75001"     # 法国
curl "https://api.zippopotam.us/jp/100-0001"  # 日本

认证方式

无需认证——免密钥。

速率限制与注意事项

• 免费开放；没有文档化的硬性限制——请礼貌使用。
• 国家代码遵循 ISO 3166-1 alpha-2（us、de、fr、jp……）。
• 响应包含地名、州/省、经纬度——足以做基础地理编码。
• 支持 HTTPS——请使用（列表收录的 URL 是 http）。

常见问题

Zippopotam.us 免费吗？ 是的——免费且免密钥。

支持哪些国家？ 约 40 个国家（ISO alpha-2 代码）——美国、大部分欧洲国家、日本等。

可以按地名反向查询吗？ 可以——/us/CA/Beverly Hills 返回匹配的邮编。