쿼리 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

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now