Farun Search, POI and Navigation

Powerful geocoding APIs for searching places, reverse geocoding coordinates, and retrieving detailed location information. Build location-aware applications with fast, accurate, and developer-friendly REST APIs. API Coverage: https://farun.one/coverage

原始信息汇总

Farun Search, POI and Navigation 数据集详情

基本信息

• 定价模式：Freemium（免费增值）
• 基础套餐：BASIC，$0.00/月
• 类别：Mapping（地图）
• API 创建者：mlbrothers

API 概述

Farun Geocoding APIs 提供一整套位置搜索服务，帮助开发者将地址转换为坐标、将坐标转换为人类可读的地址，并获取有关地点的丰富信息。API 适用于地图、物流软件、旅行应用、配送平台及基于位置的服务。

包含的 API 接口

1. Search API（搜索 API）
   • 搜索地址、城市、地标、商业机构、邮政编码和兴趣点
   • 支持自动补全式搜索，将地名转换为精确的地理坐标
2. Reverse Geocode（反向地理编码）
   • 将纬度和经度坐标转换为格式化地址和附近位置信息
3. Search Detail API（搜索详情 API）
   • 使用搜索返回的地点 ID，检索特定地点的全面信息（地址、坐标、管理细节等）

端点与参数

1. 实时地点/兴趣点搜索

• 端点：GET /search
• 必需参数：q（查询文本，至少2个字符）
• 可选参数：types（文档类型过滤）、lat/lon（位置偏移）、size（结果数，1-25，默认10）
• 错误状态：422（参数无效）、502（后端错误）、503（服务未初始化）

2. 反向地理编码

• 端点：GET /search/reverse
• 必需参数：lat（纬度）、lon（经度）
• 可选参数：size（结果数，1-10，默认5）、types（文档类型过滤）、radius（搜索半径，如2km，默认2km）
• 错误状态：503（服务未初始化）

3. 搜索详情

• 端点：GET /search/detail/{doc_id}
• 必需路径参数：doc_id（文档ID或规范ID）
• 错误状态：404（文档未找到）、503（服务未初始化）

搜索结果对象字段

字段	类型	描述
id	string	文档 ID
score	number	搜索相关性分数
index	string	来源索引
doc_type	string or null	文档类型（place 或 poi）
display_name	string or null	完整显示名称
name	string or null	主要名称
name_en	string or null	英文名称
place_class	string or null	地点分类
category	string or null	POI 类别
importance	number or null	排序重要性
location	object or null	坐标 { "lat": number, "lon": number }
canonical_id	string or null	规范文档 ID
source	string or null	数据来源（如 osm 或 overture）
distance_m	number	仅反向地理编码返回时包含（距离米数）

关键特性

• 正向地理编码（地址 → 坐标）
• 反向地理编码（坐标 → 地址）
• 详细地点信息
• 城市、地标、商业机构、兴趣点搜索
• 快速准确的全球搜索
• RESTful API，JSON 响应
• 易于集成到 Web、移动和后端应用

适用场景

• 地图 & 导航应用
• 食品配送平台
• 网约车服务
• 车队管理 & 物流软件
• 旅行应用
• GPS 追踪系统
• 房地产平台
• 门店定位应用
• 位置智能解决方案

API 覆盖范围

• 覆盖链接：https://farun.one/coverage
• 数据来源：支持如 osm（OpenStreetMap）和 overture 等数据源

企业支持

• 企业需求及扩展速率限制可联系：[e-mail]

搜集汇总

背景与挑战

背景概述

Farun Search, POI and Navigation 是一套地理编码API，支持地点搜索、反向地理编码及详细位置信息获取，帮助开发者构建位置感知应用。该API以快速、准确和开发者友好的REST接口为特点，并提供了API覆盖范围查询。