Query-API's

Laatst bijgewerkt: 15 juli 2024
  • Onderwerpen:

Een methode van de GET die u toestaat om POIs te vragen die aan de bezoeker het dichtst zijn.

Verzoek

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

Met de volgende input, keert de dienst een lijst van POIs terug die aan de bezoeker het dichtst zijn:

  • De positie van de aanroeper (breedte, lengte).

  • De id's van de POI-bibliotheken die in de zoekopdracht moeten worden opgenomen.

  • Het maximumaantal te retourneren POI's. De standaardwaarde is 100.

    De afstand tussen de bezoeker en POI wordt gedefinieerd als de afstand van de bezoeker tot de rand van de geofence van POI. In de reactie, zal POIs die de bezoeker bevatten duidelijk zijn zoals hebbend de bezoeker.

Argumenten worden opgegeven als de volgende queryparameters:

  • (Vereist) latitude

    De breedtegraad van de aanroeper, die tussen -85 en 85 moet liggen.

  • (Vereist) longitude

    De lengtegraad van de aanroeper, die tussen -180 en 180 moet zijn.

  • (Facultatief) limit

    Het maximumaantal te retourneren POI's.

  • (Vereist) library

    De id van de bibliotheek waarnaar moet worden gezocht. Om veelvoudige bibliotheken te vragen, zorg ervoor dat u veelvoudige exemplaren van de bibliotheekparameter in de vraag omvat.

Hier volgt een voorbeeld van de JSON-indeling die met succes is geretourneerd:

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

POI's onder places.pois worden gesorteerd op afstand van aanroeper tot de rand van de POI's. POI's onder places.userWithin bevatten de aanroeper en deze POI's worden geordend op rang en vervolgens door de straal te verhogen.