Amazon Location を使用して追跡を開始する

Amazon Location コンソールを使用してトラッカーを作成するには

Amazon Location API を使用してトラッカーを作成するには

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

次の例では、API リクエストを使用して ExampleTracker というトラッカーを作成します。トラッカーリソースは、顧客データを暗号化するための AWS KMS 顧客管理キーにリンクされており、EventBridge での位置更新は有効化されていません。

POST /tracking/v0/trackers
Content-type: application/json

{
   
   "TrackerName": "ExampleTracker",
   "Description": "string",
   "KmsKeyEnableGeospatialQueries": false, 
   "EventBridgeEnabled": false,
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "PositionFiltering": "AccuracyBased",
   "Tags": { 
      "string" : "string" 
   }
}

KmsKeyEnableGeospatialQueries を有効にしたトラッカーを作成する

次の例では、KmsKeyEnableGeospatialQueries パラメータが true に設定されています。これにより、Bounding Polygon Queries 機能を使用しながら、AWS KMS 顧客管理キーを使用してデータを暗号化できます。

Bounding Polygon Queries 機能の使用方法については、「デバイスの位置のリストを表示する」を参照してください

POST /tracking/v0/trackers
Content-type: application/json

{
   
   "TrackerName": "ExampleTracker",
   "Description": "string",
   "KmsKeyEnableGeospatialQueries": true, 
   "EventBridgeEnabled": false,
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "PositionFiltering": "AccuracyBased",
   "Tags": { 
      "string" : "string" 
   }
}

AWS CLI コマンドを使用してトラッカーを作成するには

create-tracker コマンドを実行します。

次の例では、AWS CLI を使用して ExampleTracker というトラッカーを作成します。トラッカーリソースは、顧客データを暗号化するための AWS KMS 顧客管理キーにリンクされており、EventBridge での位置更新は有効化されていません。

aws location \
  create-tracker \
  --tracker-name "ExampleTracker" \
  --position-filtering "AccuracyBased" \
  --event-bridge-enabled false \
  --kms-key-enable-geospatial-queries false \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab"

KmsKeyEnableGeospatialQueries を有効にしたトラッカーを作成する

次の例では、KmsKeyEnableGeospatialQueries パラメータが true に設定されています。これにより、Bounding Polygon Queries 機能を使用しながら、AWS KMS 顧客管理キーを使用してデータを暗号化できます。

Bounding Polygon Queries 機能の使用方法については、「デバイスの位置のリストを表示する」を参照してください

aws location \
  create-tracker \
  --tracker-name "ExampleTracker" \
  --position-filtering "AccuracyBased" \
  --event-bridge-enabled false \
  --kms-key-enable-geospatial-queries true \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab"

Amazon Location API を使用して位置更新を送信するには

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

次の例では、API リクエストを使用して ExampleDevice のデバイス位置更新を、ExampleTracker というトラッカーに送信します。

POST /tracking/v0/trackers/ExampleTracker/positions
Content-type: application/json
{
 "Updates": [
    {
    "DeviceId": "1",
    "Position": [
   -123.12245146162303, 49.27521118043802
    ],
    "SampleTime": "2022-10-24T19:09:07.327Z",
     "PositionProperties": { 
            "name" : "device1" 
         },
         "Accuracy": { 
            "Horizontal": 10
         }
    },

    {
    "DeviceId": "2",
    "Position": [
   -123.1230104928471, 49.27752402723152
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "3",
    "Position": [
    -123.12325592118916, 49.27340530543111
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "4",
    "Position": [
    -123.11958813096311, 49.27774641063121
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "5",
    "Position": [
    -123.1277418058896, 49.2765989015285
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "6",
    "Position": [
   -123.11964267059481, 49.274188155916534
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    }
    ]
}

AWS CLI コマンドを使用して位置更新を送信するには

batch-update-device-position コマンドを実行します。

次の例では、AWS CLI を使用して ExampleDevice-1 と ExampleDevice-2 のデバイス位置更新を ExampleTracker というトラッカーに送信します。

aws location batch-update-device-position \
--tracker-name ExampleTracker \
--updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'

Amazon Location API を使用してトラッカーからデバイスの位置履歴を取得するには

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

次の例では、API URI リクエストを使用して、ExampleDevice のデバイス位置履歴を ExampleTracker というトラッカーから取得します。対象期間は、2020–10–02 の 19:05:07 (この時間を含む) から 19:20:07 (この時間を含まない) です。

POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions 
Content-type: application/json
{
  "StartTimeInclusive": "2020-10-02T19:05:07.327Z",
  "EndTimeExclusive": "2020-10-02T19:20:07.327Z"
}

AWS CLI コマンドを使用してトラッカーからデバイスの位置履歴を取得するには

get-device-position-history コマンドを実行します。

次の例では、AWS CLI を使用して、ExampleDevice のデバイス位置履歴を ExampleTracker というトラッカーから取得します。対象期間は、2020–10–02 の 19:05:07 (この時間を含む) から 19:20:07 (この時間を含まない) です。

aws location \
    get-device-position-history \
        --device-id "ExampleDevice" \
        --start-time-inclusive "2020-10-02T19:05:07.327Z" \
        --end-time-exclusive "2020-10-02T19:20:07.327Z" \
        --tracker-name "ExampleTracker"

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

以下の例は、オプションのパラメータ FilterGeometry を使用して多角形エリア内のデバイス位置のリストを取得するための API リクエストです。この例では、Polygon 配列で定義されたエリア内に存在する 3 つのデバイス位置が返されます。

POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1
Content-type: application/json

{
   "FilterGeometry": {
        "Polygon": [
          [
            [
              -123.12003339442259,
              49.27425121147397
            ],
            [
              -123.1176984148229,
              49.277063620879744
            ],
            [
              -123.12389509145294,
              49.277954183760926
            ],
            [
              -123.12755921328647,
              49.27554025235713
            ],
            [
              -123.12330236586217,
              49.27211836076236
            ],
            [
              -123.12003339442259,
              49.27425121147397
            ]
          ]
        ]
    },
   "MaxResults": 3,
   "NextToken": "1234-5678-9012"
}

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

{
    "Entries": [
        {
            "DeviceId": "1",
            "SampleTime": "2022-10-24T19:09:07.327Z",
            "Position": [
                -123.12245146162303,
                49.27521118043802
            ],
            "Accuracy": {
                "Horizontal": 10
            },
            "PositionProperties": {
                "name": "device1"
            }
        },
        {
            "DeviceId": "3",
            "SampleTime": "2022-10-02T19:09:07.327Z",
            "Position": [
                -123.12325592118916,
                49.27340530543111
            ]
        },
        {
            "DeviceId": "2",
            "SampleTime": "2022-10-02T19:09:07.327Z",
            "Position": [
                -123.1230104928471,
                49.27752402723152
            ]
        }
    ],
   "NextToken": "1234-5678-9012"
}

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

以下は、多角形エリア内のデバイスのリストを取得するための AWS CLI の例です。

aws location list-device-positions TODO: add arguments add props for filter geo