View a markdown version of this page

Amazon Location を使用してジオフェンスを追加する - Amazon Location Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 コンソールを使用してジオフェンスコレクションを作成するには
  1. Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。

  2. 左のナビゲーションペインから、[ジオフェンスコレクション] を選択します。

  3. [ジオフェンスコレクションの作成] を選択します。

  4. 次のボックスに入力します。

    • 名前 - 一意の名前を入力します。例えば、ExampleGeofenceCollection などです。最大 100 文字。英数字、ピリオド (.)、ハイフン (-)、アンダースコア (_) を含めることができます。

    • 説明 – リソースを区別するためのオプションの説明を入力します。

  5. [CloudWatch をターゲットとするEventBridge ルール] で、オプションのEventBridge ルールを作成して、ジオフェンスイベントへの対応を開始できます。これにより、Amazon Location は Amazon CloudWatch Logs にイベントをパブリッシュできるようになります。

  6. (オプショナル) タグに、タグのキーを入力します。これにより、新しいジオフェンスコレクションにタグが追加されます。詳細については、「タグによるリソースの管理」を参照してください。

  7. (オプション) [顧客管理キーの暗号化] で、[顧客管理キーの追加] を選択できます。これにより、 AWS デフォルトの暗号化ではなく、ユーザーが作成、所有、管理する対照型の顧客管理キーが追加されます。詳細については、「保管中のデータの暗号化」を参照してください。

  8. [ジオフェンスコレクションの作成] を選択します。

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
注記

請求は使用状況によって異なります。他の AWS サービスの使用には料金が発生する場合があります。詳細については、「Amazon Location Service 料金」を参照してください。

ジオフェンスを描く

ジオフェンスコレクションを作成したので、ジオフェンスを定義できるようになりました。ジオフェンスはポリゴンまたは円として定義されます。ポリゴンジオフェンスを描画するには、geojson.io などの GeoJSON 編集ツールを使用できます。

円形ジオフェンスを作成するには、場所の緯度と経度を使用して中心点を定義し、半径をメートル単位で設定します。詳細については、「円形ジオフェンスを追加する」を参照してください。

Amazon Location Service APIs を使用して、キーと値のペアの形式でジオフェンスにメタデータを追加することもできます。これは、ジオフェンスの種類、アプリケーション固有のその他の情報など、ジオフェンスの情報を保存する上で役立ちます。このメタデータは、次のような場合に使用できます。Amazon EventBridge を使用して Amazon Location Service イベントに対応する

ポリゴンジオフェンスを追加する

多角形ジオフェンスは GeoJSON 座標配列を使用してエリアを定義します。この形式は、不規則な形状の地理的境界に出入りするエントリを追跡する必要がある場合に使用します。

GeoJSON ツールを使用してジオフェンスを描画する

GeoJSON ファイルを作成するには
  1. geojson.io などの GeoJSON 編集ツールを開きます。

  2. [ポリゴンを描画] アイコンを選択し、対象エリアを描画します。

  3. [保存] を選択し、ドロップダウンメニューから [GeoJSON] を選択します。

GeoJSON ジオフェンスをジオフェンスコレクションに入れる

生成された GeoJSON ファイルを使用して、Amazon Location Service コンソール、、 AWS CLIまたは Amazon Location APIs を使用してジオフェンスをアップロードできます。

Console
Amazon Location Service コンソールを使用してジオフェンスコレクションにジオフェンスを追加するには
  1. Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。

  2. 左のナビゲーションペインから、[ジオフェンスコレクション] を選択します。

  3. [ジオフェンスコレクション] リストから、対象のジオフェンスコレクションの名前リンクを選択します。

  4. [ジオフェンス] で [ジオフェンスを作成] を選択します。

  5. ジオフェンスの追加ウィンドウで、GeoJSON をウィンドウにドラッグアンドドロップします。

  6. [ジオフェンスを追加] を選択します。

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 コンソールを使用してジオフェンスコレクションに円形ジオフェンスを追加するには
  1. Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。

  2. 左のナビゲーションペインから、[ジオフェンスコレクション] を選択します。

  3. [ジオフェンスコレクション] リストから、対象のジオフェンスコレクションの名前リンクを選択します。

  4. [ジオフェンス] で [ジオフェンスを作成] を選択します。

  5. ジオフェンスの追加ウィンドウで、を選択し、中央の緯度経度半径をメートル単位で入力します。

  6. [ジオフェンスを追加] を選択します。

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 } }