地理情報
施設 および60万以上の地域にある空港の所在地にアクセスできます
Rapid Geography APIでは、60万以上の地域および空港に関する地理的定義や 施設 マッピングにアクセスすることができます。これには、Rapid APIの実装で活用できる複 数の子APIが含まれています。
Regions API
検索に使用する特定のリージョンIDがわからない場合は、Regions APIを使用して、指定されたパラメータに一致するリージョンの地理的定義と 施設 へのマッピングを確認してください。世界中のすべての地域をリクエストするには、ancestor クエリーパラメータを省略します。祖先地域IDを指定すると、このAPIは特定の大陸、国、またはその他のレベルに属するすべての地域を返します。
Region API
検索したい地域IDがわかっている場合は、Region APIを使用して、その地域の地理的定義と 施設 へのマッピングを取得してください。
Polygon API
このAPIは、指定された地理的定義に基づいて、カスタムポリゴン内のプロパティを返します。独自の地理定義を管理しており、Rapid APIの地理リージョンを使用していない場合は、これを使用して施設のマッピングデータベースを構築してください。複数 都市、都市、周辺地域のような領域の地理的定義に施設を簡単にマッピングできます。
その他の参考情報
地域タイプ
「type」フィールドには、都市や地区など、表される地理的実体について説明が記載されています。詳細については、地域タイプのリストを参照してください。
エリア
areaパラメータを使用すると、半径（キロメートル単位）と、中心の緯度・経度の座標、または領域の境界のいずれかを指定することができます。
- Radius と
region_idを組み合わせると、地域の境界から指定したキロメートル数だけすべての方向に広がるエリアを検索することになります。 - 緯度 / 経度のペアで指定した 1 点に半径を組み合わせると、指定したキロメートル半径の円を描くようにエリアが検索されます。
- 半径は、負ではない整数のキロメートルで指定する必要があります。小数点以下の数字があるとエラーになります。半径 0 は許容されます。
制限事項
- エリアパラメーターを指定する場合、結果は 100 件までに制限されますが、制限パラメーターでさらに絞り込むことができます。
- 結果数が多いため、
point_of_interestが唯一のtypeとして指定されない限り、タイプがpoint_of_interestの地域はareaに絞り込まれるリクエストに含まれません。 point_of_interestが他のタイプとともに指定された場合、point_of_interestは無視され (エラーは発 生しない)、他のすべてのtypeの選択が適用されます。
**例 : **
緯度 / 経度の 50 km 以内の空港の検索 :
type=airport&limit=3&area=50,37.227924,93.3100363km 圏内と 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 オブジェクトには地域の形状を表す座標のリストが含まれています。地域は 1 つのポリゴンまたは複数のポリゴンのいずれかで表される領域をカバーできます。単一の座標で表されるエリアタイプ（観光スポット、鉄道駅、空港など）には、境界ポリゴンは存在しません。
bounding_polygonオブジェクトは、座標のリストを指定する際、経度の値を最初に、その後に緯度の値を記載するというGeoJSON標準に準拠しています。
注： のRapid Lodging APIは、8 KBのペイロードに対応しており、最大2,000個の座標を格納できます。
地域間の関連
地域間の観光関係は、associations オブジェクトを用いて示されます。associations オブジェクト内、モデルにするもの :
- 空港タイプの地域の関連する都市。これにより、特定の空港の目的地を推奨できます。
- 特定の地域における主な見どころ。これにより、旅行者がカリフォルニアやロンドン、ブルックリンといった特定の地域を訪れる際に、おすすめのスポットを提案することができます。
地域間の階層
地域間の関係は、ancestors オブジェクトと descendants オブジェクトを用いて示されます。世界中で起きる地理学的変動や政治上の変動のため、地域タイプに確固とした階層があるわけではありません。ただし、論理的には、通常 1 つの市は、複数都市、省、州、郡などに関連付けられています。特定の地域の階層を知るには、ancestors 値を使用します。
ancestors: 指定された地域より上位の階層レベルを表します。たとえば、ギリシャのアテネの複数都市の場合、祖先はアッティカ地方で、さらに階層を遡るとギリシャやヨーロッパになります。複数の親を持つ地域もあります。ジュネーブの複数都市はスイスとフランスの国境にあるため、両方の国が祖先となります。descendants: 指定された地域の下位にある階層レベルを表します。上記を例にとると、ギリシャの都市ピレウスはギリシャのアテネの複数都市の子孫となります。地域オブジェクト内の子孫地図にはその地域の直接の子 (1 つ下のレベル) のみが記載されます。
地理的特徴に関するより詳細な情報については、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、および一部の国を含む地域タイプに対して提供されています。施設マッピングを利用する場合、以下の 2 つの include パラメータオプションがあり ます。
property_ids: このオプションでは地域のポリゴン内の施設のみが表示されます。ポリゴンは閉じた形状で、地域の領域を表します。property_ids_expanded: 地域のポリゴンに含まれる施設が 100 未満の場合、このオプションではポリゴン内の施設に加え、この地域から半径 30 km 以内の施設も表示されます。このように施設群が拡張されることで、目的地の施設検索結果に十分な数の施設が表示されるようになります。ポリゴンでなく 1 つの座標で示される地域タイプ (観光スポットなど) では、該当地域に関連する施設マッピングを表示できるのはこの拡張オプションのみです。
より大規模な地域タイプ（high_level_region、province_state、country、およびcontinent）については、上位500件までの物件が返されます。これらの地域にある物件の完全なリストを確認するには、その広域地域を構成する各下位地域から、それぞれ物件情報をリクエストする必要があります。
ポリゴンは、検索データとトランザクションデータを使用するように最適化されており、最も関連性の高いポリゴンの外側の小さな領域に拡張します。
API の詳細
このページで地理関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。
その他のリソース
すべての Rapid API エンドポイントを試してみたい場合でも、OpenAPI 仕様や Postman コレクションをダウンロードしたい場合でも、必要なリソースが用意されています。