Перейти до вмісту

Геолокація

Wink широко використовує геолокацію для пошуку за місцем розташування, автоматичного визначення валюти та мови, а також географічного фільтрування інвентарю.

Коли користувач заходить на платформу, 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 для деталей по конкретних кінцевих точках.