Geocodio 兼容替换

Geocodio 专注于美国和加拿大。geocodio.mygeocode.com 以相同的结构响应其 geocode 和 reverse 端点,并接受全球任何地方的地址。

只需更换一个主机名

原始主机
  • api.geocod.io
改用geocodio.mygeocode.com
密钥参数api_key(可选:任何地址不使用密钥每天也有 2,500 次请求;如需使用额度、套餐和使用记录,请在此填入您的 My Geocode 密钥)
之前
curl "https://api.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"
之后
curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"

为什么用户选择迁移

相同的接口,覆盖全球,也无需关注按查询计费的价格档位。

无论是否使用密钥,免费配额都相同。发往 geocodio.mygeocode.com 的请求,与您的地址或密钥在我们自有端点上获得的每天 2,500 次免费请求合并计算。超出后,使用预付额度按每次请求 €0.0001 计费,或使用 Unlimited 密钥每月 €50。注册只需一个电子邮件地址,别无其他。

查看价格 免费获取密钥

端点

geocodio.mygeocode.com 上的路径功能底层服务
/v1.7/geocode?q=...正向地理编码正向地理编码
/v1.7/reverse?q=lat,lng逆地理编码逆地理编码
/v1.7/geocode (POST, JSON array)批量正向地理编码正向地理编码

响应示例

这是上述请求返回的内容。字段名、嵌套和类型与 Geocodio 一致。只有背后的数据来自我们。

来自 geocodio.mygeocode.com 的响应
{
  "input": {
    "address_components": {
      "number": "1109",
      "predirectional": "N",
      "street": "Highland",
      "suffix": "St",
      "formatted_street": "N Highland St",
      "city": "Arlington",
      "state": "VA",
      "country": "US"
    },
    "formatted_address": "1109 N Highland St, Arlington, VA"
  },
  "results": [
    {
      "address_components": {
        "number": "1109",
        "predirectional": "N",
        "street": "Highland",
        "suffix": "St",
        "formatted_street": "N Highland St",
        "city": "Arlington",
        "county": "Arlington County",
        "state": "VA",
        "zip": "22201",
        "country": "US"
      },
      "formatted_address": "1109 N Highland St, Arlington, VA 22201",
      "location": { "lat": 38.886665, "lng": -77.094733 },
      "accuracy": 1,
      "accuracy_type": "rooftop",
      "source": "My Geocode"
    }
  ]
}

细节与差异

每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥,请将其放在原来 Geocodio 密钥的位置:api_key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证(以密钥作为用户名)也适用于每个主机,因此以自有方式进行认证的客户端库无需任何修改即可继续工作。

  • 支持批量请求:POST 一个 JSON 列表或对象。返回的 results 中每个输入对应一个条目,每个条目都带有其来源 query(如果您 POST 的是对象,则为对象的键)以及各自的 response
  • 逆向批量请求采用相同的结构,以 lat,lon 字符串作为输入。
  • 与 Geocodio 一样,一个批量请求最多包含 10,000 个条目,并且与 Geocodio 的计数方式一样,每个条目计为一次查询。如果批量请求超过当天剩余的配额,将以 Geocodio 的错误整体拒绝,而不是部分处理。

如果您的客户端依赖于此处未列出的字段或行为,请告诉我们。兼容性缺口通常很小,因此会很快修复。

其他兼容替换主机

兼容替换的工作原理概览以及 JavaScript 库兼容替换