API de requête

Méthode de GET qui vous permet de requête des points d’intérêt les plus proches de l’appelant.

Requête

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.

Exemple d’appel

Voici un exemple de cet appel :

GET https://query.places.adobe.com/placesedgequery?latitude=<userLatitude>&longitude=<userLongitude>&library=<libID1>&library=<libID2>&limit=20

Sur cette page