Aller au contenu

Géolocalisation

Wink utilise largement la géolocalisation pour alimenter la recherche basée sur la localisation, la détection automatique de la devise et de la langue, ainsi que le filtrage géographique de l’inventaire.

Lorsqu’un utilisateur visite la plateforme, Wink détecte automatiquement sa localisation à partir de son adresse IP. Cela permet :

  • Sélection automatique de la devise — Afficher les prix dans la devise locale de l’utilisateur.
  • Préférence de langue — Suggérer du contenu dans la langue probable de l’utilisateur.
  • Résultats à proximité — Prioriser l’inventaire proche de la localisation de l’utilisateur.

Wink prend en charge la recherche géographique en utilisant quatre types de requêtes spatiales. Ceux-ci alimentent la recherche basée sur la carte, la recherche par rayon et le filtrage par zone sur toute la plateforme.

Une coordonnée géographique unique (latitude, longitude). Utilisée pour marquer un emplacement spécifique — par exemple, l’adresse d’un bien ou la position actuelle d’un utilisateur.

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

Un point central avec un rayon. Utilisé pour les requêtes « rechercher près de moi » ou basées sur un rayon — par exemple, « hôtels dans un rayon de 10 km de Times Square ».

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

Une boîte englobante définie par les coins sud-ouest et nord-est. Utilisée pour la recherche basée sur la carte — lorsqu’un utilisateur déplace et zoome sur une carte, la zone visible définit une requête rectangulaire.

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

Une forme personnalisée définie par une série de points. Utilisée pour rechercher à l’intérieur de limites géographiques irrégulières — par exemple, un quartier, un arrondissement ou une zone dessinée manuellement sur une carte.

{
"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 }
]
}
}
Cas d’utilisationType de formeExemple
Recherche près de moiCercleHôtels dans un rayon de 5 km de ma position
Recherche dans la zone visible de la carteRectangleBiens visibles dans la vue actuelle de la carte
Recherche dans un quartierPolygoneHôtels dans un arrondissement spécifique
Localisation d’un bienPointEmplacement exact d’une annonce immobilière

Les paramètres de requête spatiale sont acceptés par les points de terminaison Lookup API et Inventory API. Passez la forme GeoJSON appropriée dans votre requête de recherche pour filtrer les résultats par localisation.

Consultez la documentation des APIs pour les détails spécifiques à chaque point de terminaison.