LocationIQ 兼容替换
LocationIQ 的 search、reverse、autocomplete 和 timezone 端点都在 locationiq.mygeocode.com 上响应。包含 display_name、address 和 boundingbox 的 Nominatim 风格 JSON 数组以完全相同的结构返回。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | locationiq.mygeocode.com |
| 密钥参数 | key（可选：任何地址不使用密钥每天也有 2,500 次请求；如需使用额度、套餐和使用记录，请在此填入您的 My Geocode 密钥） |
之前
curl "https://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"之后
curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 LocationIQ 一致。只有背后的数据来自我们。
来自 locationiq.mygeocode.com 的响应
[
{
"place_id": "mg.au.poi.3b7e91c0",
"licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
"osm_type": "way",
"osm_id": 4245932,
"boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
"lat": "-33.8567844",
"lon": "151.2152967",
"display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
"class": "tourism",
"type": "attraction",
"importance": 0.8543,
"icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
"address": {
"name": "Sydney Opera House",
"road": "Bennelong Point",
"suburb": "Sydney",
"city": "Sydney",
"state": "New South Wales",
"postcode": "2000",
"country": "Australia",
"country_code": "au"
}
}
]细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥，请将其放在原来 LocationIQ 密钥的位置：key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证（以密钥作为用户名）也适用于每个主机，因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
- 时区端点已上线，返回时区名称、偏移、夏令时标记以及两种名称。
- 没有批量端点，因为原服务也没有。批量处理请使用
api.mygeocode.com上的POST /v1/forward或/v1/reverse（每次调用最多 100 条，每条计为一个请求）。
如果您的客户端依赖于此处未列出的字段或行为，请告诉我们。兼容性缺口通常很小，因此会很快修复。