Enumerar las posiciones de sus dispositivos - Amazon Location Service

Enumerar las posiciones de sus dispositivos

Puede ver una lista de las posiciones de los dispositivos de un rastreador mediante la AWS CLI o las API de Amazon Location, con la API ListDevicePositions. Cuando llama a la API ListDevicePositions, se muestra una lista de las últimas posiciones de todos los dispositivos asociados a un rastreador determinado. De forma predeterminada, esta API devuelve 100 de las últimas posiciones de los dispositivos por página de resultados de un rastreador determinado. Para devolver solo los dispositivos de una región específica, use el parámetro FilterGeometry para crear una consulta de polígonos delimitadores. De esta forma, cuando llame a ListDevicePositions, solo se devolverán los dispositivos que se encuentren dentro del polígono.

nota

Si desea cifrar sus datos con su propia clave gestionada por el cliente de AWS KMS, la característica Consultas a polígonos delimitadores estará desactivada de forma predeterminada. Esto se debe a que, al utilizar esta característica, una representación de las posiciones de los dispositivos no se cifrará con la clave administrada de AWS KMS. Sin embargo, la posición exacta del dispositivo sigue cifrada con su clave gestionada.

Puede optar por activar la característica Consultas de polígonos delimitadores. Esto se hace configurando el parámetro KmsKeyEnableGeospatialQueries en «verdadero» al crear o actualizar un rastreador.

API

Use la operación ListDevicePositions de las API de Amazon Location Trackers.

El siguiente ejemplo es una solicitud de API para obtener una lista de las posiciones de los dispositivos en un área poligonal mediante el parámetro opcional FilterGeometry. El ejemplo devuelve 3 ubicaciones de dispositivos presentes en el área definida por la matriz Polygon.

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

A continuación se muestra un ejemplo de respuesta para 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

Utilice el comando list-trackers.

El siguiente ejemplo es una AWS CLI para obtener una lista de dispositivos en un área poligonal. 

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