EPS Rapid 地域

地域

指定されたパラメータに一致する地域の地理的定義と施設マッピングを返します。

世界中のすべての地域をリクエストするには、ancestor クエリーパラメータを省略します。特定の大陸、国、または他のレベルの地域全体をリクエストするには、その地域の ID を ancestor として指定します。上位地域のリストを参照してください。

地域

リクエストした地域 ID の地理的定義と施設マッピングを返します。

この API を使用して、既知の地域 ID の地理的情報と施設マッピングを取得します。

地理的定義に含まれる施設を取得

地理的定義に基づいてカスタムポリゴン内の EPS 施設を返します。

独自の地理的定義を保持しており、EPS の地理的地域を使用していない場合は、この API を使用して施設マッピングデータベースを構築します。多都市、都市、周辺地域のような領域の地理的定義に施設を簡単にマッピングできます。

地域タイプ

このタイプのオブジェクトは、都市や周辺地域などの地理エンティティを表します。詳細については地域タイプのリストを参照してください。

ローカリゼーション

language オブジェクトでは、ハイフンでつながった一対の 2 桁の言語と国のコードのみを使用できます。詳細については、パラメータ入力の項を参照してください。コードを使用する前にサポート対象言語を確認してください。応答に含まれる name フィールドと name_full フィールドのみが、リクエストした言語で表示されます。応答に含まれるこれ以外の地理的定義は英語で表示されます。

ポリゴン

bounding_polygon オブジェクトには地域の形状を表す座標のリストが含まれています。地域は 1 つのポリゴンまたは複数のポリゴンのいずれかで表される領域をカバーできます。1 つの座標で表される地域タイプ (観光スポット、鉄道の駅、空港など) には境界ポリゴンがありません。座標のリストを表示する際、bounding_polygon オブジェクトでは、GeoJSON 規格に従い、経度、緯度の順に表示します。

地域間の関連

地域間の観光関係は、関連するオブジェクトを用いて示されます。関連するオブジェクト内、モデルにするもの :

• 空港タイプの地域の関連する都市。これにより、特定の空港の目的地を推奨できます。
• 指定の地域の上位観光スポット。これにより、旅行者がカリフォルニア、ロンドン、ブルックリンなどの特定の地域を訪問しているときに、訪問する観光スポットを推奨できます。

地域間の階層

地域間の関係は、ancestors オブジェクトと descendants オブジェクトを用いて示されます。世界中で起きる地理学的変動や政治上の変動のため、地域タイプに確固とした階層があるわけではありません。ただし、論理的には、通常 1 つの市は、多都市、省 / 州、郡などに付随しています。特定の地域の階層を知るには、ancestors 値を使用します。

• ancestors は、指定の地域よりも上のレベルの階層を表します。たとえば、ギリシャの多都市、アテネの直接の祖先はアッティカ地方で、さらに階層を遡るとギリシャやヨーロッパになります。複数の親を持つ地域もあります。多都市ジュネーブはスイスとフランスの国境にあるため、両方の国が祖先となります。
• descendants は、指定の地域よりも下のレベルの階層を表します。上記を例にとると、ギリシャの都市ピレウスはギリシャの多都市アテネの子孫となります。地域オブジェクト内の子孫地図にはその地域の直接の子 (1 つ下のレベル) のみが記載されます。

地域の施設マッピング

施設マッピングは、Region API と Regions API で提供されています。施設マッピングのある地域タイプは、high_level_region、state_province、multi_city_vicinity、city、neighborhood、point_of_interest、および select countries です。施設マッピングを利用する場合、以下の 2 つの include パラメータオプションがあります。

• property_ids : このオプションでは地域のポリゴン内の施設のみが表示されます。ポリゴンは閉じた形状で、地域の領域を表します。
• property_ids_expanded : 地域のポリゴンに含まれる施設が 100 未満の場合、このオプションではポリゴン内の施設に加え、この地域から半径 30 km 以内の施設も表示されます。このように施設群が拡張されることで、目的地の施設検索結果に十分な数の施設が表示されるようになります。ポリゴンでなく 1 つの座標で示される地域タイプ (観光スポットなど) では、該当地域に関連する施設マッピングを表示できるのはこの拡張オプションのみです。

ポリゴンは、検索データとトランザクションデータを使用するように最適化されており、最も関連性の高いポリゴンの外側の小さな領域に拡張します。

データベースの推奨事項

コンテンツデータベースの設定のガイドラインについては、地理データベースの推奨事項を参照してください。