ヘッダーとパラメーター 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