Геолокация

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-форму в вашем поисковом запросе для фильтрации результатов по местоположению.

Смотрите документацию по API для деталей по конкретным конечным точкам.

Дополнительные материалы

• Поиск (Booking Engine) — Как путешественники ищут инвентарь.
• Карты (Studio) — Обнаружение инвентаря на карте.
• API — Полное описание API.