逆地理编码 API

发送一个纬度和经度，即可获得最近的地址，其中街道、城市、地区、邮政编码和国家分别列出，另外还会告诉您该地址与您所发送坐标点的距离。如果您只需要城市或国家，可以使用 level 请求更粗略的结果。

GEThttps://api.mygeocode.com/v1/reverse?lat=...&lon=...

示例

请求

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"

该坐标点距埃菲尔铁塔底部几米远。响应返回最近的邮政地址，distance_m 告诉您它在 12 米之外。如果最近的地址在 400 米之外，比如坐标点位于公园中，您同样会看到这个距离，并可以决定改为显示所在街区。

添加 level=city 可跳过地址直接获取所在地区，或添加 level=country 进行快速的国家查询。

响应

{
  "status": "ok",
  "lat": 48.8584,
  "lon": 2.2945,
  "result": {
    "formatted": "5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.85837,
    "lon": 2.29448,
    "distance_m": 12,
    "type": "address",
    "precision": "house",
    "components": {
      "house_number": "5",
      "road": "Avenue Anatole France",
      "suburb": "7th Arrondissement",
      "city": "Paris",
      "state": "Ile-de-France",
      "postcode": "75007",
      "country": "France",
      "country_code": "fr"
    }
  }
}

返回内容

字段	含义
`result.formatted`	最近的地址，采用该国的地址格式。
`result.lat`, `result.lon`	地址本身的位置，而不是您发送的坐标点。
`result.distance_m`	您的坐标点与该地址之间的距离（米）。数值很大说明您实际上并不在某个地址处。
`result.precision`	`house`、`street`、`postcode` 或 `admin`，取决于该国在该坐标点附近有哪些数据。
`result.components`	地址各组成部分，键名与正向地理编码相同。
`result` 为 `null`	该坐标点 5 公里范围内没有任何结果。例如公海、南极洲。状态仍为 `ok`。

使用场景

为 GPS 坐标点添加标签

将设备位置转换为“Avenue Anatole France 5 号附近”，用于日志、收据或照片说明。使用 distance_m 在“位于”和“附近”之间切换。

本地默认设置

使用 level=country 根据访客位置预先填写国家、货币或语言。没有坐标时，可搭配 IP 查询使用。

配送与外勤工作

将司机实际停车的位置转换为地址，并与订单上的目的地进行比较。

价格和限制

一次调用计为一个请求。每个密钥每天有 2,500 次免费请求；超出后，每次请求从预付额度中扣除 €0.0001，使用 Unlimited 密钥（每月 €50）则不收费。价格。兼容替换主机会以 Google、Nominatim、Mapbox 和其他格式响应逆地理编码请求。