Lewati ke konten

Geolokasi

Wink menggunakan geolokasi secara luas untuk mendukung pencarian berbasis lokasi, deteksi otomatis mata uang dan bahasa, serta penyaringan inventaris berdasarkan geografis.

Ketika pengguna mengunjungi platform, Wink secara otomatis mendeteksi lokasi mereka berdasarkan alamat IP. Ini memungkinkan:

  • Pemilihan mata uang otomatis — Menampilkan harga dalam mata uang lokal pengguna.
  • Preferensi bahasa — Menyarankan konten dalam bahasa yang kemungkinan digunakan pengguna.
  • Hasil terdekat — Memprioritaskan inventaris yang dekat dengan lokasi pengguna.

Wink mendukung pencarian geografis menggunakan empat jenis kueri spasial. Ini mendukung pencarian berbasis peta, pencarian radius, dan penyaringan area di seluruh platform.

Satu koordinat geografis (lintang, bujur). Digunakan untuk menandai lokasi spesifik — misalnya, alamat properti atau lokasi pengguna saat ini.

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

Titik pusat dengan radius. Digunakan untuk kueri “cari di dekat saya” atau berbasis radius — misalnya, “hotel dalam radius 10 km dari Times Square.”

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

Kotak pembatas yang didefinisikan oleh sudut barat daya dan timur laut. Digunakan untuk pencarian berbasis peta — saat pengguna menggeser dan memperbesar peta, area yang terlihat mendefinisikan kueri persegi panjang.

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

Bentuk khusus yang didefinisikan oleh serangkaian titik. Digunakan untuk pencarian dalam batas geografis yang tidak beraturan — misalnya, lingkungan, distrik kota, atau area yang digambar khusus di peta.

{
"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 }
]
}
}
Kasus penggunaanJenis bentukContoh
Cari di dekat sayaLingkaranHotel dalam radius 5 km dari lokasi saya
Pencarian tampilan petaPersegi panjangProperti yang terlihat pada tampilan peta saat ini
Pencarian lingkunganPoligonHotel di distrik kota tertentu
Lokasi propertiTitikLokasi tepat dari daftar properti

Parameter kueri spasial diterima oleh endpoint Lookup API dan Inventory API. Kirim bentuk GeoJSON yang sesuai dalam permintaan pencarian Anda untuk memfilter hasil berdasarkan lokasi.

Lihat dokumentasi APIs untuk detail spesifik endpoint.