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

# デバイスの位置のリストを表示する
<a name="list-device-positions"></a>

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

**注記**  
独自の AWS KMS カスタマーマネージドキーを使用してデータを暗号化する場合、バウンディングポリゴンクエリ機能はデフォルトで無効になります。これは、この機能を使用すると、デバイスの位置の表現が AWS KMS マネージドキーを使用して暗号化されないためです。ただし、デバイスの正確な位置は引き続き顧客管理キーを使用して暗号化されます。  
Bounding Polygon Queries 機能の使用を選択することもできます。その場合は、トラッカーを作成または更新するときに `KmsKeyEnableGeospatialQueries` パラメータを true に設定します。

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

Amazon Location Trackers API の `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` オペレーションを使用してください。

以下の例は、オプションのパラメータ `[FilterGeometry](https://docs.aws.amazon.com/)` を使用して多角形エリア内のデバイス位置のリストを取得するための 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](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
```

------