Spott

Search cities, countries and administrative divisions by name, autocompletion or IP.

原始信息汇总

Spott 数据集概述

基本信息

• 数据集名称: Spott
• 提供平台: RapidAPI
• API版本: v1 (current)
• 数据类别: 地理位置 (Location)
• 订阅者数量: 1887
• 数据来源: 基于 GeoNames.org（最大的开放地理数据库）

核心功能与用途

• 搜索全球范围内的城市、国家和行政区划（州、地区、省份等）。
• 支持通过完整查询或自动补全进行地点搜索，涵盖超过 240,000 条全球记录。
• 可按国家、类型和位置对搜索结果进行过滤。
• 提供超过 20 种语言的地点本地化名称。
• 通过 IP 地址查找其所在位置。

数据结构

地点 (Places)

所有返回的地点可能包含以下属性：

属性	类型	描述
id	String	Spott 提供的唯一标识符。
geonameId	Integer	GeoNames 提供的唯一标识符。
type	String	地点分类。可能值：CITY、ADMIN_DIVISION_1、ADMIN_DIVISION_2、COUNTRY。
name	String	地点默认名称（通常为英文）。此属性始终有值。
localizedName	String	请求语言下的地点本地化名称。仅在指定 language 参数时出现。翻译不可用时为 null。
population	Integer	该地点的近似人口。
elevation	Float	相对于海平面的近似海拔高度（米）。
coordinates	Object	地点所在的地理坐标。
coordinates.latitude	Float	地点地理坐标的纬度分量。
coordinates.longitude	Float	地点地理坐标的经度分量。
timezoneId	String	与地点关联的时区。对于国家，此属性为 null（可能包含多个时区）。
score	Float	用于按相关性排序结果的计算分数。仅在返回列表的端点结果中出现。
adminDivision2	Object	地点所在的二级行政区划的简化版本。仅适用于 CITY 类型地点。包含属性：id、geonameId、name、localizedName。
adminDivision1	Object	地点所在的一级行政区划的简化版本。仅适用于 CITY 和 ADMIN_DIVISION_1 类型地点。包含属性：id、geonameId、name、localizedName。
country	Object	地点所在国家的简化版本。仅适用于 CITY、ADMIN_DIVISION_1 和 ADMIN_DIVISION_2 类型地点。包含属性：id、geonameId、name、localizedName。

国家 (Countries)

除地点属性外，COUNTRY 类型的地点还可能包含以下属性：

属性	类型	描述
iso2	String	国家的 ISO 3166-1 Alpha-2 代码。
iso3	String	国家的 ISO 3166-1 Alpha-3 代码。
isoNumeric	String	国家的 ISO 3166-1 数字代码。
continentId	String	国家所在大洲的 ID。有效值：AF（非洲）、AS（亚洲）、EU（欧洲）、NA（北美洲）、OC（大洋洲）、SA（南美洲）、AN（南极洲）。
domain	String	国家的顶级域名。
areaSqKm	Integer	国家总面积（平方公里）。
currencyCode	String	国家官方货币代码。
currencyName	String	国家官方货币名称。
postalCodeFormat	String	该国使用的邮政编码格式。
postalCodeRegex	String	验证该国邮政编码的正则表达式。
phoneCodes	Array[String]	拨打该国号码的国际电话代码列表。
neighbourCountryIds	Array[String]	与其接壤（邻国）的国家 ID 列表。
languages	Array[String]	该国使用的语言列表。
locales	Array[String]	该国使用的区域设置（语言+地区）列表。

地点类型与层级

地点按类型的层级关系为： COUNTRY → ADMIN_DIVISION_1 → ADMIN_DIVISION_2* → CITY （*并非所有国家都有二级行政区划）

标识符说明

• id: Spott 提供的唯一地点标识符。推荐使用此标识符，因为它更具意义且得到 Spott 全面支持（例如，过滤参数使用 id 而非 geonameId）。
• geonameId: GeoNames 开放地理数据库提供的唯一标识符。
• 对于城市，id 和 geonameId 相同。

语言支持

• 支持通过 language 参数获取地点本地化名称 (localizedName)。
• 语言使用 ISO 639-1 代码。
• 数据库包含超过 181 种语言的地点名称，但对 21 种语言有显著支持：

ISO 639-1	语言名称
ar	阿拉伯语
bg	保加利亚语
de	德语
en	英语
eo	世界语
es	西班牙语
fa	波斯语
fr	法语
id	印尼语
it	意大利语
ja	日语
kk	哈萨克语
ko	韩语
nl	荷兰语
pl	波兰语
pt	葡萄牙语
ru	俄语
sr	塞尔维亚语
uk	乌克兰语
ur	乌尔都语
zh	中文

可用端点

• GET Autocomplete places
• GET Search places
• GET Get place by my IP
• GET Get place by IP
• GET Get place by ID
• GET Get place by Geoname ID

认证与访问

• 通过 RapidAPI 访问 Spott。
• 需要在请求头 X-RapidAPI-Key 中发送 API 密钥。

免费计划

• 提供免费计划，每月最多 10,000 次请求（适用于任何端点）。
• 订阅免费计划需要信用卡信息，但请求数有严格限制，不会产生费用。

技术指标

• 流行度: 9.8
• 服务等级: 95%
• 延迟: 337ms
• 测试覆盖率: 25%

订阅计划

• BASIC: $5.00 / 月
• PRO: $19.00 / 月
• ULTRA: $99.00 / 月