PositionStack 兼容替换
PositionStack 的正向和逆向端点都在 positionstack.mygeocode.com 上响应,data 数组和扁平字段名完全相同。在这里所有套餐(包括免费套餐)都支持 HTTPS。
只需更换一个主机名
| 原始主机 |
|
|---|---|
| 改用 | positionstack.mygeocode.com |
| 密钥参数 | access_key(可选:任何地址不使用密钥每天也有 2,500 次请求;如需使用额度、套餐和使用记录,请在此填入您的 My Geocode 密钥) |
之前
curl "http://api.positionstack.com/v1/forward?access_key=YOUR_POSITIONSTACK_KEY&query=350+5th+Avenue+New+York"之后
curl "https://positionstack.mygeocode.com/v1/forward?access_key=YOUR_MYGEOCODE_KEY&query=350+5th+Avenue+New+York"端点
响应示例
这是上述请求返回的内容。字段名、嵌套和类型与 PositionStack 一致。只有背后的数据来自我们。
来自 positionstack.mygeocode.com 的响应
{
"data": [
{
"latitude": 40.748428,
"longitude": -73.985654,
"type": "address",
"name": "350 5th Avenue",
"number": "350",
"postal_code": "10118",
"street": "5th Avenue",
"confidence": 1,
"region": "New York",
"region_code": "NY",
"county": "New York County",
"locality": "New York",
"administrative_area": null,
"neighbourhood": "Midtown",
"country": "United States",
"country_code": "USA",
"continent": "North America",
"label": "350 5th Avenue, New York, NY, USA"
}
]
}细节与差异
每天前 2,500 次请求无需密钥。如需使用 My Geocode 密钥,请将其放在原来 positionstack 密钥的位置:access_key 查询参数。X-API-Key 请求头、Authorization: Bearer 和 HTTP Basic 认证(以密钥作为用户名)也适用于每个主机,因此以自有方式进行认证的客户端库无需任何修改即可继续工作。
- 正向和逆向都以
data数组结构响应。 - 没有批量端点,因为原服务也没有。批量处理请使用
api.mygeocode.com上的POST /v1/forward或/v1/reverse(每次调用最多 100 条,每条计为一个请求)。
如果您的客户端依赖于此处未列出的字段或行为,请告诉我们。兼容性缺口通常很小,因此会很快修复。