지오펜스 컬렉션 리소스 관리

Amazon Location 콘솔을 사용하여 지오펜스 컬렉션 목록을 보려면

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

list-geofence-collections 명령을 사용합니다.

다음 예시는 AWS CLI 계정의 지오펜스 컬렉션 목록을 가져오는 AWS입니다.

aws location list-geofence-collections

Amazon Location 콘솔을 사용하여 지오펜스 컬렉션의 세부 정보를 보려면

Amazon Location 지오펜스 API에서 DescribeGeofenceCollection 작업을 사용합니다.

다음 예시는 ExampleCollection의 지오펜스 컬렉션 세부 정보를 가져오기 위한 API 요청입니다.

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
}

describe-geofence-collection 명령을 사용합니다.

다음 예시는 ExampleCollection의 지오펜스 컬렉션 세부 정보를 가져오는 AWS CLI입니다.

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

Amazon Location 콘솔을 사용하여 지오펜스 컬렉션을 삭제하려면

Amazon Location API에서 DeleteGeofenceCollection 작업을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection을 삭제하기 위한 API 요청입니다.

DELETE /geofencing/v0/collections/ExampleCollection

다음은 DeleteGeofenceCollection에 대한 응답의 예입니다.

HTTP/1.1 200

delete-geofence-collection 명령을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection을 삭제하는 AWS CLI 명령입니다.

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

Amazon Location 콘솔을 사용하여 지오펜스 목록을 보려면

Amazon Location 지오펜스 API에서 ListGeofences 작업을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection에 저장된 지오펜스 목록을 가져오기 위한 API 요청입니다.

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

list-geofences 명령을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection에 저장된 지오펜스 목록을 가져오는 AWS CLI입니다.

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

Amazon Location 콘솔을 사용하여 지오펜스의 상태를 보려면

Amazon Location 지오펜스 API에서 GetGeofence 작업을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection에서 지오펜스 세부 정보를 가져오기 위한 API 요청입니다.

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
}

get-geofence 명령을 사용합니다.

다음 예시는 ExampleCollection의 지오펜스 컬렉션 세부 정보를 가져오는 AWS CLI입니다.

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

Amazon Location 콘솔을 사용하여 지오펜스를 삭제하려면

Amazon Location 지오펜스 API에서 BatchDeleteGeofence 작업을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection에서 지오펜스를 삭제하기 위한 API 요청입니다.

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

{
   "GeofenceIds": [ "ExampleGeofence11" ]
}

다음은 BatchDeleteGeofence에 대한 성공적인 응답의 예입니다.

HTTP/1.1 200

batch-delete-geofence 명령을 사용합니다.

다음 예시는 지오펜스 컬렉션 ExampleCollection에서 지오펜스를 삭제하는 AWS CLI 명령입니다.

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