翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジオフェンスに対してデバイスの位置を評価する
<a name="evaluate-geofences"></a>

ジオフェンスに対して位置を評価してジオフェンスイベントを生成する方法は 2 つあります。
+ トラッカーとジオフェンスコレクションをリンクできます。詳細については、「[トラッカーをジオフェンスコレクションにリンクする](associate-consumer.md)」セクションを参照してください。
+ ジオフェンスコレクションリソースに直接リクエストして、1 つ以上の位置を評価できます。

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

ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。これらのイベントに反応し、他の AWS サービスにルーティングできます。ジオフェンスイベントを受信した際のアクションの詳細については、「[Amazon EventBridge による Amazon Location Service イベントへの対応](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html)」を参照してください。

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

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

------
#### [ API ]

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

Amazon Location Geofences API の `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` オペレーションを使用してください。

次の例では、API リクエストを使用して、関連するジオフェンスコレクション *ExampleGeofenceCollection* に対するデバイス *ExampleDevice* の位置を評価します。これらの値は、独自のジオフェンスとデバイス 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](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)` コマンドを使用します。

次の例では AWS CLI 、 を使用して、関連するジオフェンスコレクション *ExampleGeofenceCollection* に対して *ExampleDevice* の位置を評価します。これらの値は、独自のジオフェンスとデバイス 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"}}]'
```

------