ジオフェンスに対してデバイスの位置を評価する

ジオフェンスに対して位置を評価してジオフェンスイベントを生成する方法は 2 つあります。

• トラッカーとジオフェンスコレクションをリンクできます。詳細については、「トラッカーをジオフェンスコレクションにリンクする」セクションを参照してください。

• ジオフェンスコレクションリソースに直接リクエストして、1 つ以上の位置を評価できます。

デバイスの位置履歴を追跡したり、地図上に位置を表示したりしたい場合は、トラッカーをジオフェンスコレクションとリンクしてください。あるいは、位置情報の更新をすべて評価したくない、または、位置データをトラッカーリソースに保存したくない場合もあるかもしれません。どちらかに当てはまる場合は、ジオフェンスコレクションに直接リクエストして、ジオフェンスに対して 1 つ以上のデバイスの位置を評価できます。

ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。これらのイベントに反応し、他の AWS サービスにルーティングできます。ジオフェンスイベントを受信する際に実行できるアクションの詳細については、「Amazon での Amazon Location Service イベントへの対応 EventBridge」を参照してください。

Amazon Location イベントには、そのイベントを生成するデバイス位置更新の属性 (タイムスタンプ、位置、精度、キーと値のペアから成るメタデータ、出入りしたジオフェンスの属性の一部など) が含まれます。ジオフェンスイベントに含まれるデータについては、「Amazon Location Service の Amazon EventBridge イベントの例」を参照してください。

次の例では、AWS CLI、または Amazon Location API を使用しています。

API

Amazon Location API を使用して、デバイスの位置とジオフェンスの位置を比較して評価するには

Amazon Location Geofences API の BatchEvaluateGeofences オペレーションを使用してください。

次の例では、API リクエストを使用して、関連付けられたジオフェンスコレクション ExampleDevice へのデバイスの位置を評価しますExampleGeofenceCollection。これらの値は、独自のジオフェンスとデバイス ID に置き換えてください。

POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json

{
   "DevicePositionUpdates": [ 
      { 
         "DeviceId": "ExampleDevice",
         "Position": [-123.123, 47.123],
         "SampleTime": "2021-11-30T21:47:25.149Z",
         "Accuracy": {
            "Horizontal": 10.30
         },
         "PositionProperties": {
            "field1": "value1",
            "field2": "value2"
         }
      }
   ]
}

AWS CLI

AWS CLI コマンドを使用して、デバイスの位置とジオフェンスの位置を比較して評価するには

batch-evaluate-geofencesコマンドを実行します。

次の例ではAWS CLI、 を使用して、関連付けられたジオフェンスコレクション ExampleDeviceに対して の位置を評価しますExampleGeofenceCollection。これらの値は、独自のジオフェンスとデバイス ID に置き換えてください。

aws location \
    batch-evaluate-geofences \
        --collection-name ExampleGeofenceCollection \
        --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'