지리
지리 API를 통해 600,000개 이상의 지역 및 공항에 대한 지리적 정의 및 숙박 시설 매핑에 액세스할 수 있습니다.
복수 지역
지정된 매개변수와 일치하는 지역의 지리적 정의 및 숙박 시설 매핑을 반환합니다.
전 세계 모든 지역을 요청하려면 상위 쿼리 매개변수를 생략합니다. 특정 대륙, 국가 또는 기타 수준의 모든 지역을 요청하려면 해당 지역의 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 개체는 1km 반경, 중심 위도/경도 좌표 또는 지역 경계와 함께 사용할 수 있습니다.
- 반경을
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_score=expedia&type=city&limit=3국가 세분화 코드
ISO 3166-2 국가 세분화(예: US-MO)로만 결과를 필터링합니다.country_subdivision_code는 필드이자 검색 매개변수입니다.
예시:
ISO 코드로 지역 검색:
country_subdivision_code =US-MO현지화
language 개체는 하이픈으로 연결된 2자리 언어 및 국가 코드 쌍만 사용합니다. 모든 언어 옵션은 여기에서 확인해 주세요. 코드를 통합하기 전에 지원되는 언어를 검토해 주세요. 응답에서 name 및 name_full 필드만 요청된 언어로 제공됩니다. 응답의 다른 모든 지리 정의는 영어로 표시됩니다.
폴리곤
bounding_polygon 개체는 지역 형태를 포함하는 좌표 목록을 제공합니다. 단일 폴리곤 또는 여러 폴리곤으로 표시되는 영역이 지역에 포함될 수 있습니다. 단일 좌표(예: 관광명소, 기차역, 공항 등)로 표시되는 지역 유형에는 경계 폴리곤이 없습니다.
bounding_polygon 개체는 좌표 목록을 제공할 때 경도 값이 먼저 나온 후 위도 값이 나오는 GeoJSON 표준을 따릅니다.
지역 간 연관성
지역 간 여행 관계는 associations 개체를 사용하여 제공됩니다. associations 개체 내에서 다음을 모델링합니다.
- 공항 유형 지역의 연관 도시. 이를 통해 특정 공항에 대한 목적지를 추천할 수 있습니다.
- 지정된 지역의 인기 관광명소(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개 이상의 숙박 시설이 포함되어 있지 않을 경우, 이 옵션은 지역의 반경 30km 내에 있는 숙박 시설 외에 해당 폴리곤 내의 숙박 시설을 제공합니다. 이렇게 폭넓은 숙박 시설 집합이 제공되어 목적지의 숙박 시설 검색 결과에 충분한 숙박 시설이 포함될 수 있습니다. 폴리곤이 아닌 단일 좌표(예: 관광명소)로 표시되는 지역 유형의 경우 이러한 확장된 옵션을 사용해야 연관된 숙박 시설 매핑이 제공됩니다.
폴리곤은 검색 및 거래 데이터 사용에 최적화되며 가장 관련성이 높은 폴리곤 외부의 더 작은 지역으로 확장됩니다.
API 세부 정보
이 페이지에서 지리 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.
추가 리소스
모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.