지리

빠른 지리 API는 600,000개 이상의 지역과 공항에 대한 지리적 정의와 숙박 시설 매핑에 액세스할 수 있는 기능을 제공합니다.

복수 지역

지정된 매개변수와 일치하는 지역의 지리적 정의 및 숙박 시설 매핑을 반환합니다.

전 세계 모든 지역을 요청하려면 상위 쿼리 매개변수를 생략합니다. 특정 대륙, 국가 또는 기타 수준의 모든 지역을 요청하려면 해당 지역의 ID를 상위로 지정합니다. 아래의 최상위 수준 지역 목록을 참조해 주세요.

단일 지역

요청된 지역 ID에 대한 지리적 정의 및 숙박 시설 매핑을 반환합니다.

이 API를 사용하여 알려진 지역 ID에 대한 지리적 정보 및 숙박 시설 매핑을 검색할 수 있습니다.

지리 정의 내 숙박 시설 가져오기

지리 정의를 기반으로 한 사용자 지정 폴리곤 내의 숙박 시설을 반환합니다.

자체 지리 정의를 유지하고 Rapid API 지리 지역을 사용하지 않는 경우 이 API를 사용하여 숙박 시설 매핑 데이터베이스를 구축하세요. 여러 도시, 도시 및 주변 등 지역에 대한 지리 정의에 숙박 시설을 쉽게 매핑할 수 있습니다.

검색 필터 매개변수

세 가지 검색 매개변수를 통해 여행자는 검색 결과를 더욱 세밀하게 필터링하고 보다 정확하게 검색할 수 있습니다.

supply_source: 숙박 시설가 익스피디아에서 소싱된 것인지, 아니면 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.310036

3~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객체는 하이픈으로 연결된 two-digit 언어 및 국가 코드 쌍만 사용합니다(사용 가능한 언어 옵션 목록 참조). 코드를 통합하기 전에 지원되는 언어를 검토해 주세요. 응답에서 name 및 name_full 필드만 요청된 언어로 제공됩니다. 응답의 다른 모든 지리 정의는 영어로 표시됩니다.

폴리곤

bounding_polygon 개체는 지역 형태를 포함하는 좌표 목록을 제공합니다. 단일 폴리곤 또는 여러 폴리곤으로 표시되는 영역이 지역에 포함될 수 있습니다. 단일 좌표로 표시되는 지역 유형(예: 관심 지점, 기차역 또는 공항)에는 경계 다각형이 없습니다.

bounding_polygon 개체는 좌표 목록을 제공할 때 경도 값이 먼저 나온 후 위도 값이 나오는 GeoJSON 표준을 따릅니다.

지역 간 연관성

지역 간 여행 관계는 associations 개체를 사용하여 제공됩니다. associations 개체 내에서 다음을 모델링합니다.

공항 유형 지역의 연관 도시. 이를 통해 특정 공항에 대한 목적지를 추천할 수 있습니다.
특정 지역에 대한 상위 관심 지점. 이를 통해 여행자가 캘리포니아, 런던 또는 브루클린과 같은 특정 지역을 방문할 때 방문할 만한 장소를 추천할 수 있습니다.

지역 간 계층

지역 간 관계는 ancestors 및 descendants 개체를 사용하여 제공됩니다. 전 세계의 지리적 및 정치적 변동으로 인해 지역 유형은 엄격한 계층을 포함하지 않습니다. 그러나 논리적으로 볼 때 도시는 대개 여러 도시, 주/도 또는 국가와 연관되어 있습니다. 특정 지역의 계층을 가져오려면 ancestors 값을 사용합니다.

ancestors: 지정된 지역 위의 계층 수준을 나타냅니다. 예를 들어, 여러 도시로 이루어진 그리스 아테네의 바로 위 지역은 아티카 지역이며, 더 올라가면 그리스와 유럽을 포함합니다. 하나의 지역에 여러 상위 지역이 있을 수도 있습니다. 여러 도시로 이루어진 제네바는 스위스와 프랑스의 국경에 위치하기 때문에 두 국가가 모두 상위 지역이 됩니다.
descendants: 지정된 지역 아래의 계층 수준을 나타냅니다. 예를 들어, 그리스 피레우스시는 여러 도시로 이루어진 그리스 아테네의 하위 지역입니다. 한 지역 개체 내의 하위 지역 지도에는 해당 지역의 바로 아래에 있는 하위 지역(한 수준 아래)만 포함됩니다.

지리적 특징에 대한 자세한 정보는 tags및 categories에서 확인할 수 있습니다:

tags: 실제 지형지물의 이름을 반영하는 방식으로 지형지물을 설명하여 보다 세분화된 세부 정보를 제공하세요. 예를 들어, 즐길거리(스키, 경마장 등), 명소, 도심 지역이나 지리적 행정 구역(주, 교구 또는 구역) 같은 설명이 포함됩니다.
categories: 전 세계적으로 적용 가능한 지리적 특징의 계층 구조를 만들고 특정 국가나 지역의 정부 구조에 관계없이 비슷한 지리적 수준을 제공하기 위한 것입니다. 예를 들어, 대륙, 국가 또는 주/도가 있습니다.

참고: 구현에 여러 공급원이 있는 경우 사용하려는 지역에 공급원을 계층화해야 합니다.

예시:

"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]

숙박 시설 매핑은 단일 지역 및 복수 지역 API에 대해 제공됩니다. 숙박 시설 매핑이 있는 지역 유형은 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 컬렉션을 다운로드하려는 경우 다음 사항을 참조해 주세요.