邮政编码查询 API

将邮政编码转换为其所属的地点：城镇或城市、地区、国家以及一个坐标。覆盖美国 ZIP 邮编、英国邮政编码、加拿大邮政编码、印度 PIN 码、日本郵便番号，以及 160 个国家的同类编码。它本身就适用于地址表单，在只有邮政编码时，也是一种快速、低成本的记录定位方式。

GEThttps://api.mygeocode.com/v1/postcode?code=...&country=...

在演示中试用完整参考

示例

请求

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=10001&country=us"

# UK postcodes resolve to a street or a handful of buildings
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=SW1A+1AA&country=gb"

只要知道国家，请始终发送 country。邮政编码在各国之间并不唯一：10001 既在纽约，也在其他好几个国家。如果不指定国家，您会得到该编码存在的所有国家的结果，按人口从多到少排列。

格式要求很宽松。空格、连字符和大小写都会被规范化，因此 sw1a1aa 和 SW1A 1AA 是相同的。

响应

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

返回内容

字段	含义
`results`	该编码覆盖的每个地点对应一个条目。大多数编码对应一个地点；一些农村编码覆盖多个村庄，会返回多个条目。
`place`	邮政机构所使用的城镇、城市或地区名称。
`region`, `region_code`	州、省或郡，以及其 ISO 3166-2 代码（如有）。
`lat`, `lon`	如邮政机构公布了该编码的坐标点则使用该点，否则使用我们所掌握该编码下各地址的中心点。

使用场景

地址表单

先询问邮政编码，再自动填写城市和地区。用户输入更少，出错也更少。

配送区域与定价

根据邮政编码的坐标，确定由哪个仓库为客户服务，或适用哪个运费档位。

调查数据制图

只记录了邮政编码的数据集可以按邮政编码精度绘制到地图上，而这通常也正是隐私要求所允许的最高精度。

价格和限制

一次调用计为一个请求，无论该编码覆盖多少个地点。每个密钥每天有 2,500 次免费请求；超出后，每次请求从预付额度中扣除 €0.0001，使用 Unlimited 密钥（每月 €50）则不收费。价格。如需包含门牌号的完整地址，请改用正向地理编码。