Geocodio 兼容替换
Geocodio 专注于美国和加拿大。geocodio.mygeocode.com 以相同的结构响应其 geocode 和 reverse 端点,并接受全球任何地方的地址。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | 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 一致。只有背后的数据来自我们。
来自 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 的错误整体拒绝,而不是部分处理。
如果您的客户端依赖于此处未列出的字段或行为,请告诉我们。兼容性缺口通常很小,因此会很快修复。