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

親ページで説明されているアプリケーションを使用すると、エンドユーザーは場所カテゴリー700-7600-0322に関連付けられたアイコンをタップすることで、近くの5つの電気自動車充電所を取得できます。

例：Browse Request

エンドユーザーが位置(52.5044,13.33673)のアイコンをタップすると、アプリケーションは次のようなリクエストを送信します。

curl -sD /dev/stderr "https://browse.search.hereapi.com/v1/browse?apiKey=$API_KEY
&at=52.5044,13.33673
&limit=5
&categories=700-7600-0322"
| jq .

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

HTTP/1.1 200 OK
X-Correlation-ID: 26ff9c58-37b3-4a08-bc4e-a533a5ce3a15
(...)

{
  "items": [
    {
      "title": "chargecloud",
      "id": "here:pds:place:276u336xmvebu-aGVyZS1ldjpodWJqZWN0OjU5Mzc1ODE1Mg",
      "access": [{ "lat": 52.50286, "lng": 13.3339 }],
      ...
    },
    {
      "title": "E.ON",
      "id": "here:pds:place:276u336xtfpme-aGVyZS1ldjppbm5vZ3k6NTg3NzU5MjY1",
      "access": [{ "lat": 52.50363, "lng": 13.3399 }],
      ...

    },
    {
      "title": "E.ON",
      "id": "here:pds:place:276u336xmwd3s-aGVyZS1ldjppbm5vZ3k6NTkzNzMwNzgx",
      "access": [{ "lat": 52.50143, "lng": 13.33552 }],
      ...
    },
    {
      "title": "Compleo",
      "id": "here:pds:place:276u336xmw7yv-aGVyZS1ldjplY29tb3ZlbWVudDo1OTM3NzE4NTM",
      "access": [{ "lat": 52.50143, "lng": 13.33552 }],
      ...
    },
    {
      "title": "chargecloud",
      "id": "here:pds:place:276u336xqtkzk-aGVyZS1ldjpodWJqZWN0OjU5MDExNzE1MA",
      "access": [{ "lat": 52.50742, "lng": 13.334 }],
      ...
    ]
}

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

例：Browse結果でのユーザーアクション

エンドユーザーが2番目の結果(E.ONの充電ステーション)を選択し、2022年12月03日土曜日の7時56分(CET)にナビゲーションを開始すると、アプリケーションは次の手順を実行します。

実行されたアクションとともに、前のレスポンスから必要な属性を収集します。

フィールド値
timestamp 1670050588832
correlationId 26ff9c58-37b3-4a08-bc4e-a533a5ce3a15
resourceId here:pds:place:276u336xtfpme-aGVyZS1ldjppbm5vZ3k6NTg3NzU5MjY1
rank 1
action here:gs:action:navigate-to

フィールド	値
`timestamp`	`1670050588832`
`correlationId`	`26ff9c58-37b3-4a08-bc4e-a533a5ce3a15`
`resourceId`	`here:pds:place:276u336xtfpme-aGVyZS1ldjppbm5vZ3k6NTg3NzU5MjY1`
`rank`	`1`
`action`	`here:gs:action:navigate-to`

次のような/signalsリクエストを送信します。

curl -sXPOST "https://signals.search.hereapi.com/v1/signals?apiKey=$API_KEY" -d @- << EOF
version=1
&timestamp=1670050588832
&resourceId=here:pds:place:276u336xtfpme-aGVyZS1ldjppbm5vZ3k6NTg3NzU5MjY1
&correlationId=26ff9c58-37b3-4a08-bc4e-a533a5ce3a15
&rank=1
&action=here:gs:action:navigate-to
EOF

/browseエンドポイントの概要については、「Browse」を参照してください。

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