Lookupレスポンスでのアクション

親ページで説明されているアプリケーションを使用すると、ユーザーは項目idの値を使用してお気に入りの位置を保存および取得できます。

エンドユーザーがお気に入りを1つ選択すると、アプリケーションはブックマークされた位置情報レコードのidを使用して/lookupエンドポイントリクエストを送信します。

たとえば、curlを使用してベルリン・ブランデンブルク空港(ヴィリー・ブラント)の位置情報の詳細を取得する場合は、次のようになります。

curl -sD /dev/stderr "https://lookup.search.hereapi.com/v1/lookup?apiKey=$API_KEY
&id=here:pds:place:276u339g-0dd32a93728c47c3b35985e550f30a70"
| jq .

APIレスポンスは次のようになります。

HTTP/1.1 200 OK
X-Correlation-ID: 62233873-58c5-4cb0-afa0-67aca94a0dff
(...)

{
  "title": "Flughafen Berlin Brandenburg Willy Brandt",
  "id": "here:pds:place:276u339g-0dd32a93728c47c3b35985e550f30a70",
  "access": [{ "lat": 52.36447, "lng": 13.51003 }],
  ...
}

X-Correlation-IDの値はAPIレスポンスごとに一意です。

例：ナビゲーションアクション

ドイツにいるエンドユーザーが2022年12月5日月曜日9時56分(CEST)にこの場所へのナビゲーションを行う場合、アプリケーションは次のようになります。

1. アドホックアクションとともに、前のレスポンスペイロードから必要な属性を収集します。

   フィールド	値
   timestamp	1670230588623
   correlationId	26ff9c58-37b3-4a08-bc4e-a533a5ce3a15
   resourceId	here:pds:place:276u339g-0dd32a93728c47c3b35985e550f30a70
   rank	0
   action	here:gs:action:navigate-to

2. 次のようなリクエストを/signalsエンドポイントに送信します。

   Shell

   curl -sXPOST "https://signals.search.hereapi.com/v1/signals?apiKey=$API_KEY" -d @- << EOF
   version=1
   &timestamp=1670230588623
   &resourceId=here:pds:place:276u339g-0dd32a93728c47c3b35985e550f30a70
   &correlationId=62233873-58c5-4cb0-afa0-67aca94a0dff
   &rank=0
   &action=here:gs:action:navigate-to
   EOF

ナビゲーションアクション

2つの検索結果間でナビゲーションを開始する場合はhere:gs:action:navigate-fromを使用します。

• navigate-fromの行には出発地のresourceIdを含めます。
• 目的地はnavigate-toの行で指定します。

📘

注

/signalsエンドポイントはRESTRICTEDとしてリリースされています。詳細については、機能の成熟度トピックの「特権」セクションを参照してください。