地理
获取超过 60 万个地区的房产和机场位置信息
快速地理 API 为您提供超过 60 万个地区和机场的地理定义和属性映射。它包含多个子 API，供您在 Rapid API 实现中使用。
多地区 API
如果您不确定要在搜索中使用哪个特定区域 ID，请使用 Regions API 查找与请求参数匹配的区域的地理定义和属性映射。如需请求全球的所有地区，请省略父级查询参数。如果包含祖先区域 ID，此 API 将返回特定大洲、国家或其他级别中的所有区域。
地区 API
如果您知道要查找的区域 ID，请使用区域 API 返回该区域的地理定义和属性映射。
多边形 API
此 API 会根据您的地理定义返回自定义多边形内的属性。如果您维护自己的地理定义并且不使用 Rapid API 地理区域，请使用它来构建您的属性映射数据库。轻松将住宿映射到您的地理定义，如多个城市、城市和街区等区域。
其他参考信息
地区类型
type字段用于说明所代表的地理实体，例如城市或社区。有关详细说明，请参考地区类型列表。
区域
area参数可用于指定公里半径以及中心纬度/经度坐标或区域边界。
- 结合使用半径以及
region_id，将搜索从地区边界向各个方向延伸指定公里数的区域。 - 结合使用半径以及由经度/纬度对指定的单个点，将搜索具有指定公里半径的圆中的区域。
- 指定的半径值应为非负整公里数。小数将导致错误。允许半径为 0。
限制条件
- 指定区域参数时，结果限制为 100 个，可以通过限制参数进一步缩小范围。
- 由于结果数量的限制，除非将
point_of_interest指定为唯一的type，否则筛选area请求的结果中将不会包含类型为point_of_interest的地区。 - 如果
point_of_interest与其他类型一起提供，则将忽略point_of_interest（不会报错）而应用所有其他type选择。
示例：
搜索指定纬度/经度 50 公里内的机场：
type=airport&limit=3&area=50,37.227924,93.310036使用地区 ID 搜索城市 type 且限制在 3 至 5 公里内的区域：
&area=5,602962&supply_source=expedia&type=city&limit=3国家/地区细分代码
筛选结果缩小到仅包括 ISO 3166-2 国家/地区细分代码，例如 US-MO。country_subdivision_code 既是一个字段，也是一个搜索参数。
示例：
按 ISO 代码搜索地区：
country_subdivision_code =US-MO本地化
language对象仅使用 two-digit 语言和国家代码的连字符对。在集成任何代码之前，请查看支持的语言。请求的语言中只提供响应中的 name 和 name_full 字段。响应中的所有其他地理定义都将以英文提供。
多边形
bounding_polygon 对象提供环绕该地区形状的坐标列表。地区可以覆盖由单个多边形或多个多边形表示的区域。用单个坐标表示的区域类型（例如兴趣点、火车站或机场）没有边界多边形。
bounding_polygon对象遵循 GeoJSON 标准，在提供坐标列表时，经度值列在前，纬度值列在后。
注意： Rapid Lodging API 支持 8 KB 的有效负载，最多可容纳 2,000 个坐标。
各地区之间的关联
使用 associations 对象提供各地区之间的旅游关系。在 associations 对象中，我们建立了以下模型：
- 各种机场地区类型的关联城市。这可让您针对任何特定机场推荐目的地。
- 特定区域的主要景点。这样，当旅行者访问特定地区（例如加利福尼亚州、伦敦或布鲁克林）时，您可以推荐值得一游的地方。
各地区之间的层次结构
使用 ancestors 和 descendants 对象提供各地区之间的关系。由于全世界的地理和政治信息变动，地区类型没有严格的层次结构。但从逻辑上讲，一个城市通常是与多个城市、州/省或国家/地区相关联的。如需获得某个特定地区的层次结构，请使用 ancestors 值。
ancestors：表示给定区域之上的层级结构。例如，多边形城市希腊雅典的直接父级地区是阿提卡地区，再往上，其父级层次结构包含希腊和欧洲。一个地区可能会有多个父级层次结构。由于多边形城市日内瓦位于瑞士和法国的边界，它将在这两个国家/地区中拥有父级层次结构。descendants：表示给定区域以下的层级结构。在我们的例子中，希腊比雷埃夫斯市是多边形城市希腊雅典的子级层次结构。某个地区对象内的子级映射仅包含该地区的直接子级层次结构（向下一个级别）。
要提供有关地理特征的更详细信息，请使用tags和categories：
tags：通过描述地理特征，使其名称反映出这些特征在现实生活中的命名方式，从而提供更细致的地理特征信息。示例包括对活动（滑雪、赛马场等）、景点、市政区域或地理行政区域（如州、教区或地区）的描述。categories：创建全球适用的地理特征层级结构，旨在提供可比的地理级别，而不受任何特定国家或地区的政府结构的影响。示例包括大洲、国家/地区或省份。
注意： 如果您的实现方案有多个供应来源，您需要将它们分层到您想要使用的地理区域。
示例：
"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]地区的住宿映射
为区域类型提供属性映射，包括high_level_region、province_state、multi_city_vicinity、city、neighborhood、point_of_interest和部分国家/地区。以下两个 include 参数选项中提供住宿映射：
property_ids：此选项仅提供该地区多边形内的住宿。多边形为表示该地区的区域的限定形状。property_ids_expanded：如果该地区的多边形未包含至少 100 家住宿，此选项提供多边形内的住宿，以及该地区 30 公里半径内的住宿。此住宿扩展集合应确保某个目的地的住宿搜索结果中提供足量 的住宿。对于由单个坐标而不是一个多边形（例如兴趣点）表示的地区类型，只有该扩展选项才会提供关联的住宿映射。
对于较大的区域类型（high_level_region、province_state、country和continent），最多将返回前 500 个属性。要获取这些区域中所有属性的完整列表，您需要向组成该较大区域的每个子区域请求属性。
多边形已经过优化，可使用搜索和交易数据，还将支持多边形外最相关的较小地区扩展。
API 详情
查看此页面上与地理相关的端点定义，然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。
其他资源
无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合，我们都能满足您的需求。