翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Location を使用してジオフェンスを追加する
ジオフェンスは、点と頂点から成る閉じた境界で、対象地域を定義します。ジオフェンスコレクションは 1 つ以上のジオフェンスを格納および管理します。
Amazon Location ジオフェンスコレクションは、GeoJSON (RFC 7946) と呼ばれる標準の地理空間データ形式を使用して定義されたジオフェンスを保存します。geojson.io などのツールを無料で使用して、ジオフェンスをグラフィカルに描画し、GeoJSON 出力ファイルを保存できます。
Amazon Location は、時計回りのポリゴン (RFC 7946 §3.1.6 で要求されている反時計回りの巻き付け順序を使用) と、アンタイムリディアンを通過するジオフェンス (経度 180° 線) をサポートしていません。
ジオフェンスコレクションを作成する
Amazon Location コンソール、、 AWS CLIまたは Amazon Location APIs を使用してジオフェンスを保存および管理するためのジオフェンスコレクションを作成します。
- Console
-
Amazon Location コンソールを使用してジオフェンスコレクションを作成するには
-
Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。
-
左のナビゲーションペインから、[ジオフェンスコレクション] を選択します。
-
[ジオフェンスコレクションの作成] を選択します。
-
次のボックスに入力します。
-
[CloudWatch をターゲットとするEventBridge ルール] で、オプションのEventBridge ルールを作成して、ジオフェンスイベントへの対応を開始できます。これにより、Amazon Location は Amazon CloudWatch Logs にイベントをパブリッシュできるようになります。
-
(オプショナル) タグに、タグのキーと値を入力します。これにより、新しいジオフェンスコレクションにタグが追加されます。詳細については、「タグによるリソースの管理」を参照してください。
-
(オプション) [顧客管理キーの暗号化] で、[顧客管理キーの追加] を選択できます。これにより、 AWS
デフォルトの暗号化ではなく、ユーザーが作成、所有、管理する対照型の顧客管理キーが追加されます。詳細については、「保管中のデータの暗号化」を参照してください。
-
[ジオフェンスコレクションの作成] を選択します。
- API
-
Amazon Location API を使用してジオフェンスコレクションを作成するには
Amazon Location Geofences API の CreateGeofenceCollection オペレーションを使用してください。
次の例では、API リクエストを使用して ExampleGeofenceCollection というジオフェンスコレクションを作成します。ジオフェンスコレクションは、カスタマーデータを暗号化するためにカスタマーマネージド AWS KMS キーに関連付けられます。
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
-
コマンドを使用して AWS CLI ジオフェンスコレクションを作成するには
create-geofence-collection コマンドを使用します。
次の例では AWS CLI 、 を使用して ExampleGeofenceCollection というジオフェンスコレクションを作成します。ジオフェンスコレクションは、カスタマーデータを暗号化するためにカスタマーマネージド AWS KMS キーに関連付けられます。
aws location \
create-geofence-collection \
--collection-name "ExampleGeofenceCollection" \
--description "Shopping center geofence collection" \
--kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
--tags Tag1=Value1
ジオフェンスを描く
ジオフェンスコレクションを作成したので、ジオフェンスを定義できるようになりました。ジオフェンスはポリゴンまたは円として定義されます。ポリゴンジオフェンスを描画するには、geojson.io などの GeoJSON 編集ツールを使用できます。
円形ジオフェンスを作成するには、場所の緯度と経度を使用して中心点を定義し、半径をメートル単位で設定します。詳細については、「円形ジオフェンスを追加する」を参照してください。
Amazon Location Service APIs を使用して、キーと値のペアの形式でジオフェンスにメタデータを追加することもできます。これは、ジオフェンスの種類、アプリケーション固有のその他の情報など、ジオフェンスの情報を保存する上で役立ちます。このメタデータは、次のような場合に使用できます。Amazon EventBridge を使用して Amazon Location Service イベントに対応する
ポリゴンジオフェンスを追加する
多角形ジオフェンスは GeoJSON 座標配列を使用してエリアを定義します。この形式は、不規則な形状の地理的境界に出入りするエントリを追跡する必要がある場合に使用します。
GeoJSON ツールを使用してジオフェンスを描画する
GeoJSON ファイルを作成するには
-
geojson.io などの GeoJSON 編集ツールを開きます。
-
[ポリゴンを描画] アイコンを選択し、対象エリアを描画します。
-
[保存] を選択し、ドロップダウンメニューから [GeoJSON] を選択します。
GeoJSON ジオフェンスをジオフェンスコレクションに入れる
生成された GeoJSON ファイルを使用して、Amazon Location Service コンソール、、 AWS CLIまたは Amazon Location APIs を使用してジオフェンスをアップロードできます。
- Console
-
Amazon Location Service コンソールを使用してジオフェンスコレクションにジオフェンスを追加するには
- API
-
Amazon Location API を使用してジオフェンスを追加するには
Amazon Location Geofences API の PutGeofence オペレーションを使用してください。
次の例では、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 オペレーションを使用して複数のジオフェンスを追加することもできます。
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
-
AWS CLI コマンドを使用してジオフェンスコレクションにジオフェンスを追加するには
put-geofence コマンドを使用します。
次の例では、 を使用して 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
-
Amazon Location Service コンソールを使用してジオフェンスコレクションに円形ジオフェンスを追加するには
- API
-
Amazon Location API を使用して円形ジオフェンスを追加するには
Amazon Location Geofences API の PutGeofence オペレーションを使用してください。
次の例では、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
-
AWS CLI コマンドを使用してジオフェンスコレクションに円形ジオフェンスを追加するには
put-geofence コマンドを使用します。
次の例では 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
}
}