Méthode de GET qui vous permet de requête des points d’intérêt les plus proches de l’appelant.
GET https://query.places.adobe.com/placesedgequery
Avec l’entrée suivante, le service renvoie une liste des points d’intérêt les plus proches de l’appelant :
Position de l’appelant (latitude, longitude).
Identifiants des bibliothèques d’API à inclure dans la recherche.
Nombre maximal de points d’intérêt à renvoyer. La valeur par défaut est 100.
La distance entre l’appelant et l’IPE est définie comme la distance entre l’appelant et le bord de la géofence de l’IPE. Dans la réponse, les points d’intérêt qui contiennent l’appelant sont marqués comme ayant l’appelant.
Les arguments sont fournis en tant que paramètres de requête suivants :
(Obligatoire) latitude
La latitude de l'appelant, qui doit être comprise entre -85 et 85.
(Obligatoire) longitude
La longitude de l’appelant, qui doit être comprise entre -180 et 180.
(Facultatif) limit
Nombre maximal de points d’intérêt à renvoyer.
(Obligatoire) library
ID de la bibliothèque à requête. Pour requête à plusieurs bibliothèques, veillez à inclure plusieurs copies du paramètre de bibliothèque dans la requête.
Voici un exemple du format JSON renvoyé avec succès :
{
"places": {
"userWithin": [
{
"p": [
"poi id",
"poi name",
"poi center's latitude",
"poi center's longitude",
poiRadius,
rank
],
"x": {
"country": "US",
"city": "Fremont",
"street": "Vineyard Heights",
"Color": "Blue",
"state": "CA",
<other POI metadata>
}
}
],
"pois": [
{
"p": [
"poi id",
"poi name",
"poi center's latitude",
"poi center's longitude",
poiRadius,
rank
],
"x": {
"country": "US",
"city": "Milpitas",
"street": null,
"state": "CA"
}
},
{
"p": [
"poi id",
"poi name",
"poi center's latitude",
"poi center's longitude",
poiRadius,
rank
],
"x": {
"country": "US",
"city": "Fremont",
"street": null,
"state": "CA"
}
}
]
}
}
Les points d’intérêt sous places.pois
sont triés par distance entre l’appelant et le bord des points d’intérêt. Les points d’intérêt sous places.userWithin
contiennent l’appelant et ces points d’intérêt sont classés par rang puis par rayon croissant.
Voici un exemple de cet appel :
GET https://query.places.adobe.com/placesedgequery?latitude=<userLatitude>&longitude=<userLongitude>&library=<libID1>&library=<libID2>&limit=20