HERE Geocoding and Search 兼容替换
HERE 将其搜索 API 分布在多个主机上。所有这些主机都合并为 here.mygeocode.com，它以 HERE 客户端读取的相同 items 数组、address 对象和 position 对象进行响应。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | here.mygeocode.com |
| 密钥参数 | apiKey（可选：任何地址不使用密钥每天也有 2,500 次请求；如需使用额度、套餐和使用记录，请在此填入您的 My Geocode 密钥） |
之前
curl "https://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"之后
curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 HERE 一致。只有背后的数据来自我们。
来自 here.mygeocode.com 的响应
{
"items": [
{
"title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
"id": "mg.de.addr.9a3f1c77",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
"countryCode": "DEU",
"countryName": "Deutschland",
"stateCode": "BE",
"state": "Berlin",
"countyCode": "B",
"county": "Berlin",
"city": "Berlin",
"district": "Mitte",
"street": "Invalidenstraße",
"postalCode": "10115",
"houseNumber": "116"
},
"position": { "lat": 52.53041, "lng": 13.38527 },
"access": [ { "lat": 52.53039, "lng": 13.38533 } ],
"mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
"scoring": {
"queryScore": 1.0,
"fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
}
}
]
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥，请将其放在原来 HERE 密钥的位置：apiKey 查询参数（也接受 apikey），或 Bearer 令牌。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证（以密钥作为用户名）也适用于每个主机，因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
- 错误使用 HERE 的 title、status、code、cause 和 action 字段，并附带 correlation id。
- 没有批量端点，因为原服务也没有。批量处理请使用
api.mygeocode.com上的POST /v1/forward或/v1/reverse（每次调用最多 100 条，每条计为一个请求）。
如果您的客户端依赖于此处未列出的字段或行为，请告诉我们。兼容性缺口通常很小，因此会很快修复。