API di query

Un metodo di GET che consente di interrogare i POI più vicini al chiamante.

Richiesta

GET https://query.places.adobe.com/placesedgequery

Con il seguente input, il servizio restituisce un elenco dei POI più vicini al chiamante:

  • Posizione del chiamante (latitudine, longitudine).

  • ID delle librerie POI da includere nella ricerca.

  • Il numero massimo di POI da restituire. Il valore predefinito è 100.

    La distanza tra il chiamante e il POI è definita come la distanza tra il chiamante e il bordo della geofence del POI. Nella risposta, i POI che contengono il chiamante saranno contrassegnati come aventi il chiamante.

Gli argomenti vengono forniti come parametri di query seguenti:

  • (Obbligatorio) latitude

    Latitudine del chiamante, che deve essere compresa tra -85 e 85.

  • (Obbligatorio) longitude

    La longitudine del chiamante, che deve essere compresa tra -180 e 180.

  • (Facoltativo) limit

    Il numero massimo di POI da restituire.

  • (Obbligatorio) library

    ID della libreria da interrogare. Per eseguire query su più librerie, accertatevi di includere più copie del parametro della libreria nella query.

Di seguito è riportato un esempio del formato JSON restituito correttamente:

{
    "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"
                }
            }
        ]
    }
}

I POI sotto places.pois sono ordinati per distanza dal chiamante al bordo dei POI. I POI sotto places.userWithin contengono il chiamante, e questi POI sono ordinati per rango e poi per raggio crescente.

Chiamata di esempio

Esempio di chiamata:

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

In questa pagina