地址自动补全 API

在用户输入时推荐地址、街道、城市和地点。每条建议都带有各自的坐标和精度，因此用户选中一条时，您已经拥有所需的一切。没有会话令牌，没有单独的详情调用，也没有按会话计费。

GEThttps://api.mygeocode.com/v1/autocomplete?q=...

示例

请求

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"

响应专为输入场景优化：几十毫秒内即可返回，并能容忍漏掉的字母和颠倒的词序。发送 proximity=lat,lon 可让附近的地点排在前面，这对许多城镇都有的街道名称非常重要。

将按键防抖设为约 150 毫秒。选定一个典型地址需要 4 到 6 次请求。

响应

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

返回内容

字段	含义
`text`	应当显示的建议文本，单行。
`lat`, `lon`	建议的坐标。每条建议都包含此项。
`type`	`address`、`street`、`postcode`、`city`、`region`、`country` 或 `poi`。
`precision`	与地理编码相同的四个值。
`place_id`	一个稳定的标识符。如果您想获取所选建议的完整组成部分和边界，请将其传给 `/v1/forward?place_id=...`。

使用场景

结账地址表单

一个字段代替六个。用所选建议的 place_id 获取各组成部分，填充表单的其余部分。

地图上的搜索框

将地图中心作为 proximity 传入，这样“High Street”指的就是屏幕上的那一条。

替换 Places Autocomplete

Google Maps JavaScript 兼容替换提供由此端点支持的 google.maps.places.Autocomplete，不按会话计费。

价格和限制

每次调用计为一次请求。没有按会话计费，选择建议也不单独收费。每个密钥每天有 2,500 次免费请求；超出后，每次从预付额度中扣除 €0.0001，使用 Unlimited 密钥（每月 €50）则不收费。价格。