クエリ 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
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825