管理您的地理围栏集合资源 - 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 地理围栏 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 地理围栏 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 地理围栏 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 命令。

以下示例是获取存储在 geofence 集合中的地理围栏列表的示例。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 地理围栏 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 地理围栏 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"