本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出您的裝置位置
<a name="list-device-positions"></a>

您可以使用 AWS CLI或 Amazon Location APIs 搭配 ListDevicePositions API 檢視追蹤器的清單裝置位置。當您呼叫 ListDevicePositions API 時，會傳回與指定追蹤器關聯之所有裝置的最新位置清單。根據預設，此 API 會傳回指定追蹤器每頁結果的 100 個最新裝置位置。若要只傳回特定區域內的裝置，請使用 `FilterGeometry` 參數來建立邊界多邊形查詢。這樣當您呼叫 ListDevicePositions 時，只會傳回多邊形內的裝置。

**注意**  
如果您想要使用自己的 AWS KMS 客戶受管金鑰加密資料，則邊界多邊形查詢功能預設為停用。這是因為使用此功能時，不會使用您的 AWS KMS 受管金鑰來加密裝置位置的表示。不過，確切的裝置位置； 仍會使用您的受管金鑰加密。  
您可以選擇加入邊界多邊形查詢功能。方法是在建立或更新追蹤器時，將 `KmsKeyEnableGeospatialQueries` 參數設定為 true。

------
#### [ API ]

從 Amazon Location Trackers APIs使用 `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`操作。

下列範例是使用選用參數 取得多邊形區域中裝置位置清單的 API 請求`[FilterGeometry](https://docs.aws.amazon.com/)`。此範例會傳回`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](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`：

```
{
    "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](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)` 命令。

下列範例是 AWS CLI ，以取得多邊形區域中的裝置清單。

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

------