地理
地理 API 向您提供超过 60 万个地区和机场的地理定义和住宿映射的访问权限。
多个地区
返回地理定义和住宿映射，此类信息与指定参数的地区相匹配。
如需请求全球的所有地区，请省略父级查询参数。如需请求获取某个特定大洲、国家/地区或其他地理级别中所有地区的信息，请将该地区的 ID 指定为父级地区。请参考以下地区概要的列表。
单个地区
返回请求的地区 ID 的地理定义和住宿映射。
使用此 API，即可检索某个已知地区 ID 的地理信息和住宿映射。
获取地理定义范围内的住宿
根据您的地理定义，返回自定义多边形内的住宿。
如果您保留自己的地理定义，并且不使用 Rapid 地理地区，则可以使用此 API 来建立您的住宿映射数据库。轻松将住宿映射到您的地理定义，如多个城市、城市和街区等区域。
搜索筛选条件参数
三个搜索参数支持进一步筛选结果，使客户能够更精确地进行搜索。
supply_source表示住宿的来源是 Expedia 还是 Vrbo。如果不包含，则此筛选条件将默认为supply_source=expedia。country_code允许按国家/地区筛选结果。type说明所表示的地理实体，例如城市或街区。country_subdivision_code允许将筛选结果缩小到 ISO 3166-2 国家/地区细分代码。area允许按地理位置搜索。下面提供了更多信息。
其他参考信息
地区类型
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_score=expedia&type=city&limit=3国家/地区细分代码
筛选结果缩小到仅包括 ISO 3166-2 国家/地区细分代码，例如 US-MO。country_subdivision_code 既是一个字段，也是一个搜索参数。
示例：
按 ISO 代码搜索地区：
country_subdivision_code =US-MO本地化
language 对象仅使用连字符连接的一对两位语言和国家/地区代码。访问此处可查看所有语言选项。在集成任何代码之前，请查看支持的语言。请求的语言中只提供响应中的 name 和 name_full 字段。响应中的所有其他地理定义都将以英文提供。
多边形
bounding_polygon 对象提供环绕该地区形状的坐标列表。地区可以覆盖由单个多边形或多个多边形表示的区域。由单个坐标（例如兴趣点、火车站、机场等）表示的地区类型没有限定多边形。
bounding_polygon 对象遵循 GeoJSON 标准，在提供坐标列表时，首先列出经度值，然后再列出纬度值。
各地区之间的关联
使用 associations 对象提供各地区之间的旅游关系。在 associations 对象中，我们建立了以下模型：
- 各种机场地区类型的关联城市。这可让您针对任何特定机场推荐目的地。
- 指定地区的热门兴趣点 (POI)。这可让您在旅客访问特定地区（如加州、伦敦或布鲁克林）时，提供推荐 POI。
各地区之间的层次结构
使用 ancestors 和 descendants 对象提供各地区之间的关系。由于全世界的地理和政治信息变动，地区类型没有严格的层次结构。但从逻辑上讲，一个城市通常是与多个城市、州/省或国家/地区相关联的。如需获得某个特定地区的层次结构，请使用 ancestors 值。
ancestors表示某个指定地区之上的层次结构级别。例如，多边形城市希腊雅典的直接父级地区是阿提卡地区，再往上，其父级层次结构包含希腊和欧洲。一个地区可能会有多个父级层次结构。由于多边形城市日内瓦位于瑞士和法国的边界，它将在这两个国家/地区中拥有父级层次结构。descendants表示某个指定地区之下的层次结构级别。在我们的例子中，希腊比雷埃夫斯市是多边形城市希腊雅典的子级层次结构。某个地区对象内的子级映射仅包含该地区的直接子级层次结构（向下一个级别）。
tags 和 categories 使合作伙伴能够向客户提供更详细的地理特征信息。
tags以反映这些特征在现实生活中的命名方式描述它们，提供更详细的地理特征信息。示例包括对活动（滑雪、赛马场等）、景点、市政区域或地理行政区域（如州、教区或地区）的描述。categories创建一个全球适用的地理特征层次结构，旨在提供可比较的地理层次，而不考虑任何给定国家或地区的政府结构如何。示例包括大洲、国家/地区或省份。
**注意：**拥有多个供应来源的合作伙伴需要将自身的供应分层到其想要使用的地理区域。
示例：
"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]地区的住宿映射
对于单地区和多地区 API，均提供了住宿映射。具有住宿映射的地区类型有：high_level_region、state_province、multi_city_vicinity、city、neighborhood、point_of_interest 和部分国家/地区。以下两个 include 参数选项中提供住宿映射：
property_ids：此选项仅提供该地区多边形内的住宿。多边形为表示该地区的区域的限定形状。property_ids_expanded：如果该地区的多边形未包含至少 100 家住宿，此选项提供多边形内的住宿，以及该地区 30 公里半径内的住宿。此住宿扩展集合应确保某个目的地的住宿搜索结果中提供足量的住宿。对于由单个坐标而不是一个多边形（例如兴趣点）表示的地区类型，只有该扩展选项才会提供关联的住宿映射。
多边形已经过优化，可使用搜索和交易数据，还将支持多边形外最相关的较小地区扩展。
API 详情
查看此页面上与地理相关的端点定义，然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。
其他资源
无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合，我们都能满足您的需求。