My Geocode

试用 API

选择一个端点，修改参数值，点击发送。请求会从您的浏览器发送到 api.mygeocode.com，JSON 响应会在新标签页中打开。它会计入您的地址在不使用密钥时每天可获得的 2,500 次免费请求；粘贴密钥则改为计入该密钥。想要一个密钥？使用电子邮件地址注册，一分钟即可获得。

GET /v1/forward（正向地理编码）

1 到 10，默认 5

以逗号分隔的 ISO 3166-1 alpha-2 代码

所示参数值的示例响应

{
  "status": "ok",
  "query": "221B Baker Street, London",
  "results": [
    {
      "formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
      "lat": 51.523767,
      "lon": -0.158555,
      "type": "address",
      "precision": "house",
      "confidence": 0.97,
      "place_id": "gb.addr.7f3c2a19",
      "components": {
        "house_number": "221B",
        "road": "Baker Street",
        "neighbourhood": "Marylebone",
        "city": "London",
        "state": "England",
        "postcode": "NW1 6XE",
        "country": "United Kingdom",
        "country_code": "gb"
      },
      "bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
    }
  ]
}

试着去掉门牌号，观察 precision 从 house 变为 street。参考文档

GET /v1/reverse（逆地理编码）

address、street、postcode、city、region 或 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"
    }
  }
}

试试 0 和 0：您会得到 "result": null 以及 status: ok，因为海洋中的一个点也是一个有效的查询。参考

GET /v1/autocomplete 端点

至少 2 个字符

所示参数值的示例响应

{
  "status": "ok",
  "query": "10 Downing",
  "suggestions": [
    { "text": "10 Downing Street, London SW1A 2AA, United Kingdom", "lat": 51.503396, "lon": -0.12764, "type": "address", "precision": "house", "place_id": "gb.addr.7f3c2a19" },
    { "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom", "lat": 52.203042, "lon": 0.121811, "type": "address", "precision": "house", "place_id": "gb.addr.a01d9e44" },
    { "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom", "lat": 51.536118, "lon": 0.137204, "type": "address", "precision": "house", "place_id": "gb.addr.c58b7e02" }
  ]
}

每条建议都带有坐标，因此选中一条后无需再发起第二次调用。参考

GET /v1/ipv4 端点

清空即可查询您自己的地址

所示参数值的示例响应

{
  "status": "ok",
  "ip": "8.8.8.8",
  "version": 4,
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

参考

GET /v1/ipv6 端点

清空即可查询您自己的地址

所示参数值的示例响应

{
  "status": "ok",
  "ip": "2001:4860:4860::8888",
  "version": 6,
  "prefix": "2001:4860::/32",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "postcode": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "is_private": false
}

参考

GET /v1/timezone 端点

所示参数值的示例响应

{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "dst": false,
  "timestamp": 1756335245,
  "local_time": "2026-08-28T08:34:05+09:00",
  "country_code": "JP",
  "next_transition": null
}

参考

GET /v1/elevation 端点

所示参数值的示例响应

{
  "status": "ok",
  "results": [
    { "lat": 27.9881, "lon": 86.925, "elevation_m": 8752.1, "resolution_m": 30 }
  ]
}

如需一次查询多个点，请改用 locations=lat,lon|lat,lon。参考

GET /v1/postcode 端点

ISO 3166-1 alpha-2。强烈建议填写

所示参数值的示例响应

{
  "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
    }
  ]
}

参考

解读响应。每个响应都有一个 status 字段。地理编码结果带有 precision，取值为 house、street、postcode 或 admin，让您知道该坐标点的可信程度。响应头包含 X-Quota-Used 和 X-Quota-Reset，您可以在浏览器的开发者工具中查看。留空的可选字段不会包含在请求中。由于表单无法设置请求头，这里您的密钥以 key 参数发送；在代码中请使用 X-API-Key 请求头。所有字段请参阅文档。