ジオフェンスイベント

ジオフェンスを作成

ジオフェンス には、円形（中心点と半径で指定）、多角形（座標の配列）、またはカスタム POI （ジャンル別施設）を使用できます。

ジオフェンスを作成するに は、geofences エンドポイントにリクエストを送信します。 ユーザーが複数のプロジェクトのメンバーである場合 projectId は、クエリ パラメーター でターゲットプロジェクト ID を指定する必要があります。

curl -X POST \
  'https://tracking.api.here.com/geofences/v2?projectId=`projectId`' \
  -H 'authorization: Bearer {userToken}' \
  -H 'content-type: application/json' \
  -d '{
  "type": "circle",
  "definition":  {
    "center": {
      "lat": 52.521749,
      "lng": 13.413175
    },
    "radius": 150
  }
}'

循環ジオフェンス が作成され、一意のジオフェンス ID が返されます。この時点では、ジオフェンス はどのデバイスにも関連付けられていませんが、アセットトラッキング Web アプリケーションに表示されます。

curl -X GET \
  'https://tracking.api.here.com/geofences/v2?projectId=`projectId`' \
  -H 'authorization: Bearer {userToken}' \
  -H 'content-type: application/json'

これにより、ユーザーが以前に作成したジオフェンスのリストが返されます。

ジオフェンスとデバイスの関連付け

作成したジオフェンス は 、位置データを追跡 API に送信するデバイスに関連付けることができます。これにより 、デバイスがジオフェンス の外部から内部に、またはその逆に遷移するたびにイベントが生成されます。

trackingId は 、ユーザーが請求したデバイスのTracking ID です。

curl -X PUT \
  https://tracking.api.here.com/associations/v3/{trackingId}/geofences/{geofenceId} \
  -H 'authorization: Bearer {userToken}' \
  -H 'content-type: application/json'

テレメトリーを送信

テレメトリーをジオフェンスの外部に送信してから、ジオフェンスの内部に送信します。

注 : タイムスタンプ は、 UNIX のエポック時間（ミリ秒単位）です。

curl -X POST \
  https://tracking.api.here.com/v2/ \
  -H 'authorization: Bearer {deviceToken}' \
  -H 'content-type: application/json' \
  -d '[{
      "timestamp": 1569300623000,
      "position": {
        "alt": 107,
        "accuracy": 13,
        "lat": 52.520806,
        "lng": 13.410514,
        "altaccuracy": 14
      }
}]'

curl -X POST \
  https://tracking.api.here.com/v2/ \
  -H 'authorization: Bearer {deviceToken}' \
  -H 'content-type: application/json' \
  -d '[{
      "timestamp": 1569300814000,
      "position": {
        "alt": 107,
        "accuracy": 10,
        "lat": 52.521880,
        "lng": 13.412724,
        "altaccuracy": 15
      }
}]'

アセットトラッキング Web アプリケーションを使用して、最新のインジェストの場所を確認できます。 HERE が作成されたシナリオはのようになります

イベントが記録されたことを確認

すべてのジオフェンス イベントが記録されます。

curl -X GET \
  https://tracking.api.here.com/events/v3/{trackingId} \
  -H 'authorization: Bearer {userToken}' \
  -H 'content-type: application/json'

これにより、trackingIdによって識別されたデバイスのすべてのイベントが返されます。