지리
60만 개 이상의 지역에서 숙박 시설 및 공항 위치에 액세스하세요.
빠른 지리 API는 600,000개 이상의 지역과 공항에 대한 지리적 정의와 숙박 시설 매핑에 액세스할 수 있는 기능을 제공합니다. 여기에는 Rapid API 구현에 활용할 수 있는 여러 하위 API가 포함되어 있습니다.
지역 API
검색에 사용할 특정 지역 ID를 잘 모르는 경우, 지역 API를 사용하여 요청된 매개변수와 일치하는 지역의 지리적 정의 및 숙박 시설 매핑을 찾아보세요. 전 세계 모든 지역을 요청하려면 상위 쿼리 매개변수를 생략합니다. 조상 지역 ID를 포함하면 이 API는 특정 대륙, 국가 또는 기타 레벨의 모든 지역을 반환합니다.
지역 API
검색하려는 지역 ID를 알고 있다면 지역 API를 사용하여 지역 정의와 이에 대한 숙박 시설 매핑을 반환하세요.
다각형 API
이 API는 지역 정의에 따라 사용자 지정 폴리곤 내에서 숙박 시설를 반환합니다. 자체 지리 정의를 유지하고 Rapid API 지리 지역을 사용하지 않는 경우 숙박 시설 매핑 데이터베이스를 구축하는 데 사용하세요. 여러 도시, 도시 및 주변 등 지역에 대한 지리 정의에 숙박 시설을 쉽게 매핑할 수 있습니다.
추가 참조 정보
지역 유형
type필드에는 도시 또는 지역과 같이 표시되는 지리적 실체를 설명합니다. 자세한 설명은 지역 유형 목록을 참조해 주세요.
영역
area매개변수는 반경 킬로미터와 중심 위도/경도 좌표 또는 지역 경계를 지정하는 데 사용할 수 있습니다.
- 반경을
region_id와 함께 사용하면 해당 지역의 경계에서 모든 방향으로 지정된 킬로미터 수만큼 확장된 영역을 검색할 수 있습니다. - 위도/경도 쌍으로 지정된 단일 지점과 반경을 함께 사용하면 지정된 킬로미터 반경의 원 안의 영역을 검색할 수 있습니다.
- 반경은 음수가 아닌 정수 킬로미터로 지정해야 합니다. 소수점을 사용하면 오류가 생성됩니다. 0의 반경은 허용됩니다.
제한 사항
- 영역 매개변수를 지정할 때 100개의 결과 제한이 있으며, 제한 매개변수로 범위를 더 좁힐 수 있습니다.
- 결과 수로 인해,
point_of_interest가 유일한type으로 지정되지 않는 한point_of_interest유형의 지역은area로 필터링하는 요청에 포함되지 않습니다. point_of_interest가 다른 유형과 함께 제공된 경우point_of_interest는 무시되고(오류 없음) 다른 모든type선택 항목이 적용됩니다.
예시:
위도/경도 50km 이내의 공항 검색:
type=airport&limit=3&area=50,37.227924,93.3100363~5km 영역 제한으로 도시 type에 대한 지역 ID 영역 검색
&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 표준 좌표 목록을 제공할 때는 경도 값을 먼저 나열한 다음 위도를 나열합니다.
참고: 빠른 숙박 API는 최대 2,000개의 좌표를 수용할 수 있는 8KB의 페이로드를 지원합니다.
지역 간 연관성
지역 간 여행 관계는 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개 이상의 숙박 시설이 포함되어 있지 않을 경우, 이 옵션은 지역의 반경 30km 내에 있는 숙박 시설 외에 해당 폴리곤 내의 숙박 시설을 제공합니다. 이렇게 폭넓은 숙박 시설 집합이 제공되어 목적지의 숙박 시설 검색 결과에 충분한 숙박 시설이 포함될 수 있습니다. 폴리곤이 아닌 단일 좌표(예: 관광명소)로 표시되는 지역 유형의 경우 이러한 확장된 옵션을 사용해야 연관된 숙박 시설 매핑이 제공됩니다.
더 큰 지역 유형(high_level_region, province_state, country, continent)의 경우 최대 상위 500개의 숙박 시설가 반환됩니다. 이러한 지역의 숙박 시설 전체 목록을 보려면 더 큰 지역을 구성하는 각 자손에게 숙박 시설를 요청해야 합니다.
폴리곤은 검색 및 거래 데이터 사용에 최적화되며 가장 관련성이 높은 폴리곤 외부의 더 작은 지역으로 확장됩니다.
API 세부 정보
이 페이지에서 지리 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.
추가 리소스
모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.