デバイスの位置のリストを表示する - Amazon Location Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

デバイスの位置のリストを表示する

AWS CLI または Amazon Location API から、ListDevicePositions API を使用して、トラッカーのデバイスの位置のリストを表示できます。ListDevicePositions API を呼び出すと、特定のトラッカーにリンクされているすべてのデバイスの最新の位置のリストが返されます。デフォルトでは、この API は特定のトラッカーの最新のデバイス位置を結果ページごとに 100 件返します。特定の地域内のデバイスのみを返したい場合は、FilterGeometry パラメータを使用して Bounding Polygon Query を作成します。これで、ListDevicePositions を呼び出すと、ポリゴン内のデバイスのみが返されます。

注記

ユーザー自身が管理する AWS KMS 顧客管理キーを使用してデータを暗号化する場合、Bounding Polygon Queries 機能はデフォルトで無効になります。これは、この機能を使用すると、デバイスの位置情報は AWS KMS マネージドキーでは暗号化されないためです。ただし、デバイスの正確な位置は引き続き顧客管理キーを使用して暗号化されます。

Bounding Polygon Queries 機能の使用を選択することもできます。その場合は、トラッカーを作成または更新するときに KmsKeyEnableGeospatialQueries パラメータを true に設定します。

API

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

list-trackers コマンドを使用します。

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

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