クエリ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"
                }
            }
        ]
    }
}

places.poisの下のPOIは、発信者からPOIの端までの距離で並べ替えられます。 places.userWithinの下のPOIには呼び出し元が含まれ、これらのPOIはランク順に並べられ、その後半径が大きくなります。

サンプル呼び出し

呼び出しの例を次に示します。

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

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
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