地理定位

Wink 廣泛使用地理定位來驅動基於位置的搜尋、自動貨幣與語言偵測，以及地理庫存過濾。

GeoIP 偵測

當使用者造訪平台時，Wink 會根據其 IP 位址自動偵測其位置。這可實現：

自動貨幣選擇 — 以使用者當地貨幣顯示價格。
語言偏好 — 建議使用者可能的語言內容。
附近結果 — 優先顯示接近使用者位置的庫存。

空間搜尋

Wink 支援使用四種空間查詢類型的地理搜尋。這些驅動平台上的地圖搜尋、半徑搜尋和區域過濾。

點

單一地理座標（緯度、經度）。用於標記特定位置 — 例如，物業地址或使用者當前位置。

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

圓

中心點加半徑。用於「搜尋我附近」或基於半徑的查詢 — 例如，「時代廣場 10 公里內的飯店」。

{
  "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 }
    ]
  }
}

使用案例

使用案例	形狀類型	範例
搜尋我附近	圓	我位置 5 公里內的飯店
地圖視窗搜尋	矩形	目前地圖視圖中可見的物業
社區搜尋	多邊形	特定城市區域的飯店
物業位置	點	物業列表的精確位置

給開發者

空間查詢參數可由 Lookup API 和 Inventory API 端點接受。在搜尋請求中傳遞適當的 GeoJSON 形狀，以依位置過濾結果。

詳見 APIs documentation 了解端點特定細節。