Geoapify 兼容替换
Geoapify 的地理编码端点返回带有扁平 properties 对象的 GeoJSON FeatureCollection。geoapify.mygeocode.com 返回相同的内容，包括 rank 和 datasource 信息块，另外还提供其 IP 信息端点。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | geoapify.mygeocode.com |
| 密钥参数 | apiKey（可选：任何地址不使用密钥每天也有 2,500 次请求；如需使用额度、套餐和使用记录，请在此填入您的 My Geocode 密钥） |
之前
curl "https://api.geoapify.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_GEOAPIFY_KEY"之后
curl "https://geoapify.mygeocode.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_MYGEOCODE_KEY"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 Geoapify 一致。只有背后的数据来自我们。
来自 geoapify.mygeocode.com 的响应
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"datasource": { "sourcename": "mygeocode", "attribution": "My Geocode", "license": "https://www.mygeocode.com/terms/" },
"country": "Netherlands",
"country_code": "nl",
"state": "North Holland",
"city": "Amsterdam",
"postcode": "1012 JS",
"street": "Dam",
"housenumber": "1",
"lon": 4.893604,
"lat": 52.373119,
"formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
"address_line1": "Dam 1",
"address_line2": "1012 JS Amsterdam, Netherlands",
"result_type": "building",
"rank": { "importance": 0.41, "confidence": 1, "confidence_city_level": 1, "confidence_street_level": 1, "match_type": "full_match" },
"place_id": "mg.nl.addr.c21d40e8"
},
"geometry": { "type": "Point", "coordinates": [4.893604, 52.373119] },
"bbox": [4.893004, 52.372719, 4.894204, 52.373519]
}
],
"query": {
"text": "Dam 1 Amsterdam",
"parsed": { "housenumber": "1", "street": "dam", "city": "amsterdam", "expected_type": "building" }
}
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥，请将其放在原来 Geoapify 密钥的位置：apiKey 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证（以密钥作为用户名）也适用于每个主机，因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
响应只包含 Geoapify 返回的字段，别无其他，因此可以直接用于已经在解析 Geoapify 的代码。我们的附加数据（地面海拔、威胁和网络详情）可按需获取：在查询中添加 mg_extras=1 或发送 X-MG-Extras: 1。
响应中的版权声明、许可名称、条款和隐私链接是我们的，而不是原服务商的。其他所有内容都保持原有结构。
- IP 端点返回 Geoapify 自己的对象结构。
- 批量地理编码与 Geoapify 的方式相同：使用最多包含 1,000 项的 JSON 数组调用
POST /v1/batch/geocode/search或/reverse，会返回 202 以及任务id和url，对该 url 发起 GET 请求即可获得每项一行的结果，并附带其query。每个地址计为一个请求；获取结果不计费。
如果您的客户端依赖于此处未列出的字段或行为，请告诉我们。兼容性缺口通常很小，因此会很快修复。