Nearby Places Finder API

Find nearby places, businesses, and points of interest by location and radius.

原始信息汇总

Nearby Places Finder API 数据集概述

基本信息

• API名称：Nearby Places Finder API
• 提供商：alreadycoded
• 类别：Location
• 当前版本：v1
• API主页：https://www.alreadycoded.com
• 提供商联系邮箱：[e-mail]

功能描述

Nearby Places Finder API 允许开发者基于任意地点名称和半径搜索附近的地点、企业和兴趣点（POI）。该API将人类可读的位置转换为地理坐标，并获取附近的地点，如餐厅、咖啡馆、医院、酒店、银行、学校、药店等。

主要特性

• 📍 基于位置的附近搜索（城市、地址、地标）
• 📏 基于半径的过滤（100米 – 10公里）
• 🏪 支持数千个地点类别
• 🌍 全球覆盖
• 🧩 通过GET、POST或原始JSON主体进行JSON输入

技术详情

认证方式

使用 X-RapidAPI-Host 和 X-RapidAPI-Key 请求头进行认证。

输入参数

• location（必需）：地点名称、地址、城市或地标，用于搜索附近地点。示例：New York Times Square
• type（可选）：要搜索的地点类型（OpenStreetMap便利设施标签）。默认值：restaurant。示例值：restaurant, cafe, hospital, hotel, pharmacy, bank, school, atm, parking, fuel, supermarket, mosque, police, library, gym
• radius（可选）：搜索半径（米）。范围：100 – 10000。默认值：2000

响应结构示例

json { "success": true, "search": { "location": "Times Square, Manhattan, New York, USA", "latitude": "40.7580", "longitude": "-73.9855", "radius_meters": 2000, "place_type": "restaurant" }, "total_results": 2, "places": [ { "name": "Joes Pizza", "type": "restaurant", "latitude": 40.7589, "longitude": -73.9841, "address": "Broadway", "phone": "[phone]", "website": "https://joespizza.com" } ] }

速率限制

• 所有免费计划（如BASIC）限制为 每小时1000次请求。
• API响应包含以下速率限制头：
  • x-ratelimit-requests-limit：订阅允许的请求总数。
  • x-ratelimit-requests-remaining：达到配额限制前的剩余请求数。
  • x-ratelimit-requests-reset：配额重置前的秒数。
• 超出速率限制时，API返回 429 Too Many Requests 错误。

常见HTTP状态码

• 400 Bad Request：参数缺失或无效
• 403 Forbidden：API密钥无效或没有有效订阅
• 404 Not Found：端点无效
• 429 Too Many Requests：超出速率限制
• 5XX Server Error：临时服务器端问题

订阅计划与定价

• BASIC：$0.00 / 月
• PRO：$10.00 / 月
• ULTRA：$30.00 / 月
• MEGA：$50.00 / 月

性能指标

• 流行度：8.9
• 服务等级：100%
• 延迟：18784ms
• 测试通过率：100%

支持与资源

• 代码示例（JavaScript, Python, Java, Shell等）可在 Endpoints 选项卡的 Code Snippets 部分获取。
• 如需支持，请联系提供商并提供错误代码、消息和请求上下文。