查询API

一种GET方法,允许您查询最接近呼叫者的POI。

请求

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

通过以下输入,服务返回最接近呼叫者的POI的列表:

  • 呼叫者的位置(经纬度)。

  • 要包含在搜索中的POI库的ID。

  • 要返回的最大POI数。 默认值为 100。

    呼叫者与POI之间的距离定义为从呼叫者到POI地序边缘的距离。 在响应中,包含呼叫者的POI将被标记为有呼叫者。

参数作为以下查询参数提供:

  • (Required) latitude

    呼叫者的纬度,必须介于-85和85之间。

  • (Required) longitude

    调用者的经度,必须介于-180和180之间。

  • (可选) limit

    要返回的最大POI数。

  • (Required) 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"
                }
            }
        ]
    }
}

下面的 places.pois POI按呼叫者到POI边缘的距离排序。 下的POI places.userWithin 包含调用者,这些POI按排名排序,然后按增加radius排序。

示例调用

以下是调用的示例:

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

On this page

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