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

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

トラッカーとジオフェンスコレクションをリンクできます。詳細については、「トラッカーをジオフェンスコレクションにリンクする」セクションを参照してください。
BatchEvaluateGeofences API を使用して、ジオフェンスコレクションリソースに直接リクエストして、1 つ以上の位置を評価できます。

さらに、ジオフェンス内でデバイスが入ってくる、終了する、またはアイドル状態のままの受信ジオフェンスイベントを予測できます。ForecastGeofenceEvents API を使用してイベントを予測します。

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

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

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

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

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"}}]'

ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。従来、を使用してイベントに反応することはできますがAmazon EventBridge、このプロセスでは、イベントが発生した後にのみイベントに反応できます。例えば、デバイスが境界を越えていて、その結果として別の規制の対象となる場合など、デバイスがジオフェンスに出入りするタイミングを予測する必要がある場合は、 ForecastGeofenceEvents API を使用して将来のジオフェンスイベントを予測できます。

ForecastGeofenceEvents API は、デバイスの time-to-breach、近接性、速度、位置などの基準を使用してイベントを予測します。この API は ForecastedBreachTime、ジオフェンスイベントが発生する推定時間を示すを返します。

次の例では、Amazon Location APIsを使用します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ステップ 3: トラッカーをジオフェンスコレクションにリンクする

デバイスの位置を確認する