İçeriğe geç

Coğrafi Konum

Wink, konuma dayalı arama, otomatik para birimi ve dil tespiti ile coğrafi envanter filtrelemesini sağlamak için coğrafi konumu yaygın şekilde kullanır.

Bir kullanıcı platformu ziyaret ettiğinde, Wink IP adresine dayanarak konumunu otomatik olarak tespit eder. Bu şunları sağlar:

  • Otomatik para birimi seçimi — Fiyatları kullanıcının yerel para biriminde gösterir.
  • Dil tercihi — Kullanıcının muhtemel dilinde içerik önerir.
  • Yakındaki sonuçlar — Kullanıcının konumuna yakın envanteri önceliklendirir.

Wink, dört mekansal sorgu türünü kullanarak coğrafi aramayı destekler. Bunlar, platform genelinde harita tabanlı arama, yarıçap araması ve alan bazlı filtrelemeyi sağlar.

Tek bir coğrafi koordinat (enlem, boylam). Belirli bir konumu işaretlemek için kullanılır — örneğin, bir mülkün adresi veya kullanıcının mevcut konumu.

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

Bir merkez noktası ve yarıçap. “Bana yakın ara” veya yarıçap bazlı sorgular için kullanılır — örneğin, “Times Square’den 10 km içinde oteller.”

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

Güneybatı ve kuzeydoğu köşeleriyle tanımlanan bir sınır kutusu. Harita tabanlı arama için kullanılır — kullanıcı haritayı kaydırıp yakınlaştırdığında, görünen alan bir dikdörtgen sorgusu tanımlar.

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

Bir dizi noktayla tanımlanan özel şekil. Düzensiz coğrafi sınırlar içinde arama yapmak için kullanılır — örneğin, bir mahalle, şehir bölgesi veya harita üzerinde özel çizilmiş bir alan.

{
"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 }
]
}
}
Kullanım durumuŞekil türüÖrnek
Bana yakın araDaireKonumuma 5 km içinde oteller
Harita görünüm alanı aramasıDikdörtgenMevcut harita görünümünde görünen mülkler
Mahalle aramasıÇokgenBelirli bir şehir bölgesindeki oteller
Mülk konumuNoktaBir mülk ilanının tam konumu

Mekansal sorgu parametreleri Lookup API ve Inventory API uç noktaları tarafından kabul edilir. Arama isteğinizde uygun GeoJSON şeklini ileterek sonuçları konuma göre filtreleyin.

Uç nokta özel detaylar için APIs dokümantasyonuna bakın.