지리

숙박 시설 및 60만 개 이상의 지역에 위치한 공항 정보를 확인하세요

Rapid Geography API를 통해 60만 개 이상의 지역 및 공항에 대한 지리적 정의와 숙박 시설 매핑 정보를 이용할 수 있습니다. 여기에는 ‘ Rapid API ’ 구현 시 활용할 수 있는 여러 하위 API가 포함되어 있습니다.

지역 API

검색에 사용할 특정 지역 ID를 잘 모르겠다면, Regions API를 사용하여 요청된 매개변수와 일치하는 지역의 지리적 정의와 숙박 시설 매핑 정보를 확인하세요. 전 세계 모든 지역을 요청하려면 상위 쿼리 매개변수를 생략합니다. 조상 지역 ID를 포함하면, 이 API는 특정 대륙, 국가 또는 그 외의 수준에 속하는 모든 지역을 반환합니다.

지역 API

검색하려는 지역 ID를 알고 있다면, Region API를 사용하여 해당 지역의 지리적 정의와 숙박 시설 매핑 정보를 가져오세요.

Polygon API

이 API는 사용자가 정의한 지리적 기준에 따라 사용자 지정 다각형 내의 숙박 시설를 반환합니다. Rapid API 의 지리 구역을 사용하지 않고 자체 지리 정의를 관리하고 계신다면, 이를 활용하여 숙박 시설 매핑 데이터베이스를 구축하십시오. 여러 도시, 도시 및 주변 등 지역에 대한 지리 정의에 숙박 시설을 쉽게 매핑할 수 있습니다.

추가 참조 정보

지역 유형

‘ type ’ 필드는 도시나 동네 등 해당 필드가 나타내는 지리적 개체를 설명합니다. 자세한 설명은 지역 유형 목록을 참조하세요.

>> 지역 유형 전체 목록 보기

영역

area매개변수를 사용하면 반경 1킬로미터 범위와 중심 위도/경도 좌표 또는 특정 지역의 경계를 지정할 수 있습니다.

반경을 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.310036

3~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 표준을 따릅니다.

>> GeoJSON 표준에 대해 자세히 알아보기

참고: Rapid Lodging API는 8KB 크기의 페이로드를 지원하며, 이 용량에는 최대 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개 이상의 숙박 시설이 포함되어 있지 않을 경우, 이 옵션은 지역의 반경 30km 내에 있는 숙박 시설 외에 해당 폴리곤 내의 숙박 시설을 제공합니다. 이렇게 폭넓은 숙박 시설 집합이 제공되어 목적지의 숙박 시설 검색 결과에 충분한 숙박 시설이 포함될 수 있습니다. 폴리곤이 아닌 단일 좌표(예: 관광명소)로 표시되는 지역 유형의 경우 이러한 확장된 옵션을 사용해야 연관된 숙박 시설 매핑이 제공됩니다.

더 큰 지역 유형(high_level_region, province_state, country, continent)의 경우, 상위 500개까지의 숙박 시설가 반환됩니다. 해당 지역 내 숙박 시설의 전체 목록을 확인하려면, 더 큰 지역을 구성하는 각 하위 항목에 대해 숙박 시설를 요청해야 합니다.

폴리곤은 검색 및 거래 데이터 사용에 최적화되며 가장 관련성이 높은 폴리곤 외부의 더 작은 지역으로 확장됩니다.

API 세부 정보

이 페이지에서 지리 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.

추가 리소스

모든 Rapid API 엔드포인트를 사용해 보거나 OpenAPI 사양 또는 Postman 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.