Foursquare

简介

Foursquare Places API 提供 POI 数据——场所、地理编码、按位置/分类搜索和地点详情。认证是 API 密钥（Foursquare 的 “API key” 就是简单的 bearer token，尽管标签是 OAuth——无密钥请求返回 401，已实测）。

快速开始

地点搜索（替换 YOUR_KEY）：

curl "https://api.foursquare.com/v3/places/search?ll=40.7,-74&radius=1000&limit=5" \
  -H "Authorization: YOUR_KEY"

{
  "results": [
    { "fsq_id": "4b8f...", "name": "Starbucks", "categories": [{ "name": "Coffee Shop" }], "geocodes": { "main": { "latitude": 40.7, "longitude": -74 } } }
  ]
}

地点详情：

curl "https://api.foursquare.com/v3/places/4b8f..." \
  -H "Authorization: YOUR_KEY"

附近（无坐标——按 IP）：

curl "https://api.foursquare.com/v3/places/nearby?limit=5" \
  -H "Authorization: YOUR_KEY"

认证方式

• 在 developer.foursquare.com 注册 → 创建应用 → API 密钥。
• 通过 Authorization 请求头携带（缺失 → 401，已实测）。
• Places API 对这些端点用简单 API 密钥（不是完整 OAuth 流程）。

速率限制与注意事项

• 免费层：请求额度宽松（见文档——按应用分层）；付费可扩展。
• v3 Places API 取代了旧的 v2 Foursquare API。
• 按 ll（经纬度）、near（文本）、categories 或 query 搜索。
• fsq_id 是稳定的地点标识符。

常见问题

Foursquare API 免费吗？ 免费层带请求额度；更多需要付费。

如何获取密钥？ developer.foursquare.com → 创建应用 → API 密钥。

认证风格是什么？ Authorization 头里的简单 bearer API 密钥（已实测）。