翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Location Service Geofences
![\[Amazon Location Service Geofences の概要。\]](http://docs.aws.amazon.com/ja_jp/location/latest/developerguide/images/geofences-overview.png)
ジオフェンスコレクションリソースを使用すると、ジオフェンス (マップ上の仮想境界) を保存および管理できます。ジオフェンスコレクションリソースと照らし合わせて位置を評価し、位置の更新がコレクション内のいずれかのジオフェンスの境界を越えたときに通知を受け取れます。
**ジオフェンスとジオフェンスコレクション**
ジオフェンスとは、マップ上の仮想境界を定義する円、ポリゴンまたはマルチポリゴンのジオメトリです。ジオフェンスコレクションには、ゼロ以上のジオフェンスが含まれています。要求に応じて `ENTER` イベントと `EXIT` イベントを発行して、デバイスの位置をジオフェンスと照合して評価することにより、ジオフェンスを監視できます。
**ジオフェンスイベント**
モニタリングしている位置の場所は、`DeviceId` と呼ばれる ID によって参照されます。位置はデバイス位置と呼ばれます。評価対象のデバイス位置のリストをジオフェンスコレクションリソースに直接送信することも、トラッカーを使用することもできます。トラッカーの使用の詳細については、「[Amazon Location Service トラッカー](trackers.md)」を参照してください。
デバイスが (Amazon EventBridge 経由で) ジオフェンスに出入りしたときにのみイベントを受信します。位置が変わるたびにイベントを受信するわけではありません。つまり、通常はデバイスの位置が更新されるたびに、イベントを受信して対応しなければならない頻度がはるかに少なくなります。
**注記**
特定 `DeviceID` のデバイスの最初の位置評価では、そのデバイスは以前はどのジオフェンスにも存在していなかったと仮定します。そのため、最初の更新では、コレクション内のジオフェンス内にある場合は`ENTER` イベントが生成され、そうでない場合はイベントが生成されません。
デバイスがジオフェンスに出入りしたかどうかを計算するために、Amazon Location Service はデバイスの以前の位置状態を保持する必要があります。この位置状態は 30 日間保存されます。デバイスの更新がない状態が 30 日経過すると、新しい位置情報の更新が最初の位置更新として扱われます。
## Amazon Location Service Geofences のユースケース
Amazon Location Service Geofences の一般的な用途を以下に示します。
**フィールドサービスオペレーションの改善**
リアルタイム追跡でモバイルワークフォースを正確に把握します。お客様のサイトとサービスエリアの周囲にジオフェンスを設定し、スタッフが到着および出発したときにアラートを受信します。位置情報データを使用してスケジューリングを最適化し、最も近い技術者を派遣して、応答時間を短縮します。カスタマーエクスペリエンスを向上させながら、フィールドチーム (水道や HVAC 修理ビジネスなど) がより効率的に作業できるようにします。
**重要なアセットのモニタリングと制御**
Amazon Location Service を使用して、貴重な機器、インベントリ、その他のモバイルアセットのリアルタイムの場所とステータスを追跡します。ジオフェンスを設定して、不正な移動や削除に関するアラートを受信し、セキュリティとコンプライアンスを強化します。この場所の可視性を使用して、アセット使用率を向上させ、メンテナンススケジュールを最適化し、重要なリソースが常に考慮されるようにします。重機、IT ハードウェア、小売りインベントリを常に正確にモニタリングし、損失を減らして、より多くの情報に基づいた運用上の意思決定を行います。
**サプライチェーンの可視性を強化する**
Amazon Location Service を活用して、サプライチェーン全体の出荷と配送を追跡します。配送センター、ストア、その他の主要な施設を中心にジオフェンスを定義して、インベントリとアセットの動きをモニタリングします。リアルタイムの位置情報データを使用して、インベントリ管理を改善し、物流計画を最適化し、優れたカスタマーエクスペリエンスを実現します。サプライチェーンの運用をエンドツーエンドで可視化し、ボトルネックを特定して、効率と応答性を促進するデータ駆動型の意思決定を行います。
**安全性とセキュリティを強化する**
ジオフェンシングを使用すると、安全エリア、制限ゾーン、その他の重要な場所の周囲に仮想境界を設定できます。権限のない担当者またはアセットがこれらの事前定義されたジオフェンスに出入りすると、即時にアラートを受信します。このリアルタイムのロケーションモニタリングを活用して、職場の安全を強化し、侵入を防ぎ、規制コンプライアンスを確保します。製造施設、建設施設、企業キャンパスのいずれを管理する場合でも、ジオフェンスを使って、アクセスをより厳密に制御し、インシデント対応を改善し、人、設備、アセットを保護できます。
**ロケーションベースのマーケティング**
位置情報データの能力を活用して、ジオマーケティングの取り組みを強化します。Amazon Location Service を使用して、競合の場所、イベント、トラフィックの多いエリアの周囲に仮想境界を設定します。お客様がこれらのジオフェンスゾーンに入ると、パーソナライズされた広告、オファー、通知がトリガーされます。人の往来パターンを分析して広告配置を最適化し、新しいビジネスロケーションの主要サイトを発見します。独自のジオフェンススペース内のお客様の動きをモニタリングして、ブラウジング動作と購入するためのパスに関するより深いインサイトを得ることができます。リアルタイムの位置追跡と正確なジオフェンシングを組み合わせることにより、ハイパーターゲットのコンテキストに応じたエンゲージメントを実現し、物理世界の売上とロイヤルティを促進します。
# ジオフェンスの概念
このセクションでは、一般的な用語やジオフェンスの管理方法など、一般的なジオフェンスの概念について説明します。
## Amazon Location Service のジオフェンス用語
ジオフェンス
マップ上の地理的領域の仮想境界。
ジオフェンスコレクション
リクエストに応じて、デバイスの位置をコンポーネントのジオフェンスに対して評価するために、`Entry` イベントおよび `Exit` イベントを出力できるジオフェンスのグループ。
ジオフェンスジオメトリ
ジオフェンスに含める領域またはジオフェンスから除外する領域を定義するジオメトリシェイプまたはジオメトリシェイプのセット。ジオフェンスジオメトリは、`Circle`、`Polygon`、または `MultiPolygon` として表せます。
`Circle` は、周囲に距離がある点です。デバイスが特定の場所から一定の距離内にある場合に通知を受け取りたい場合は、円を使います。
`Polygon` は、ジオフェンスの形状を表す線形リングのリストです。このリストには、*ジオフェンスの外周を表す外周リングを含める必要があり*、オプションで、ジオフェンス領域から除外される、境界内の多角形スペースを表す複数の内周リングを含められます。
`MultiPolygon` は、ジオフェンスの形状を表すリストの `Polygon` 要素です。`MultiPolygon` ジオメトリの `Polygon` コンポーネントは、同じジオフェンスの一部とみなされる個別の地理的領域、ジオフェンスから除外される小さな内部スペースを持つより大きな外部領域の境界、またはこれらのユースケースの何らかの組み合わせを定義して、複雑なジオフェンス境界を形成できます。
構文の要件、制限、例など、ジオフェンスジオメトリの定義の詳細については、「*Amazon Location Service API リファレンス*」の「[GeofenceGeometry](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html)」を参照してください。
# Amazon Location Service Geofences の使用を開始する
ジオフェンスは、地理的境界を定義し、場所の更新に基づいてアクションをトリガーするための強力なツールです。このガイドでは、Amazon Location でジオフェンスコレクションリソースを作成して使用するプロセスについて説明します。ジオフェンスを設定し、ジオフェンスに対して位置を評価することにより、移動をモニタリングし、デバイスが定義されたエリアに出入りしたときの通知などの自動イベントを生成できます。これらの機能は、フリート追跡、ロケーションベースの通知などのアプリケーションに最適です。
1. AWS アカウントにジオフェンスコレクションリソースを作成します。
1. コレクションにジオフェンスを追加します。Amazon Location コンソールのジオフェンスアップロードツールを使用するか、Amazon Location Geofences API を使用できます。使用できるオプションの詳細については、[Amazon Location Service を使用して認証する](access.md)を参照してください。ジオフェンスは、`Circle`、`Polygon`、または `MultiPolygon` として定義できます。`Polygon` または `MultiPolygon` を使用すると、デバイスが特定のエリアに入ったことを判断できます。`Circle` を使用して、デバイスがポイントから特定の距離 (半径) 以内に入ったことを判断します。詳細については、「[Amazon Location Service のジオフェンス用語](https://docs.aws.amazon.com/location/latest/developerguide/geofence-components.html#geofence-terminology)」を参照してください。
1. すべてのジオフェンスに対して位置の評価を開始できます。ロケーションの更新が 1 つ以上のジオフェンスの境界を超えると、ジオフェンスコレクションリソースは Amazon EventBridge で以下のジオフェンスイベントタイプのいずれかを生成します。
+ **ENTER** — 位置情報の更新がその境界を越えるジオフェンスを入力すると、ジオフェンスごとに 1 つのイベントが生成されます。
+ **EXIT** — 位置情報の更新が終了して境界を越えるジオフェンスごとに 1 つのイベントが生成されます。
詳細については、「[Amazon EventBridge を使用して Amazon Location Service イベントに対応する](location-events.md)」を参照してください。また、Amazon CloudWatch や AWS CloudTrail などのサービスを使用して、モニタリングを統合することもできます。詳細については、「[Amazon CloudWatch で を監視する](cloudwatch.md)」および「[によるモニタリングとログ記録 AWS CloudTrail](cloudtrail.md)」を参照してください。
例えば、トラックのフリートを追跡していて、いずれかの倉庫の特定のエリアにトラックが入荷したときに通知を受け取りたい場合などです。各倉庫の周辺にジオフェンスを作成します。トラックから最新の位置情報が送られてきたら、Amazon Location Service を使用してそれらの位置を評価し、トラックがジオフェンスエリアに入った (または出た) かどうかを確認します。
**注記**
料金は、評価対象のジオフェンスコレクションの数によって決まります。請求額は、各コレクション内のジオフェンスの数に影響されません。各ジオフェンスコレクションには最大 50,000 のジオフェンスを含めることができるため、ジオフェンスの評価コストを削減するために、ジオフェンスをできるだけ少ないコレクションにまとめることをお勧めします。生成されるイベントには、コレクション内の個々のジオフェンスの ID とコレクションの ID が含まれます。
# Amazon Location Service Geofences を使用する方法
このセクションでは、Amazon Location でジオフェンス関連のタスクを操作するためのステップバイステップのガイダンスを提供します。ジオフェンスに対してデバイスの位置を評価し、Amazon EventBridge を使用してジオフェンスイベントに応答し、ジオフェンスリソースを効果的に管理する方法について説明します。これらのチュートリアルは、ロケーションベースのイベントを簡単に追跡および管理するための主要な機能を実装するのに役立つように設計されています。
**Topics**
+ [ジオフェンスに対してデバイスの位置を評価する](evaluate-geofences.md)
+ [Amazon EventBridge を使用して Amazon Location Service イベントに対応する](location-events.md)
+ [ジオフェンスコレクションリソースを管理する](managing-geofence-collections.md)
# ジオフェンスに対してデバイスの位置を評価する
ジオフェンスに対して位置を評価してジオフェンスイベントを生成する方法は 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"}}]'
```
------
# Amazon EventBridge を使用して Amazon Location Service イベントに対応する
Amazon EventBridge は、Amazon Location などの AWS サービスのデータを使用してアプリケーションを効率的に接続するサーバーレスイベントバスです。EventBridge はAmazon Location からイベントを受信し、そのデータを AWS Lambdaのようなターゲットにルーティングします。お客様は、データの送信先を判断するためのルーティングルールを設定して、すべてのデータソースにリアルタイムで反応するアプリケーションアーキテクチャを構築できます。
デフォルトでは、ジオフェンスイベント (`ENTER`と`EXIT`デバイスがジオフェンスエリアに出入りする際のイベント) のみが EventBridge に送信されます。トラッカーリソースのすべてのフィルターされた位置更新のイベントを有効にすることもできます。詳細については、「[トラッカーの更新イベントを有効にする](#enable-update-events)」を参照してください。
詳細については、*Amazon EventBridge ユーザーガイド*の[イベントとイベントパターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)を参照してください。
**Topics**
+ [トラッカーの更新イベントを有効にする](#enable-update-events)
+ [Amazon Location のイベントルールを作成する](#create-event-rule)
+ [Amazon Location Service 用の Amazon EventBridge イベントの例](#example-event)
## トラッカーの更新イベントを有効にする
デフォルトでは、Amazon Location は `ENTER` と `EXIT` ジオフェンスイベントのみを EventBridge に送信します。トラッカーのフィルターされた位置`UPDATE`イベントをすべてEventBridge に送信できるようにすることができます。これはトラッカーを[作成](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)または[更新する](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html)ときに設定できます。
たとえば、 を使用して既存のトラッカーを更新するには AWS CLI、次のコマンドを使用できます (*MyTracker* の代わりにトラッカーリソースの名前を使用します）。
```
aws location update-tracker --tracker-name MyTracker --event-bridge-enabled
```
トラッカーの位置イベントをオフにするには、API または Amazon Location Service コンソールを使用する必要があります。
## Amazon Location のイベントルールを作成する
EventBridge では、[イベントバスごとに最大 300 のルールを作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-quota.html)して、Amazon Location イベントに対応して実行されるアクションを設定できます。
例えば、ジオフェンスされた境界内で電話が検出されるとプッシュ通知が送信されるジオフェンスイベント用のルールを作成できます。
**Amazon Location イベントのルールを作成する**
次の値を使用して、Amazon Location イベントに基づいて [EventBridge ルールを作成します](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-visual.html)。
+ **ルールタイプ**では、**イベントパターンを持つルール**を選択します。
+ **イベントパターン** ボックスに次のパターンを貼り付けます。
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"]
}
```
トラッカー位置更新ルールを作成するには、代わりに次のパターンを使用できます。
```
{
"source": ["aws.geo"],
"detail-type": ["Location Device Position Event"]
}
```
`detail` オプションでタグを追加することで `ENTER` または `EXIT` イベントのみを指定できます (ルールがトラッカーの位置更新の場合、`EventType` は 1 つだけなので、フィルタリングする必要はありません)。
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"]
}
}
```
オプションでポジションやジオフェンスのプロパティをフィルタリングすることもできます。
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"],
"GeofenceProperties": {
"Type": "LoadingDock"
},
"PositionProperties": {
"VehicleType": "Truck"
}
}
}
```
+ **ターゲットを選択**では、Amazon Location Service からイベントを受信したときに実行するターゲットアクションを選択します。
例えば、Amazon Simple Notification Service (SNS) トピックを使用して、イベントが発生したときに E メールまたはテキストメッセージを送信できます。先ず、Amazon SNS コンソールを使用して Amazon SNS トピックを作成する必要があります。詳細については、「[Amazon SNS を利用してユーザー通知](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html)」を参照してください。
**警告**
イベントルールが正常に適用されたことを確認するのがベストプラクティスです。そうしないと、自動アクションが期待どおりに開始されない場合があります。イベントルールを確認するには、イベントルールの条件を設定します。例えば、デバイスがジオフェンスエリアに入る様子をシミュレートします。
`detail-type`セクションを除外するだけで、Amazon Location からのすべてのイベントをキャプチャすることもできます。例えば、次のようになります。
```
{
"source": [
"aws.geo"
]
}
```
**注記**
同じイベントが複数回配信される場合があります。イベント ID を使用して、受信したイベントの重複を排除できます。
## Amazon Location Service 用の Amazon EventBridge イベントの例
`BatchUpdateDevicePosition`の呼び出しによって開始されるジオフェンスに入るイベントの例を以下に示します。
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "636103698109",
"time": "2020-11-10T23:43:37Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "ENTER",
"GeofenceId": "polygon_14",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:43:37.531Z",
"Position": [
-123.12390073297821,
49.23433613216247
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
`BatchUpdateDevicePosition`の呼び出しによって開始されるジオフェンスを終了するためのイベントの例を以下に示します。
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "EXIT",
"GeofenceId": "polygon_10",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
`BatchUpdateDevicePosition`の呼び出しによって開始される位置更新イベントの例を以下に示します。
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Device Position Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "UPDATE",
"TrackerName": "tracker_2",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"ReceivedTime": "2020-11-10T23:41:39.235Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
# ジオフェンスコレクションリソースを管理する
Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用して、ジオフェンスコレクションを管理します。
## ジオフェンスコレクションリソースを一覧表示します
ジオフェンスコレクションリストは、Amazon Location コンソール、 AWS CLI、または Amazon Location APIsを使用して表示できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスコレクションのリストを表示するには**
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] にジオフェンスコレクションのリストが表示されます。
------
#### [ API ]
Amazon Location Geofences API の `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` オペレーションを使用してください。
次の例は、 AWS アカウント内のジオフェンスコレクションのリストを取得する API リクエストです。
```
POST /geofencing/v0/list-collections
```
以下に、`ListGeofenceCollections` のレスポンスの例を示します。
```
{
"Entries": [
{
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"UpdateTime": 2020-09-30T23:59:34.142Z
},
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
`[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)` コマンドを使用します。
次の例は、 AWS アカウント内のジオフェンスコレクションのリストを取得 AWS CLI するための です。
```
aws location list-geofence-collections
```
------
## ジオフェンスコレクションの詳細を取得する
Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウント内のジオフェンスコレクションリソースの詳細を取得できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスコレクションの詳細を表示するには**
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。
------
#### [ API ]
Amazon Location Geofences API の `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` オペレーションを使用してください。
以下の例は、*ExampleCollection* のジオフェンスコレクションの詳細を取得するための API リクエストです。
```
GET /geofencing/v0/collections/ExampleCollection
```
以下に、`DescribeGeofenceCollection` のレスポンスの例を示します。
```
{
"CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"Tags": {
"Tag1" : "Value1"
},
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
`[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)` コマンドを使用します。
次の例は、*ExampleCollection* のジオフェンスコレクションの詳細を取得 AWS CLI するための です。
```
aws location describe-geofence-collection \
--collection-name "ExampleCollection"
```
------
## ジオフェンスコレクションを削除する
Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLI、 AWS アカウントからジオフェンスコレクションを削除できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスコレクションを削除するには**
**警告**
このオペレーションはリソースを完全に削除します。
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションを選択します。
1. [**ジオフェンスコレクションを削除**] を選択します。
------
#### [ API ]
Amazon Location API `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` のオペレーションを使用してください。
次の例は、ジオフェンスコレクション *ExampleCollection* を削除する API リクエストです。
```
DELETE /geofencing/v0/collections/ExampleCollection
```
以下に、`DeleteGeofenceCollection` のレスポンスの例を示します。
```
HTTP/1.1 200
```
------
#### [ CLI ]
`[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)` コマンドを使用します。
次の例は、ジオフェンスコレクション *ExampleCollection* を削除する AWS CLI コマンドです。
```
aws location delete-geofence-collection \
--collection-name "ExampleCollection"
```
------
## 保存されているジオフェンスを一覧表示する
Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用して、指定されたジオフェンスコレクションに保存されているジオフェンスを一覧表示できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスのリストを表示するには**
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。
1. [**ジオフェンス**] で、ジオフェンスコレクション内のジオフェンスを表示します。
------
#### [ API ]
Amazon Location Geofences API の `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` オペレーションを使用してください。
次の例は、ジオフェンスコレクション *ExampleCollection* に保存されているジオフェンスのリストを取得する API リクエストです。
```
POST /geofencing/v0/collections/ExampleCollection/list-geofences
```
以下に、`ListGeofences` のレスポンスの例を示します。
```
{
"Entries": [
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "geofence-1",
"Geometry": {
"Polygon": [
[-5.716667, -15.933333,
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
`[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)` コマンドを使用します。
次の例は、ジオフェンスコレクション *ExampleCollection* に保存されているジオフェンスのリストを取得する AWS CLI です。
```
aws location list-geofences \
--collection-name "ExampleCollection"
```
------
## ジオフェンスの詳細を取得する
Amazon Location コンソールまたは Amazon Location APIs を使用して、ジオフェンスコレクションから、作成時間、更新時間、ジオメトリ、ステータスなど AWS CLI、特定のジオフェンスの詳細を取得できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスのステータスを表示するには**
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。
1. [**ジオフェンス**] で、ジオフェンスの状態を表示できます。
------
#### [ API ]
Amazon Location Geofences API の `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` オペレーションを使用してください。
次の例は、ジオフェンスコレクション *ExampleCollection* からジオフェンスの詳細を取得する API リクエストです。
```
GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1
```
以下に、`GetGeofence` のレスポンスの例を示します。
```
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "ExampleGeofence1",
"Geometry": {
"Polygon": [
[-1,-1],
[1,-1],
[0,1],
[-1,-1]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
`[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)` コマンドを使用します。
次の例は、*ExampleCollection* のジオフェンスコレクションの詳細を取得 AWS CLI するための です。
```
aws location get-geofence \
--collection-name "ExampleCollection" \
--geofence-id "ExampleGeofence1"
```
------
## ジオフェンスを削除する
Amazon Location コンソール、 AWS CLI、または Amazon Location API を使用して、ジオフェンスコレクションからジオフェンスを削除できます。
------
#### [ Console ]
**Amazon Location コンソールを使用してジオフェンスを削除するには**
**警告**
このオペレーションはリソースを完全に削除します。
1. Amazon Location コンソールを開きます ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home))。
1. 左側のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**マイジオフェンスコレクション**] で、対象のジオフェンスコレクションの名前リンクを選択します。
1. [**ジオフェンス**] で、ターゲットジオフェンスを選択します。
1. [**ジオフェンスを削除**] を選択します。
------
#### [ API ]
Amazon Location Geofences API の `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` オペレーションを使用してください。
次の例は、ジオフェンスコレクション *ExampleCollection* からジオフェンスを削除する API リクエストです。
```
POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json
{
"GeofenceIds": [ "ExampleGeofence11" ]
}
```
以下に、`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` の正常なレスポンスの例を示します。
```
HTTP/1.1 200
```
------
#### [ CLI ]
`[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)` コマンドを使用します。
次の例は、ジオフェンスコレクション *ExampleCollection* からジオフェンスを削除する AWS CLI コマンドです。
```
aws location batch-delete-geofence \
--collection-name "ExampleCollection" \
--geofence-ids "ExampleGeofence11"
```
------
# コストと使用状況を管理する
Amazon Location のジオフェンスについて学習を続ける際には、サービス容量の管理方法を理解し、使用制限に従い、クォータと API 最適化を通じて最良の結果を得ることが重要です。パフォーマンスと精度に関するベストプラクティスを適用することにより、場所関連のクエリを効率的に処理し、API リクエストを最大化するようにアプリケーションをカスタマイズできます。
**Topics**
+ [ジオフェンスの料金](geofence-price.md)
+ [ジオフェンスのクォータと使用量](geofence-quotas.md)
# ジオフェンスの料金
追跡およびジオフェンシング API の料金情報については、「[Amazon Location Service の料金ページ](https://aws.amazon.com/location/pricing/)」を参照してください。
**位置の評価**
`BatchEvaluateGeofences` を使用して、特定のジオフェンスコレクションのジオフェンスジオメトリに対してデバイスの位置を評価できます。1 回のリクエストで、1 つのジオフェンスコレクション内のすべてのジオフェンスに対して最大 10 個のデバイス位置を評価します。料金は、API リクエストのデバイス位置の数に基づきます。評価されるデバイス位置あたりの単価は、月間使用量の合計に基づきます。単価とボリューム階層の詳細については、「[Amazon Location Service の料金ページ](https://aws.amazon.com/location/pricing/)」を参照してください。
位置評価のコストを最適化するには、追跡デバイスからのデバイス位置の更新頻度 (ping レートとも呼ばれます) を設定し、トラッカーのフィルタリング機能を活用して関連する位置の更新のみを評価します。
**ジオフェンス管理とストレージ**
`GetGeofence`、`PutGeofence`、`BatchPutGeofence`、および `BatchDeleteGeofence` を使用して、ジオフェンスコレクション内のジオフェンスを管理できます。これらの API の料金は API リクエスト内のジオフェンスの数に基づきます。
ジオフェンスのストレージは毎月課金されます (1 か月以上保存しているジオフェンスのみ)。ジオフェンスコレクションは、`CreateGeofenceCollection`、`DeleteGeofenceCollection`、`DescribeGeofenceCollection`、`ListGeofenceCollections`、`UpdateGeofenceCollection`、および `ListGeofences` の API を使用して管理することもできます。これらの API の料金は API リクエストの数に基づきます。
**ジオフェンスイベント予測**
`ForecastGeofenceEvents` を使用して、デバイスが現在の速度で移動し続ける場合に、指定された期間内に発生する可能性のある将来のジオフェンスイベントを予測できます。料金は API リクエストの数に基づきます。
# ジオフェンスのクォータと使用量
このトピックでは、Amazon Location Service Geofences のレート制限とクォータの概要を説明します。
**注記**
より高いクォータが必要な場合は、Service Quotas コンソールを使用して、調整可能なクォータの[クォータ増加のリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)を行うことができます。クォータの引き上げをリクエストする場合は、クォータの引き上げが必要なリージョンを選択します。ほとんどのクォータは AWS リージョンに固有であるためです。API ごとにデフォルトの制限の 2 倍までリクエストできます。
デフォルトの制限の 2 倍を超えるリクエストの場合、リクエストはサポートチケットを送信します。プレミアムサポートチームに接続することもできます。クォータ引き上げリクエストには直接料金はかかりませんが、使用レベルが高くなると、消費される追加のリソースに基づいてサービスコストが増加する可能性があります。詳細については「[Service Quotas を使用してクォータを管理する](manage-quotas.md)」を参照してください。
Service Quotas は、 AWS アカウントと AWS リージョンごとに保持できるリソースの最大数です。Amazon Location Service、Service Quotas を超える追加のリクエストを拒否します。
## リソース
| API 名 | デフォルト | 最大調整可能制限 |
| --- | --- | --- |
| アカウントあたりのコレクションリソース | 1500 | 3000 それ以上必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。 |
| コレクションあたりのジオフェンス | 50000 | サポートチームにお問い合わせください。 |
## CRUD API
**注記**
これらの API のいずれかにより高い制限が必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。
| API 名 | デフォルト | 最大調整可能制限 |
| --- | --- | --- |
| [CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html) | 10 | 20 |
| [DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html) | 10 | 20 |
| [DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html) | 10 | 20 |
| [ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html) | 10 | 20 |
| [UpdateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_UpdateGeofenceCollection.html) | 10 | 20 |
## Data API
**注記**
これらの API のいずれかにより高い制限が必要な場合は、[クォータの引き上げをリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)するか、サポートチームにお問い合わせください。
| API 名 | デフォルト | 最大調整可能制限 |
| --- | --- | --- |
| [BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html) | 50 | 100 |
| [PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html) | 50 | 100 |
| [BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html) | 50 | 100 |
| [ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html) | 50 | 100 |
| [GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html) | 50 | 100 |
| [BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html) | 50 | 100 |
## その他の使用制限