翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Location を使用してジオフェンスを追加する
ジオフェンスは、点と頂点から成る閉じた境界で、対象地域を定義します。ジオフェンスコレクションは 1 つ以上のジオフェンスを格納および管理します。
Amazon Location ジオフェンスコレクションは、[GeoJSON (RFC 7946)](https://geojson.org/) と呼ばれる標準の地理空間データ形式を使用して定義されたジオフェンスを保存します。[geojson.io](http://geojson.io/) などのツールを無料で使用して、ジオフェンスをグラフィカルに描画し、GeoJSON 出力ファイルを保存できます。
**注記**
Amazon Location は、時計回りのポリゴン ([RFC 7946 §3.1.6 ](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6)で要求されている反時計回りの巻き付け順序を使用) と、アンタイムリディアンを通過するジオフェンス (経度 180° 線) をサポートしていません。
**Topics**
+ [ジオフェンスコレクションを作成する](#create-geofence-collection)
+ [ジオフェンスを描く](#draw-geofences)
+ [ポリゴンジオフェンスを追加する](#draw-polygon-geofences)
+ [円形ジオフェンスを追加する](#draw-circle-geofences)
## ジオフェンスコレクションを作成する
Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用してジオフェンスを保存および管理するためのジオフェンスコレクションを作成します。
------
#### [ Console ]
1. Amazon Location Service コンソール ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)) を開きます。
1. 左のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**ジオフェンスコレクションの作成**] を選択します。
1. 次のボックスに入力します。
+ ****名前**** - 一意の名前を入力します。例えば、{{ExampleGeofenceCollection}} などです。最大 100 文字。英数字、ピリオド (.)、ハイフン (-)、アンダースコア (\_) を含めることができます。
+ ****説明**** – リソースを区別するためのオプションの説明を入力します。
1. [**CloudWatch をターゲットとするEventBridge ルール**] で、オプションのEventBridge ルールを作成して、[ジオフェンスイベントへの対応](location-events.md)を開始できます。これにより、Amazon Location は Amazon CloudWatch Logs にイベントをパブリッシュできるようになります。
1. (オプショナル) **タグ**に、タグの**キー**と**値**を入力します。これにより、新しいジオフェンスコレクションにタグが追加されます。詳細については、[「タグによるリソースの管理](manage-resources.md)」を参照してください。
1. (オプション) [**顧客管理キーの暗号化**] で、[**顧客管理キーの追加**] を選択できます。これにより、 AWS デフォルトの暗号化ではなく、ユーザーが作成、所有、管理する対照型の顧客管理キーが追加されます。詳細については、「[保管中のデータの暗号化](encryption-at-rest.md)」を参照してください。
1. [**ジオフェンスコレクションの作成**] を選択します。
------
#### [ API ]
Amazon Location Geofences API の `[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)` オペレーションを使用してください。
次の例では、API リクエストを使用して {{ExampleGeofenceCollection}} というジオフェンスコレクションを作成します。ジオフェンスコレクションは、[カスタマーデータを暗号化するためにカスタマーマネージド AWS KMS キー](encryption-at-rest.md)に関連付けられます。
```
POST /geofencing/v0/collections
Content-type: application/json
{
"CollectionName": "{{ExampleGeofenceCollection}}",
"Description": "Geofence collection 1 for shopping center",
"KmsKeyId": "{{1234abcd-12ab-34cd-56ef-1234567890ab}}",
"Tags": {
"Tag1" : "Value1"
}
}
```
------
#### [ AWS CLI ]
`[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)` コマンドを使用します。
次の例では AWS CLI 、 を使用して {{ExampleGeofenceCollection}} というジオフェンスコレクションを作成します。ジオフェンスコレクションは、[カスタマーデータを暗号化するためにカスタマーマネージド AWS KMS キー](encryption-at-rest.md)に関連付けられます。
```
aws location \
create-geofence-collection \
--collection-name "{{ExampleGeofenceCollection}}" \
--description "Shopping center geofence collection" \
--kms-key-id "{{1234abcd-12ab-34cd-56ef-1234567890ab}}" \
--tags Tag1=Value1
```
------
**注記**
請求は使用状況によって異なります。他の AWS サービスの使用には料金が発生する場合があります。詳細については、「[Amazon Location Service 料金](https://aws.amazon.com/location/pricing/)」を参照してください。
## ジオフェンスを描く
ジオフェンスコレクションを作成したので、ジオフェンスを定義できるようになりました。ジオフェンスはポリゴンまたは円として定義されます。ポリゴンジオフェンスを描画するには、[geojson.io](http://geojson.io/) などの GeoJSON 編集ツールを使用できます。
円形ジオフェンスを作成するには、場所の緯度と経度を使用して中心点を定義し、半径をメートル単位で設定します。詳細については、「[円形ジオフェンスを追加する](#draw-circle-geofences)」を参照してください。
Amazon Location Service APIs を使用して、キーと値のペアの形式でジオフェンスにメタデータを追加することもできます。これは、ジオフェンスの種類、アプリケーション固有のその他の情報など、ジオフェンスの情報を保存する上で役立ちます。このメタデータは、次のような場合に使用できます。[Amazon EventBridge を使用して Amazon Location Service イベントに対応する](location-events.md)
## ポリゴンジオフェンスを追加する
多角形ジオフェンスは GeoJSON 座標配列を使用してエリアを定義します。この形式は、不規則な形状の地理的境界に出入りするエントリを追跡する必要がある場合に使用します。
### GeoJSON ツールを使用してジオフェンスを描画する
1. [geojson.io](http://geojson.io/) などの GeoJSON 編集ツールを開きます。
1. [**ポリゴンを描画**] アイコンを選択し、対象エリアを描画します。
1. [**保存**] を選択し、ドロップダウンメニューから [**GeoJSON**] を選択します。
### GeoJSON ジオフェンスをジオフェンスコレクションに入れる
生成された GeoJSON ファイルを使用して、Amazon Location Service コンソール、、 AWS CLIまたは Amazon Location APIs を使用してジオフェンスをアップロードできます。
------
#### [ Console ]
1. Amazon Location Service コンソール ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)) を開きます。
1. 左のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**ジオフェンスコレクション**] リストから、対象のジオフェンスコレクションの名前リンクを選択します。
1. [**ジオフェンス**] で [**ジオフェンスを作成**] を選択します。
1. **ジオフェンスの追加**ウィンドウで、GeoJSON をウィンドウにドラッグアンドドロップします。
1. [**ジオフェンスを追加**] を選択します。
------
#### [ API ]
Amazon Location Geofences API の `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` オペレーションを使用してください。
次の例では、API リクエストを使用して、ID {{GEOFENCE-EXAMPLE1}} のジオフェンスを {{ExampleGeofenceCollection}} というジオフェンスコレクションに追加します。また、キー `Type`と値 を持つジオフェンスメタデータプロパティも指定します`loadingArea`。
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE1}}
Content-type: application/json
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
```
または、`[BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html)` オペレーションを使用して複数のジオフェンスを追加することもできます。
```
POST /geofencing/v0/collections/{{ExampleGeofenceCollection}}/put-geofences
Content-type: application/json
{
"Entries": [
{
"GeofenceProperties": {
"Type" : "loadingArea"
},
"GeofenceId": "{{GEOFENCE-EXAMPLE1}}",
"Geometry": {
"Polygon": [
[
[-5.716667, -15.933333],
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
]
}
}
]
}
```
------
#### [ AWS CLI ]
`[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)` コマンドを使用します。
次の例では、 を使用して AWS CLI 、{{ExampleGeofenceCollection}} というジオフェンスコレクションにジオフェンスを追加します。
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceTriangle}} \
--geofence-properties '{"Type": "loadingArea"}' \
--geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'
```
------
## 円形ジオフェンスを追加する
円形ジオフェンスを作成するには、中心点の緯度と経度、およびメートル単位の半径を知る必要があります。店舗、倉庫、ランドマークなどの特定のポイントへの近接性に基づいてイベントをトリガーする必要がある場合は、円形ジオフェンスを使用します。Amazon Location コンソール、Amazon Location APIs、または を使用して、円形ジオフェンスを作成できます AWS CLI。
------
#### [ Console ]
1. Amazon Location Service コンソール ([https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)) を開きます。
1. 左のナビゲーションペインから、**[ジオフェンスコレクション]** を選択します。
1. [**ジオフェンスコレクション**] リストから、対象のジオフェンスコレクションの名前リンクを選択します。
1. [**ジオフェンス**] で [**ジオフェンスを作成**] を選択します。
1. **ジオフェンスの追加**ウィンドウで、**円**を選択し、中央**の緯度**、**経度**、**半径**をメートル単位で入力します。
1. [**ジオフェンスを追加**] を選択します。
------
#### [ API ]
Amazon Location Geofences API の `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` オペレーションを使用してください。
次の例では、API リクエストを使用して、ID {{GEOFENCE-EXAMPLE2}} のジオフェンスを {{ExampleGeofenceCollection}} というジオフェンスコレクションに追加します。
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE2}}
Content-type: application/json
{
"Geometry": {
"Circle": {
"Center": [-5.716667, -15.933333],
"Radius": 50
}
}
}
```
------
#### [ AWS CLI ]
`[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)` コマンドを使用します。
次の例では AWS CLI 、 を使用して、{{ExampleGeofenceCollection}} と呼ばれるジオフェンスコレクションに円形ジオフェンスを追加します。
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
```
**注記**
次の例のように、複雑なジオメトリの JSON を独自のファイルに入れることもできます。
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry file://circle.json
```
ここで、 には円ジオメトリ`circle.json`が含まれます。
```
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
```
------