GeoApi

GeoAPI is a lightweight and efficient API for geographic distance calculation and spatial indexing, designed for developers who need fast, simple, and reliable results without relying on expensive or complex services.

原始信息汇总

GeoApi 数据集概述

基本信息

• 数据集名称: GeoApi
• 数据集类别: Location
• API版本: v1 (current)
• 计费模式: 按使用付费（按请求计费）
• 定价: BASIC 计划 $0.00 / ---
• API创建者: Arthur-Nunes-dev

性能指标

• 流行度: 9 Popularity
• 服务等级: 71% Service Level
• 延迟: 592ms Latency
• 测试率: 67% Test

核心功能描述

GeoAPI 是一个轻量级、高效的 API，用于地理距离计算和空间索引。它专为需要快速、简单且可预测的基于位置的功能，且不希望依赖昂贵或复杂地图服务的开发者而设计。

核心概念

• Haversine: 用于计算地球表面两点之间直线距离的数学公式。
• Batch Haversine: Haversine 计算的批量版本，允许在单个请求中进行多次距离计算。
• GeoHash: 一种将纬度和经度转换为字符串的地理编码系统。GeoHash 前缀代表不同大小的区域，可实现高效的邻近搜索。

可用端点

1. Basic Haversine

• 端点: POST /api/basicHarversine

• 功能: 计算两个地理点之间的直线距离。

• 推荐用途: 简单距离计算、快速验证、基于邻近性的规则。

• 请求体示例: json { "data": { "from": { "lat": -21.1, "lon": 55.04 }, "to": { "lat": -22, "lon": 55.04 } } }

• 响应示例: json { "distance": 100 }

2. Batch Haversine

• 端点: POST /api/batchHarversine

• 功能: 在单个请求中计算多个距离。

• 推荐用途: 位置列表、降低延迟、批量处理。

• 请求体示例: json { "data": [ { "lat1": -21.1, "lon1": 55.04, "lat2": -22, "lon2": 55.04 }, { "lat1": -20.5, "lon1": 54.9, "lat2": -21.0, "lon2": 55.1 } ] }

• 响应示例: json { "count": 2, "results": [ { "distance": 100 }, { "distance": 75 } ] }

3. Create GeoHash Point

• 端点: POST /api/geoHash

• 功能: 使用基于 GeoHash 的空间索引存储地理点。

• 推荐用途: 存储商店或企业、兴趣点、地理位置用户。

• 请求体示例: json { "data": { "lat": -22, "lon": 55.04, "name": "Lojax" } }

• 响应示例: json { "id": "1725978123123", "latitude": -22, "longitude": 55.04, "name": "Lojax", "geohash": "gbsuv7x", "gh5": "gbsuv", "gh6": "gbsuv7", "createdAt": "2025-09-10T14:22:03.123Z" }

4. GeoHash Proximity Search

• 端点: GET /api/geoHash
• 功能: 使用 GeoHash 前缀匹配搜索附近的点。
• 查询参数:
  • lat: 中心纬度（数字类型）
  • lon: 中心经度（数字类型）
  • radius: 中心近似半径（公里，数字类型）
• 示例请求: /api/geoHash?lat=-21.100&lon=55.040&radius=100
• 响应示例: json { "center": { "lat": -21.1, "lon": 55.04 }, "radius": 100, "precision": 5, "count": 3, "results": [ { "latitude": -21.12, "longitude": 55.02, "geohash": "gbsuv" } ] }

推荐使用流程

1. 使用 POST /api/geoHash 存储点。
2. 使用 GET /api/geoHash 检索附近的候选点。
3. 使用 Basic 或 Batch Haversine 细化距离。

局限性

• 距离仅为直线距离。
• GeoHash 使用区域近似。
• 无道路路线或行程时间计算。

最佳实践

• 使用 GeoHash 来减少距离计算。
• 对于多个点，优先使用 Batch Haversine。
• 在发送请求前验证坐标。

目标用例

• MVPs
• 初创公司
• 简单的配送应用
• 基础物流
• 教育和原型项目

总结

GeoAPI 提供基本的地理定位功能：快速、简单、经济且可预测。您只需使用您需要的功能，并且只为您的消费付费。

搜集汇总

背景与挑战

背景概述

GeoApi是一个轻量高效的地理计算API，专注于提供快速可靠的地理距离计算和空间索引功能，旨在为开发者替代昂贵复杂的服务方案。