Amazon Location을 사용하여 지오펜스 추가

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

Amazon Location API를 사용하여 지오펜스 컬렉션을 만들려면

Amazon Location 지오펜스 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 지오펜스 컬렉션을 생성하려면

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

Amazon Location Service 콘솔을 사용하여 지오펜스 컬렉션에 지오펜스를 추가하려면

Amazon Location API를 사용하여 지오펜스를 추가하려면

Amazon Location 지오펜스 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 명령을 사용하여 지오펜스 컬렉션에 지오펜스를 추가하려면

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 Service 콘솔을 사용하여 지오펜스 컬렉션에 원형 지오펜스를 추가하려면

Amazon Location API를 사용하여 원형 지오펜스를 추가하려면

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

다음 예제에서는 API 요청을 사용하여 ExampleGeofenceCollection이라는 지오펜스 컬렉션에 ID GEOFENCE-EXAMPLE2가 있는 지오펜스를 추가합니다.

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/GEOFENCE-EXAMPLE2
Content-type: application/json

{
   "Geometry": {
      "Circle": {
        "Center": [-5.716667, -15.933333],
        "Radius": 50
      }
   }
}

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

aws location \
    put-geofence \
        --collection-name ExampleGeofenceCollection \
        --geofence-id ExampleGeofenceCircle \
        --geometry file://circle.json

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}