ヘッダーとパラメーター headers-and-parameters
Places Service REST API で使用できるヘッダーとパラメーターの詳細は次のとおりです。
サポートされるヘッダー
ヘッダー
説明
メソッド
例
Authorization
ベアラートークン
すべて
x-api-key
API キー
すべて
19776964b4cde49e08d8f62e5824f777b
x-gw-ims-org-id
組織 ID
すべて
18FB61145BAC2FFB0A494777@AdobeOrg
Content-Type
送受信するコンテンツの形式
PUT、POST
application/json
Accept-Language
エラーメッセージに使用する言語
オプション
en-US
ライブラリパラメーター
パラメーター
説明
タイプ
上限
リクエストまたは応答
例
id
ライブラリの ID
割り当て
該当なし
応答
"id": "b2488788-2d2a-462b-b1a2-305272777dda"
name
ライブラリの名前
文字列
256 文字
両方、リクエストで必須
"name": "Amazing Places"
orgID
組織の Experience Cloud 組織 ID
割り当て
該当なし
応答
"orgID": "777F20F55BACA09E0A495D8F@AdobeOrg"
poiCount
ライブラリ内の POI 数
整数
最大 150,000
応答
"poiCount": 25149
metadataDescriptors
一意の POI メタデータキーと値のペアごとのカウント
mixed
該当なし
応答
poiCountInCities
一意の POI 市区町村の値ごとのカウント
mixed
該当なし
応答
POI パラメーター
パラメーター
説明
タイプ
上限
リクエストまたは応答
例
data
Poi データ
POI の詳細の配列
該当なし
両方
id
POI の ID
割り当て
該当なし
response
"id": "1455462b-7f9c-4220-9f42-5bbce777a0d1"
name
POI の名前
文字列
512 文字
両方、オプション*
"name": "My Favorite Place"
description
POI の説明
文字列
512 文字
両方、オプション*
"description": "This is a very good place."
location
POI のタイプと座標の配列
配列(混在)
該当なし
両方
"location": {"type": "Point", "coordinates": [-122.201007, 37.604713]
type
POI のタイプ
文字列
現在「ポイント」のみがサポートされています
両方、リクエストで必須
"type": "Point"
coordinates
POI の経度と緯度の配列
配列(浮動小数)
経度:-180 ~ 180、緯度–85 ~ 85
両方、リクエストで必須
"coordinates": [-122.201007, 37.604713]
radius
POI の周囲の円形ジオフェンスのサイズ
float
10~2000 メートル
両方、リクエストで必須
"radius": 100
country
POI の国
文字列
32 文字
両方、オプション*
"country": "United States"
state
POI の状態
文字列
32 文字
両方、オプション*
"state": "California"
city
POI の都市
文字列
32 文字
両方、オプション*
"city": "San Jose"
street
POI の住所
文字列
256 文字
両方、オプション*
"street": "122 Woz Way"
category
POI のカテゴリ
文字列
100 文字
両方、オプション*
"category": "cafe"
icon
POI 用のアイコン
文字列
50 文字
両方、オプション*
"icon": "star"
color
POI の色
文字列
8 文字
両方、オプション*
"color": "blue"
metadata
POI のキーと値のペアの配列
array (string)
キー:256 文字、値:256 文字、最大 10 ペア
両方、オプション*
"metadata": {"region": "Equator"}
lib_id
POI があるライブラリの ID
該当なし
該当なし
両方、必須
"lib_id": "ac7a0b25-c6c2-43ba-bbc6-2b1777b80fe9"
- パラメーター値が含まれていない場合、その値はデータベースで
empty
に設定されます。 既存のキーと値のペアが含まれていない場合は、その POI のキーと値のペアがデータベースから削除されます。
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825