ジオフェンスコレクションリソースの管理 - Amazon Location Service
ジオフェンスコレクションリソースを一覧表示しますジオフェンスコレクションの詳細を取得するジオフェンスコレクションを削除する保存されているジオフェンスを一覧表示するジオフェンスの詳細を取得するジオフェンスを削除する

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

ジオフェンスコレクションリソースの管理

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用してジオフェンスコレクションを管理します。

ジオフェンスコレクションリソースを一覧表示します

ジオフェンスコレクションリストは、Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して表示できます。

Console

Amazon Location コンソールを使用してジオフェンスコレクションのリストを表示するには

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

  3. [マイジオフェンスコレクション] にジオフェンスコレクションのリストが表示されます。

API

Amazon Location Geofences API の ListGeofenceCollections オペレーションを使用してください。

以下の例は、AWS アカウント内のジオフェンスコレクションのリストを取得する API リクエストです。

POST /geofencing/v0/list-collections

以下に、ListGeofenceCollections のレスポンスの例を示します。

{
    "Entries": [ 
    { 
        "CollectionName": "ExampleCollection",
        "CreateTime": 2020-09-30T22:59:34.142Z,
        "Description": "string",
        "UpdateTime": 2020-09-30T23:59:34.142Z
    },
    "NextToken": "1234-5678-9012"
}
CLI

list-geofence-collectionsコマンドを実行します。

次の例は、AWS アカウント内のジオフェンスコレクションのリストを取得するための AWS CLI です。

aws location list-geofence-collections

ジオフェンスコレクションの詳細を取得する

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して、AWSアカウント内のジオフェンスコレクションリソースに関する詳細を取得できます。

Console

Amazon Location コンソールを使用してジオフェンスコレクションの詳細を表示するには

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

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

API

Amazon Location Geofences API の DescribeGeofenceCollection オペレーションを使用してください。

次の例は、 のジオフェンスコレクションの詳細を取得するための API リクエストですExampleCollection。

GET /geofencing/v0/collections/ExampleCollection

以下に、DescribeGeofenceCollection のレスポンスの例を示します。

{
    "CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
    "CollectionName": "ExampleCollection",
    "CreateTime": 2020-09-30T22:59:34.142Z,
    "Description": "string",
    "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "Tags": { 
        "Tag1" : "Value1"
    },
    "UpdateTime": 2020-09-30T23:59:34.142Z
}
CLI

describe-geofence-collectionコマンドを実行します。

次の例は、 のジオフェンスコレクションの詳細を取得AWS CLIするための ですExampleCollection。

aws location describe-geofence-collection \
    --collection-name "ExampleCollection"

ジオフェンスコレクションを削除する

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して、AWS アカウントからジオフェンスコレクションを削除できます。

Console

Amazon Location コンソールを使用してジオフェンスコレクションを削除するには

警告

このオペレーションはリソースを完全に削除します。

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

  3. [マイジオフェンスコレクション] で、対象のジオフェンスコレクションを選択します。

  4. [ジオフェンスコレクションを削除] を選択します。

API

Amazon Location API DeleteGeofenceCollection のオペレーションを使用してください。

次の例は、ジオフェンスコレクション を削除する API リクエストですExampleCollection。

DELETE /geofencing/v0/collections/ExampleCollection

以下に、DeleteGeofenceCollection のレスポンスの例を示します。

HTTP/1.1 200
CLI

delete-geofence-collectionコマンドを実行します。

次の例は、ジオフェンスコレクション を削除する AWS CLI コマンドですExampleCollection。

aws location delete-geofence-collection \
    --collection-name "ExampleCollection"

保存されているジオフェンスを一覧表示する

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して、指定したジオフェンスコレクションに保存されているジオフェンスを一覧表示できます。

Console

Amazon Location コンソールを使用してジオフェンスのリストを表示するには

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

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

  4. [ジオフェンス] で、ジオフェンスコレクション内のジオフェンスを表示します。

API

Amazon Location Geofences API の ListGeofences オペレーションを使用してください。

次の例は、ジオフェンスコレクション に保存されているジオフェンスのリストを取得する API リクエストですExampleCollection。

POST /geofencing/v0/collections/ExampleCollection/list-geofences

以下に、ListGeofences のレスポンスの例を示します。

{
   "Entries": [ 
      { 
         "CreateTime": 2020-09-30T22:59:34.142Z,
         "GeofenceId": "geofence-1",
         "Geometry": { 
             "Polygon": [            
                 [-5.716667, -15.933333,
                 [-14.416667, -7.933333],
                 [-12.316667, -37.066667],
                 [-5.716667, -15.933333]
             ]
         },
         "Status": "ACTIVE",
         "UpdateTime": 2020-09-30T23:59:34.142Z
      }
   ],
   "NextToken": "1234-5678-9012"
}
CLI

list-geofencesコマンドを実行します。

次の例はAWS CLI、ジオフェンスコレクション に保存されているジオフェンスのリストを取得する ですExampleCollection。

aws location list-geofences \
    --collection-name "ExampleCollection"

ジオフェンスの詳細を取得する

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して、ジオフェンスコレクションから作成時間、更新時間、ジオメトリ、ステータスなどの特定のジオフェンスの詳細を取得できます。

Console

Amazon Location コンソールを使用してジオフェンスのステータスを表示するには

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

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

  4. [ジオフェンス] で、ジオフェンスの状態を表示できます。

API

Amazon Location Geofences API の GetGeofence オペレーションを使用してください。

次の例は、ジオフェンスコレクション からジオフェンスの詳細を取得するための API リクエストですExampleCollection。

GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1

以下に、GetGeofence のレスポンスの例を示します。

{
   "CreateTime": 2020-09-30T22:59:34.142Z,
   "GeofenceId": "ExampleGeofence1",
   "Geometry": { 
      "Polygon": [            
          [-1,-1],
          [1,-1],
          [0,1],
          [-1,-1] 
      ]
   },
   "Status": "ACTIVE",
   "UpdateTime": 2020-09-30T23:59:34.142Z
}
CLI

get-geofenceコマンドを実行します。

次の例は、 のジオフェンスコレクションの詳細を取得AWS CLIするための ですExampleCollection。

aws location get-geofence \
    --collection-name "ExampleCollection" \
    --geofence-id "ExampleGeofence1"

ジオフェンスを削除する

Amazon Location コンソール、AWS CLI、または Amazon Location API を使用して、ジオフェンスコレクションからジオフェンスを削除できます。

Console

Amazon Location コンソールを使用してジオフェンスを削除するには

警告

このオペレーションはリソースを完全に削除します。

  1. Amazon Location コンソールを開きます (https://console.aws.amazon.com/location/)。

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

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

  4. [ジオフェンス] で、ターゲットジオフェンスを選択します。

  5. [ジオフェンスを削除] を選択します。

API

Amazon Location Geofences API の BatchDeleteGeofence オペレーションを使用してください。

次の例は、ジオフェンスコレクション からジオフェンスを削除する API リクエストですExampleCollection。

POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json

{
   "GeofenceIds": [ "ExampleGeofence11" ]
}

以下に、BatchDeleteGeofence の正常なレスポンスの例を示します。

HTTP/1.1 200
CLI

batch-delete-geofenceコマンドを実行します。

次の例は、ジオフェンスコレクション からジオフェンスを削除する AWS CLI コマンドですExampleCollection。

aws location batch-delete-geofence \
    --collection-name "ExampleCollection" \
    --geofence-ids "ExampleGeofence11"