GeoPulse - Global Cities & Geolocation API

Comprehensive global cities and geodata API covering 800k+ places with GPS radius, distance, and timezone support.

原始信息汇总

GeoPulse - Global Cities & Geolocation API 数据集详情

基本信息

• API名称: GeoPulse - Global Cities & Geolocation API
• 类别: Location
• API版本: 1.0.0
• 提供者: Cleyson Mayrink
• 性能指标: 服务级别 100%，延迟 626ms，测试通过率 100%
• 热度: 8.7 人气指数

定价方案

• BASIC: $0.00 / 月
• PRO: $9.90 / 月
• ULTRA: $19.90 / 月
• MEGA: $39.90 / 月

数据集概述

这是一个覆盖全球的综合城市与地理数据API，包含超过 800,000个 城市、城镇、行政区划、县和国家。数据来源于 GeoNames 和 Wikidata，采用 知识共享署名4.0国际许可（CC BY 4.0） 授权。

核心功能特性

• 全面覆盖: 涵盖800,000多个居民点、区域首府、行政区划及252个国家和地区
• 邻近与半径搜索: 可在任意坐标对或现有地点周围自定义半径内定位城市、行政分区或居民点
• 多条件筛选: 支持按名称前缀、国家代码、排除国家、时区和人口范围进行过滤
• 灵活排序: 可按名称、国家代码、海拔、人口或复合排序键进行排序
• 完整地点信息: 提供精确纬度、经度、海拔高度、人口、IANA时区标识符及国家/地区代码
• 实时本地时间: 返回经夏令时调整的实时本地时间及ISO-8601时间戳
• 地理层级: 支持从国家到地区/州、再到城市和区划的无缝下钻查询
• 货币与语言支持: 支持查询特定货币的国家，探索国际语言环境与语言
• Wikidata集成: 包含本地Wikidata标识符，便于关联数据使用与外部数据丰富
• 分页导航: 结构化响应用于包含元数据计数和标准导航链接

应用场景

• 基于位置发现: 根据设备GPS坐标确定用户最近的城市或行政区
• 搜索自动完成: 在结账或注册流程中为城市、州和国家的实时自动完成下拉框提供支持
• 级联表单选择器: 用户选择国家后自动填充州和城市下拉列表
• 物流运输: 计算仓库、始发城市和客户位置之间的直线距离
• 旅游与酒店: 发现焦点位置周边可驾车到达的邻近城市与目的地
• 时区敏感调度: 显示跨国际时区远程客户端、办公室或预订目的地的准确当地时间
• 国家资料展示: 渲染国家信息、货币、拨号代码及官方旗帜资源

主要API端点

城市（Cities）

• GET /geo/cities - 搜索和筛选城市
• GET /geo/cities/{cityId} - 获取特定城市的详细信息
• GET /geo/cities/{cityId}/nearbyCities - 查找邻近城市
• GET /geo/cities/{cityId}/nearbyDivisions - 查找周边行政区划
• GET /geo/cities/{cityId}/nearbyPlaces - 查找附近居民点
• GET /geo/cities/{cityId}/distance - 计算到另一城市的测地距离
• GET /geo/cities/{cityId}/time - 获取城市当前本地时钟时间
• GET /geo/cities/{cityId}/dateTime - 获取城市当前ISO-8601本地日期时间
• GET /geo/cities/{cityId}/locatedIn - 获取包含该城市的上级行政区和国家

位置（GPS坐标）

• GET /geo/locations/{locationId}/nearbyCities - 查找GPS坐标半径内的城市
• GET /geo/locations/{locationId}/nearbyDivisions - 查找GPS坐标周边的行政区划
• GET /geo/locations/{locationId}/nearbyPlaces - 查找GPS坐标周边的居民点

国家与地区

• GET /geo/countries - 列出所有国家和地区及货币与首都信息
• GET /geo/countries/{countryId} - 获取综合国家资料（拨号前缀、国旗URL、区域数量）
• GET /geo/countries/{countryId}/regions - 列出一国的行政州、省或区
• GET /geo/countries/{countryId}/regions/{regionCode} - 获取特定地区州或省详情
• GET /geo/countries/{countryId}/regions/{regionCode}/cities - 列出特定州或省内的城市
• GET /geo/countries/{countryId}/regions/{regionCode}/adminDivisions - 列出区域内的分区
• GET /geo/countries/{countryId}/regions/{regionCode}/places - 列出区域内的居民点
• GET /geo/countries/{countryId}/places - 列出整个国家的居民点

行政区划

• GET /geo/adminDivisions - 全局搜索顶级行政分区
• GET /geo/adminDivisions/{divisionId} - 获取行政区划详情
• GET /geo/adminDivisions/{divisionId}/nearbyCities - 定位行政区附近的城市
• GET /geo/adminDivisions/{divisionId}/nearbyDivisions - 查找邻近行政区划
• GET /geo/adminDivisions/{divisionId}/nearbyPlaces - 查找行政区附近的地点

通用地点

• GET /geo/places - 跨居民点、分区和市政点搜索
• GET /geo/places/{placeId} - 获取完整地点详情
• GET /geo/places/{placeId}/nearbyPlaces - 查找周边地点
• GET /geo/places/{placeId}/distance - 计算到另一地点的距离
• GET /geo/places/{placeId}/time - 获取地点实时本地时间
• GET /geo/places/{placeId}/dateTime - 获取地点实时ISO-8601日期时间
• GET /geo/places/{placeId}/locatedIn - 获取包含该地点的区域和国家

语言环境与时区

• GET /locale/currencies - 列出世界货币及关联国家代码
• GET /locale/languages - 列出支持的语言描述符和ISO-639代码
• GET /locale/locales - 列出支持的国际语言环境代码
• GET /locale/timezones - 列出所有规范IANA时区和UTC偏移
• GET /locale/timezones/{zoneId} - 获取IANA时区详情及UTC偏移
• GET /locale/timezones/{zoneId}/time - 获取IANA时区的实时本地时间
• GET /locale/timezones/{zoneId}/dateTime - 获取IANA时区的实时ISO-8601日期时间

基础设施与许可

• 全球分布式架构: 部署于弹性多区域云边缘网络，具备自动故障转移和DDoS防护
• 自动边缘缓存: 高频查询（国家、顶级区域、时区元数据）在边缘缓存以保持稳定吞吐
• 数据来源: 地理信息来自官方GeoNames记录，并通过Wikidata标识符进行丰富
• 数据集许可: 根据知识共享署名4.0国际许可（CC BY 4.0）提供

响应格式

集合端点返回统一信封结构，包含 data 数组、links 导航链接及分页 metadata（含 currentOffset 和 totalCount），每项数据包含来源标识（如 wikiDataId）、类型、名称、坐标、时区及人口等信息。