列出您的裝置位置 - Amazon Location Service

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

列出您的裝置位置

您可以使用 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操作。

下列範例是使用選用參數 取得多邊形區域中裝置位置清單的 API 請求FilterGeometry。此範例會傳回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