列出您的设备位置 - Amazon Location Service

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

列出您的设备位置

您可以使用 AWS CLI 或 Amazon Location API，通过 ListDevicePositions API 查看跟踪器的设备位置列表。当您调用 ListDevicePositions API 时，系统会返回与给定跟踪器关联的所有设备的最新位置列表。默认情况下，此 API 会在给定跟踪器的每页结果中返回 100 个最新的设备位置。要仅返回特定区域内的设备，请使用 FilterGeometry 参数创建“边界多边形查询”。这样，当您调用 listDevicePositions 时，只会返回多边形内的设备。

注意

如果您希望使用自己的 AWS KMS 客户托管密钥加密数据，则默认情况下将禁用“边界多边形查询”功能。这是因为使用此功能，您的设备位置表示不会使用您的 AWS KMS 托管密钥进行加密。但是，设备的确切位置仍使用您的托管密钥进行加密。

您可以选择加入“边界多边形查询”功能。这是通过在创建或更新跟踪器时将 KmsKeyEnableGeospatialQueries 参数设置为 true 来完成的。

API

使用 Amazon Location 跟踪器 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