翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ジオフェンスを追加する
ジオフェンスは、点と頂点から成る閉じた境界で、対象地域を定義します。ジオフェンスコレクションは 1 つ以上のジオフェンスを格納および管理します。
Amazon Location ジオフェンスコレクションは、Geo (RFC 7946) と呼ばれる標準の地理空間データ形式を使用して定義されたジオJSONフェンスを保存します。geojson.io などのツールを使用して、ジオフェンスをグラフィカルに描画し、出力 GeoJSON ファイルを保存できます。
Amazon Location は、穴のあるポリゴン、マルチポリゴン、時計回りのポリゴン、および反時計午線を横切るジオフェンスをサポートしていません。
ジオフェンスコレクションを作成する
Amazon Location コンソール、、 AWS CLIまたは Amazon Location を使用してジオフェンスを保存および管理するためのジオフェンスコレクションを作成しますAPIs。
- Console
-
Amazon Location コンソールを使用してジオフェンスコレクションを作成するには
- API
-
Amazon Location を使用してジオフェンスコレクションを作成するには APIs
Amazon Location Geofences の CreateGeofenceCollection
オペレーションを使用しますAPIs。
次の例では、 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 を使用するとAPIs、キーと値のペアの形式で、ジオフェンスにメタデータを追加することもできます。これは、ジオフェンスの種類、アプリケーション固有のその他の情報など、ジオフェンスの情報を保存する上で役立ちます。このメタデータは、次のような場合に使用できます。Amazon での Amazon Location Service イベントへの対応 EventBridge
ポリゴンジオフェンスを追加する
このセクションでは、ポリゴンジオフェンスの作成について説明します
GeoJSON ツールを使用してジオフェンスを描画する
ジオフェンスコレクションを作成したので、geojson.io などのジオJSON編集ツールを使用してジオフェンスを定義できます。
GeoJSON ファイルを作成するには
-
GeoJSON 編集ツールを開きます。例えば、geojson.io を使用します。
-
[ポリゴンを描画] アイコンを選択し、対象エリアを描画します。
-
「保存」を選択し、ドロップダウンメニューから「地域JSON」を選択します。
ジオJSONフェンスコレクションにジオフェンスを配置する
結果の GeoJSON ファイルを使用して、Amazon Location Service コンソール、、 AWS CLIまたは Amazon Location を使用してジオフェンスをアップロードできますAPIs。
- Console
-
Amazon Location Service コンソールを使用してジオフェンスコレクションにジオフェンスを追加するには
- API
-
Amazon Location を使用してジオフェンスを追加するには APIs
Amazon Location Geofences の PutGeofence
オペレーションを使用しますAPIs。
次の例では、 APIリクエストを使用して ID を指定してジオフェンスを追加します。GEOFENCE-EXAMPLE1
を というジオフェンスコレクションに ExampleGeofenceCollection
。 また、キー Type
と値 を持つ単一のジオフェンスメタデータプロパティも指定しますloadingArea
。
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 APIsまたは を使用して円形ジオフェンスを作成できます AWS CLI。
- API
-
Amazon Location を使用して円形ジオフェンスを追加するには APIs
Amazon Location Geofences の PutGeofence
オペレーションを使用しますAPIs。
次の例では、 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
}
}