Přeskočit na obsah

Geolokace

Wink rozsáhle využívá geolokaci k podpoře vyhledávání podle polohy, automatické detekci měny a jazyka a geografickému filtrování inventáře.

Když uživatel navštíví platformu, Wink automaticky detekuje jeho polohu na základě IP adresy. To umožňuje:

  • Automatický výběr měny — Zobrazovat ceny v místní měně uživatele.
  • Preferovaný jazyk — Navrhnout obsah v pravděpodobném jazyce uživatele.
  • Výsledky v okolí — Upřednostnit inventář blízko uživatelovy polohy.

Wink podporuje geografické vyhledávání pomocí čtyř typů prostorových dotazů. Tyto typy pohánějí vyhledávání na mapě, vyhledávání v okruhu a filtrování podle oblasti napříč platformou.

Jedna geografická souřadnice (zeměpisná šířka, délka). Používá se k označení konkrétního místa — například adresy nemovitosti nebo aktuální polohy uživatele.

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

Středový bod s poloměrem. Používá se pro dotazy „vyhledat poblíž mě“ nebo vyhledávání v okruhu — například „hotely do 10 km od Times Square.“

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

Ohraničující rámeček definovaný jihozápadním a severovýchodním rohem. Používá se pro vyhledávání na mapě — když uživatel posouvá a přibližuje mapu, viditelná oblast definuje dotaz obdélníku.

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

Vlastní tvar definovaný řadou bodů. Používá se pro vyhledávání v nepravidelných geografických hranicích — například čtvrť, městská část nebo vlastní nakreslená oblast na mapě.

{
"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 }
]
}
}
PoužitíTyp tvaruPříklad
Vyhledávání poblíž měKruhHotely do 5 km od mé polohy
Vyhledávání v zobrazení mapyObdélníkNemovitosti viditelné v aktuálním zobrazení mapy
Vyhledávání v čtvrtiPolygonHotely v konkrétní městské části
Poloha nemovitostiBodPřesná poloha nabídky nemovitosti

Parametry prostorových dotazů jsou akceptovány koncovými body Lookup API a Inventory API. Předávejte odpovídající GeoJSON tvar ve vašem vyhledávacím požadavku pro filtrování výsledků podle polohy.

Podívejte se na dokumentaci API pro podrobnosti specifické pro jednotlivé koncové body.