ジオロケーション

Winkはジオロケーションを広範囲に活用し、位置情報に基づく検索、自動通貨と言語の検出、地理的な在庫フィルタリングを実現しています。

GeoIP検出

ユーザーがプラットフォームを訪れると、WinkはIPアドレスに基づいて自動的に位置を検出します。これにより以下が可能になります：

自動通貨選択 — ユーザーの現地通貨で価格を表示。
言語の優先設定 — ユーザーの可能性が高い言語でコンテンツを提案。
近隣の結果 — ユーザーの位置に近い在庫を優先表示。

空間検索

Winkは4種類の空間クエリタイプを使った地理的検索をサポートしています。これにより、プラットフォーム全体で地図ベースの検索、半径検索、エリアベースのフィルタリングが可能です。

ポイント

単一の地理座標（緯度、経度）。特定の場所を示すために使われます — 例えば、物件の住所やユーザーの現在地。

{
  "point": {
    "x": -73.9857,
    "y": 40.7484
  }
}

サークル

中心点と半径。「近くで検索」や半径ベースのクエリに使われます — 例えば、「タイムズスクエアから10km以内のホテル」。

{
  "point": {
    "x": -73.9857,
    "y": 40.7484
  },
  "radius": 10000
}

レクタングル

南西と北東の角で定義される境界ボックス。地図ベースの検索に使われます — ユーザーが地図をパンやズームしたとき、表示されている範囲がレクタングルクエリを定義します。

{
  "southWest": {
    "x": -74.0060,
    "y": 40.7128
  },
  "northEast": {
    "x": -73.9350,
    "y": 40.7831
  }
}

ポリゴン

一連のポイントで定義されるカスタム形状。不規則な地理的境界内の検索に使われます — 例えば、特定の近隣、都市区画、地図上でカスタムに描いたエリア。

{
  "polygon": {
    "points": [
      { "x": -74.0060, "y": 40.7128 },
      { "x": -73.9350, "y": 40.7128 },
      { "x": -73.9350, "y": 40.7831 },
      { "x": -74.0060, "y": 40.7831 },
      { "x": -74.0060, "y": 40.7128 }
    ]
  }
}

ユースケース

ユースケース	形状タイプ	例
近くで検索	サークル	自分の位置から5km以内のホテル
地図の表示範囲検索	レクタングル	現在の地図ビューに表示されている物件
近隣検索	ポリゴン	特定の都市区画内のホテル
物件の位置	ポイント	物件リスティングの正確な位置

開発者向け

空間クエリパラメータはLookup APIおよびInventory APIのエンドポイントで受け付けられます。検索リクエストに適切なGeoJSON形状を渡して、位置による結果のフィルタリングを行ってください。

エンドポイント固有の詳細はAPIsドキュメントをご覧ください。

さらに読む

検索（Booking Engine） — 旅行者が在庫を検索する方法。
地図（Studio） — 地図ベースの在庫発見。
APIs — 完全なAPIリファレンス。