쿼리 API

호출자와 가장 가까운 POI를 쿼리할 수 있는 GET 메서드입니다.

요청

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

다음 입력과 함께 서비스는 호출자와 가장 가까운 POI 목록을 반환합니다.

  • 호출자의 위치(위도, 경도).

  • 검색에 포함할 POI 라이브러리의 ID입니다.

  • 반환할 최대 POI 수입니다. 기본값은 100입니다.

    발신자와 POI 사이의 거리는 발신자에서 POI의 지점까지의 거리로 정의됩니다. 응답에서 발신자가 포함된 POI는 발신자가 있는 것으로 표시됩니다.

인수는 다음 쿼리 매개 변수로 제공됩니다.

  • (필수 여부) latitude

    발신자의 위도입니다. 위도는 -85에서 85 사이여야 합니다.

  • (필수 여부) longitude

    호출자의 경도를 -180에서 180 사이여야 합니다.

  • (선택 사항입니다) limit

    반환할 최대 POI 수입니다.

  • (필수 여부) library

    쿼리할 라이브러리의 ID입니다. 여러 라이브러리를 쿼리하려면 쿼리에 라이브러리 매개 변수의 복사본을 여러 개 포함해야 합니다.

다음은 성공적으로 반환된 JSON 형식의 예입니다.

{
    "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는 발신자에서 POI의 가장자리까지 거리에 따라 정렬됩니다. places.pois POI에 발신자가 포함되어 있고 이 POI는 등급별로 정렬된 다음 반경을 늘립니다. places.userWithin

샘플 호출

다음은 콜의 예입니다.

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

이 페이지에서는