OpenCage 兼容替换
OpenCage 使用同一个端点处理正向和逆地理编码，并返回内容丰富的 annotations 信息块。opencage.mygeocode.com 也是如此，包括 OpenCage 用户读取的时区、货币、国际电话区号以及 what3words 风格的注释。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | opencage.mygeocode.com |
| 密钥参数 | key（可选：任何地址不使用密钥每天也有 2,500 次请求；如需使用额度、套餐和使用记录，请在此填入您的 My Geocode 密钥） |
之前
curl "https://api.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"之后
curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 OpenCage 一致。只有背后的数据来自我们。
来自 opencage.mygeocode.com 的响应
{
"documentation": "https://www.mygeocode.com/compatibility/opencage/",
"licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
"rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
"results": [
{
"annotations": {
"DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
"callingcode": 39,
"currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
"flag": "🇮🇹",
"timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
},
"bounds": {
"northeast": { "lat": 41.8905, "lng": 12.4932 },
"southwest": { "lat": 41.8897, "lng": 12.4914 }
},
"components": {
"ISO_3166-1_alpha-2": "IT",
"ISO_3166-1_alpha-3": "ITA",
"_category": "travel/tourism",
"_type": "attraction",
"attraction": "Colosseo",
"city": "Roma",
"continent": "Europe",
"country": "Italia",
"country_code": "it",
"postcode": "00184",
"road": "Piazza del Colosseo",
"state": "Lazio"
},
"confidence": 9,
"formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
"geometry": { "lat": 41.8902, "lng": 12.4922 }
}
],
"status": { "code": 200, "message": "OK" },
"total_results": 1
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥，请将其放在原来 OpenCage 密钥的位置：key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证（以密钥作为用户名）也适用于每个主机，因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
响应中的版权声明、许可名称、条款和隐私链接是我们的，而不是原服务商的。其他所有内容都保持原有结构。
rate信息块报告您真实的免费配额、剩余量以及重置时间。json和geojson端点均受支持。- 没有批量端点，因为原服务也没有。批量处理请使用
api.mygeocode.com上的POST /v1/forward或/v1/reverse（每次调用最多 100 条，每条计为一个请求）。
如果您的客户端依赖于此处未列出的字段或行为，请告诉我们。兼容性缺口通常很小，因此会很快修复。