PositionStack 兼容替换

PositionStack 的正向和逆向端点都在 positionstack.mygeocode.com 上响应,data 数组和扁平字段名完全相同。在这里所有套餐(包括免费套餐)都支持 HTTPS。

只需更换一个主机名

原始主机
  • api.positionstack.com
改用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 的免费套餐仅支持 HTTP,并有月度上限。在这里全部使用 HTTPS,每个密钥的免费配额每天重置。

无论是否使用密钥,免费配额都相同。发往 positionstack.mygeocode.com 的请求,与您的地址或密钥在我们自有端点上获得的每天 2,500 次免费请求合并计算。超出后,使用预付额度按每次请求 €0.0001 计费,或使用 Unlimited 密钥每月 €50。注册只需一个电子邮件地址,别无其他。

查看价格 免费获取密钥

端点

positionstack.mygeocode.com 上的路径功能底层服务
/v1/forward?query=...正向地理编码正向地理编码
/v1/reverse?query=lat,lng逆地理编码逆地理编码

响应示例

这是上述请求返回的内容。字段名、嵌套和类型与 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 条,每条计为一个请求)。

如果您的客户端依赖于此处未列出的字段或行为,请告诉我们。兼容性缺口通常很小,因此会很快修复。

其他兼容替换主机

兼容替换的工作原理概览以及 JavaScript 库兼容替换