GeoDB Cities & Countries by 🐚 The 17711 Mesh

Cities, countries, regions : search, autocomplete, nearby, distance. 25,000+ cities, 250 countries. GeoNames powered, updated weekly.

原始信息汇总

GeoDB Cities & Countries by 🐚 The 17711 Mesh 数据集概述

数据集基本信息

• 名称: GeoDB Cities & Countries by 🐚 The 17711 Mesh
• 类别: Location
• 提供者: 17711
• 数据源: GeoNames (geonames.org), Creative Commons Attribution 4.0
• 更新频率: 每周更新
• API版本: 0.5.0 (current)
• 基础URL: https://services.17711.org

数据规模与覆盖范围

• 城市数量: 超过 25,000 个（人口 > 15,000）
• 国家数量: 250 个
• 总记录统计: 25,832 个城市，252 个国家

核心功能与端点

城市相关操作

• GET /api/geo/data/v0.1.0/cities: 使用筛选器和分页搜索城市。
• GET /api/geo/data/v0.1.0/cities/autocomplete: 基于 FTS5 全文搜索的快速城市名称自动补全。
• GET /api/geo/data/v0.1.0/cities/nearby: 查找坐标半径内的城市。
• GET /api/geo/data/v0.1.0/cities/{id}: 通过 GeoNames ID 获取城市详情。

国家相关操作

• GET /api/geo/data/v0.1.0/countries: 列出所有包含元数据的国家。
• GET /api/geo/data/v0.1.0/countries/{code}: 通过 ISO 3166-1 alpha-2 代码获取国家详情。

实用工具

• GET /api/geo/data/v0.1.0/distance: 计算两个城市之间的大圆（Haversine）距离和方位角。
• GET /api/geo/data/v0.1.0/stats: 获取数据库统计信息。
• GET /api/geo/data/v0.1.0/health: 健康检查（无需认证）。

认证与访问

• 认证要求: 所有端点（除 health 外）都需要 X-RapidAPI-Proxy-Secret 头部（由 RapidAPI 提供）或 mesh 认证头部。

技术特性

• 自动补全: 使用 SQLite FTS5，亚毫秒级响应。
• 附近搜索: 使用 Haversine 公式，并带有边界框预过滤。
• 距离计算: 大圆距离（Haversine），非道路距离。

订阅计划与速率限制

计划	价格（每月）	每月配额	速率限制
Free	$0.00	1,000	1/秒
Starter	$3.00	10,000	3/秒
Basic	$8.00	50,000	8/秒
Pro	$21.00	500,000	13/秒

错误代码

代码	含义
200	成功
400	参数缺失或无效
401	认证缺失或无效
404	城市或国家未找到
429	超出速率限制

搜集汇总

背景与挑战

背景概述

该数据集提供城市、国家和地区的详细地理信息，支持搜索、自动完成、附近查询和距离计算等功能。它包含超过25,000个城市和250个国家的数据，基于GeoNames数据源并每周更新。