翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ジオフェンスを追加する
ジオフェンスは、点と頂点から成る閉じた境界で、対象地域を定義します。ジオフェンスコレクションは 1 つ以上のジオフェンスを格納および管理します。
Amazon Location ジオフェンスコレクションには、GeoJSON (RFC 7946) と呼ばれる標準の地理空間データ形式を使用して定義されたジオフェンスが格納されます。geojson.io などのツールを無料で使用して、ジオフェンスをグラフィカルに描画し、GeoJSON 出力ファイルを保存できます。
Amazon Location は、穴のあるポリゴン、マルチポリゴン、時計回りのポリゴン、および反時計午線を横切るジオフェンスをサポートしていません。
ジオフェンスコレクションを作成する
Amazon Location コンソール、、または Amazon Location APIs を使用して AWS CLIジオフェンスを保存および管理するためのジオフェンスコレクションを作成します。
- Console
-
Amazon Location コンソールを使用してジオフェンスコレクションを作成するには
- 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 編集ツールを使用できます。
円形ジオフェンスを描画するには、円の中心点と半径を定義する必要があります。例えば、デバイスが特定の位置から 50 メートル以内に入ったときに通知を受け取るようにジオフェンスを作成する場合は、その位置の緯度と経度を使用して半径を 50 メートルと指定します。
Amazon Location Service API を使用すると、キーと値をペアとしたメタデータをジオフェンスに追加することもできます。これは、ジオフェンスの種類、アプリケーション固有のその他の情報など、ジオフェンスの情報を保存する上で役立ちます。このメタデータは、次のような場合に使用できます。Amazon での Amazon Location Service イベントへの対応 EventBridge
ポリゴンジオフェンスを追加する
このセクションでは、ポリゴンジオフェンスの作成について説明します
GeoJSON ツールを使用してジオフェンスを描画する
ジオフェンスコレクションを作成したので、geojson.io などの GeoJSON 編集ツールを使用してジオフェンスを定義できます。
GeoJSON ファイルを作成するには
-
GeoJSON 編集ツールを開きます。例えば、geojson.io を使用します。
-
[ポリゴンを描画] アイコンを選択し、対象エリアを描画します。
-
[保存] を選択し、ドロップダウンメニューから [GeoJSON] を選択します。
GeoJSON ジオフェンスをジオフェンスコレクションに入れる
結果の GeoJSON ファイルを使用して、Amazon Location Service コンソール、 AWS CLI、または Amazon Location APIs を使用してジオフェンスをアップロードできます。
- Console
-
Amazon Location Service コンソールを使用してジオフェンスコレクションにジオフェンスを追加するには
-
Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。
-
左のナビゲーションペインから、[ジオフェンスコレクション] を選択します。
-
[ジオフェンスコレクション] リストから、対象のジオフェンスコレクションの名前リンクを選択します。
-
[ジオフェンス] で [ジオフェンスを作成] を選択します。
-
[ジオフェンスを追加] ウィンドウで、GeoJSON をウィンドウにドラッグアンドドロップします。
-
[ジオフェンスを追加] を選択します。
- API
-
Amazon Location API を使用してジオフェンスを追加するには
Amazon Location Geofences API の PutGeofence
オペレーションを使用してください。
次の例では、 API リクエストを使用して、ID GEOFENCE-EXAMPLE1
を というジオフェンスコレクションに追加しますExampleGeofenceCollection
。キー Type
と値 loadingArea
1 つのペアを有するジオフェンスメタデータプロパティも指定します。
PUT /geofencing/v0/collections/ExampleGeofenceCollection
/geofence/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]]]'
{
"CreateTime": "2020-11-11T00:16:14.487000+00:00",
"GeofenceId": "ExampleGeofenceTriangle
",
"UpdateTime": "2020-11-11T00:19:59.894000+00:00"
}
円形ジオフェンスを追加する
このセクションでは、円形ジオフェンスの作成について説明します。円の中心にしたい点の緯度と経度、および円の半径 (メートル単位) を知っておく必要があります。Amazon Location API または AWS CLIを使用して、円形ジオフェンスを作成できます。
- API
-
Amazon Location API を使用して円形ジオフェンスを追加するには
Amazon Location Geofences API の PutGeofence
オペレーションを使用してください。
次の例では、API リクエストを使用して、ID GEOFENCE-EXAMPLE2
が指定されたジオフェンスを というジオフェンスコレクションに追加しますExampleGeofenceCollection
。
PUT /geofencing/v0/collections/ExampleGeofenceCollection
/geofence/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 ファイルに円ジオメトリの JSON が含まれています。
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}