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/geofence/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]]]'
    {
        "CreateTime": "2020-11-11T00:16:14.487000+00:00",
        "GeofenceId": "ExampleGeofenceTriangle",
        "UpdateTime": "2020-11-11T00:19:59.894000+00:00"
    }

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

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

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

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/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
    }
}