Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # AWS IoT Core Ubicación del dispositivo | | | --- | | Antes de utilizar la función de ubicación del AWS IoT Core dispositivo, consulta los términos y condiciones de esta función. Tenga en cuenta que AWS puede transmitir los parámetros de su solicitud de búsqueda de geolocalización, como los datos de ubicación utilizados para realizar las búsquedas y otra información, al proveedor de datos externo que elija, que puede estar fuera del Región de AWS que está utilizando actualmente. El proveedor externo y el solucionador que se van a utilizar se eligen en función de la carga útil de entrada recibida. Para obtener más información, consulte los [Términos del servicio de AWS](https://aws.amazon.com/service-terms). | Utilice la ubicación del AWS IoT Core dispositivo para probar la ubicación de sus dispositivos de IoT mediante solucionadores de terceros. Los *solucionadores* son algoritmos proporcionados por proveedores externos que resuelven los datos de medición y estiman la ubicación del dispositivo. Al identificar la ubicación de sus dispositivos, puede rastrearlos y depurarlos sobre el terreno para solucionar cualquier problema. Los datos de medición recopilados de varios orígenes se resuelven y la información de geolocalización se presenta como una carga de [GeoJSON](https://geojson.org/). El formato GeoJSON es un formato que se utiliza para codificar estructuras de datos geográficos. La carga útil contiene las coordenadas de latitud y longitud de la ubicación del dispositivo, que se basan en el sistema de [coordenadas del Sistema Geodésico Mundial](https://gisgeography.com/wgs84-world-geodetic-system/) (). WGS84 **Topics** + [Tipos de mediciones y solucionadores](#location-measurement-types) + [Cómo funciona la ubicación del AWS IoT Core dispositivo](#location-how-works) + [Cómo utilizar la ubicación del dispositivo AWS IoT Core](#location-how-use) + [Resolver la ubicación de los dispositivos IoT](device-location-resolve-solvers.md) + [Resolución de la ubicación del dispositivo mediante los temas de ubicación del AWS IoT Core dispositivo (MQTT)](device-location-reserved-topics.md) + [Solucionadores de ubicación y carga útil del dispositivo](device-location-solvers-payload.md) ## Tipos de mediciones y solucionadores AWS IoT Core Device Location colabora con proveedores externos para resolver los datos de medición y proporcionar una ubicación estimada del dispositivo. En la siguiente tabla se muestran los tipos de medición y los solucionadores de ubicación de terceros, así como información sobre los dispositivos compatibles. Para obtener información sobre los dispositivos LoRa WAN y cómo configurar la ubicación de los dispositivos para ellos, consulte [Configurar la posición de los recursos LoRa WAN](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html). **nota** Los dispositivos IoT generales y los dispositivos Sidewalk pueden usar los temas de MQTT sobre la ubicación del dispositivo para obtener la información de ubicación. Para los tipos de medición de direcciones IP, móviles y Wi-Fi, si los dispositivos publican los datos de medición en los [temas reservados](device-location-reserved-topics.md) en el formato GeoJSON definido, la ubicación del AWS IoT Core dispositivo puede resolver la ubicación del dispositivo. Para el tipo de medición GNSS, el dispositivo debe tener el LR11xx chip para escanear los datos de medición y obtener la información de ubicación resuelta mediante el solucionador GNSS. *Para obtener información sobre cómo obtener información de ubicación para los dispositivos LoRa WAN, consulte [Configuración de la posición de los recursos LoRa WAN](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) en la AWS IoT documentación sobre redes inalámbricas.* **Tipos de mediciones y solucionadores** | Tipo de medición | Solucionadores de terceros | Dispositivos compatibles | | --- | --- | --- | | Puntos de acceso Wi-Fi | Solucionador basado en Wi-Fi | Dispositivos de IoT generales, LoRa WAN y dispositivos Amazon Sidewalk | | Torres de radio de telefonía móvil: datos GSM, LTE, CDMA, SCDMA, WCMDA y TD-SCDMA | Solucionador basado en dispositivos móviles | Dispositivos de IoT generales, LoRa WAN y dispositivos Amazon Sidewalk | | Dirección IP | Solucionador de búsqueda inversa de IP | Cualquier dispositivo de IoT que se conecte a través de TCP/IP | | Datos de escaneo GNSS (mensajes NAV) | Solucionador GNSS | Dispositivos de IoT generales, LoRa WAN y dispositivos Amazon Sidewalk | | Bluetooth de bajo consumo (BLE) | Solucionador basado en BLE | Dispositivos Amazon Sidewalk | Para obtener más información sobre los solucionadores de ubicación y ejemplos que muestran la carga del dispositivo para los distintos tipos de medición, consulte [Solucionadores de ubicación y carga útil del dispositivo](device-location-solvers-payload.md). ## Cómo funciona la ubicación del AWS IoT Core dispositivo El siguiente diagrama muestra cómo la ubicación del AWS IoT Core dispositivo recopila los datos de medición y resuelve la información de ubicación de los dispositivos. ![\[Imagen que muestra cómo la ubicación del AWS IoT Core dispositivo utiliza los datos de medición sin procesar y resuelve la ubicación del dispositivo.\]](http://docs.aws.amazon.com/es_es/iot/latest/developerguide/images/iot-device-location.png) Los siguientes pasos muestran cómo funciona la ubicación del AWS IoT Core dispositivo. 1. **Recibir los datos de medición** Los datos de medición sin procesar relacionados con la ubicación del dispositivo se envían primero desde el dispositivo. Los datos de medición se especifican como una carga JSON. 1. **Procesamiento de datos de medición** Los datos de medición se procesan y la ubicación del AWS IoT Core dispositivo elige los datos de medición que se van a utilizar, que pueden ser datos de Wi-Fi, datos móviles, escaneos GNSS o direcciones IP. 1. **Elección del solucionador** El solucionador de terceros se elige en función de los datos de medición. Por ejemplo, si los datos de medición contienen información sobre Wi-Fi y direcciones IP, elija el solucionador de Wi-Fi y el solucionador de búsqueda inversa de IP. 1. **Obtención de la ubicación resuelta** Se envía una solicitud de API a los proveedores del solucionador para solicitar que resuelvan la ubicación. AWS IoT Core A continuación, Device Location obtiene la información de geolocalización estimada de los solucionadores. 1. **Elección de la ubicación resuelta** Se comparan la información de ubicación resuelta y su precisión, y AWS IoT Core Device Location selecciona los resultados de geolocalización con la mayor precisión. 1. **Información sobre la ubicación de salida** La información de geolocalización se le envía como carga de GeoJSON. La carga útil contiene las coordenadas WGS84 geográficas, la información de precisión, los niveles de confianza y la marca temporal en la que se obtuvo la ubicación resuelta. ## Cómo utilizar la ubicación del dispositivo AWS IoT Core Los siguientes pasos muestran cómo usar la ubicación AWS IoT Core del dispositivo. 1. **Proporcione datos de medición** Especifique los datos de medición sin procesar relacionados con la ubicación del dispositivo como carga de JSON. Para recuperar los datos de medición de la carga útil, vaya a los registros del dispositivo o utilice CloudWatch Registros y copie la información de los datos de la carga útil. La carga de JSON debe contener uno o varios tipos de medición de datos. Para ver ejemplos que muestran el formato de carga de varios solucionadores, consulte [Solucionadores de ubicación y carga útil del dispositivo](device-location-solvers-payload.md). 1. **Resolver la información de ubicación** Utilice la página de [ubicación del dispositivo](https://console.aws.amazon.com/iot/home#/device-location-test) en la AWS IoT consola o la operación de la [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API, transfiera los datos de medición de la carga útil y resuelva la ubicación del dispositivo. AWS IoT Core A continuación, Device Location selecciona el solucionador con la mayor precisión e informa de la ubicación del dispositivo. Para obtener más información, consulte [Resolver la ubicación de los dispositivos IoT](device-location-resolve-solvers.md). 1. **Copiar la información de ubicación** Compruebe la información de geolocalización que resolvió AWS IoT Core Device Location y que se notificó como carga útil de GeoJSON. Puede copiar la carga útil para utilizarla con sus aplicaciones y otras aplicaciones. Servicio de AWS Por ejemplo, puedes enviar tus datos de ubicación geográfica a Amazon Location Service mediante la acción de la [Ubicación](location-rule-action.md) AWS IoT regla. Los siguientes temas muestran cómo utilizar la ubicación AWS IoT Core del dispositivo y ejemplos de la carga útil de la ubicación del dispositivo. + [Resolver la ubicación de los dispositivos IoT](device-location-resolve-solvers.md) + [Solucionadores de ubicación y carga útil del dispositivo](device-location-solvers-payload.md) # Resolver la ubicación de los dispositivos IoT Use la ubicación del AWS IoT Core dispositivo para decodificar los datos de medición de sus dispositivos y resuelva la ubicación del dispositivo con soluciones de terceros. La ubicación resuelta se genera como una carga de GeoJSON con las coordenadas geográficas y la información de precisión. Puede resolver la ubicación de su dispositivo desde la AWS IoT consola, la API AWS IoT inalámbrica o. AWS CLI **Topics** + [Resolver la ubicación del dispositivo (consola)](#location-resolve-console) + [Resolver la ubicación del dispositivo (API)](#location-resolve-api) + [Solución de errores al resolver la ubicación](#location-resolve-troubleshoot) ## Resolver la ubicación del dispositivo (consola) Para resolver la ubicación del dispositivo (consola) 1. Ve a la página de [ubicación del dispositivo](https://console.aws.amazon.com/iot/home#/device-location-test) en la AWS IoT consola. 1. Obtenga los datos de medición de la carga útil de los registros de su dispositivo o de CloudWatch los registros e introdúzcalos en la sección **Posición de resolución mediante carga útil**. El siguiente código muestra un ejemplo de carga de JSON. La carga contiene datos de medición de telefonía móvil y Wi-Fi. Si la carga contiene tipos adicionales de datos de medición, se utilizará el solucionador con la mayor precisión. Para obtener más información y ejemplos de cargas, consulte [Solucionadores de ubicación y carga útil del dispositivo](device-location-solvers-payload.md). **nota** La carga de JSON debe contener al menos un tipo de datos de medición. ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress": "54.240.198.35" }, "WiFiAccessPoints": [{ "MacAddress": "A0:EC:F9:1E:32:C1", "Rss": -77 }], "CellTowers": { "Gsm": [{ "Mcc": 262, "Mnc": 1, "Lac": 5126, "GeranCid": 16504, "GsmLocalId": { "Bsic": 6, "Bcch": 82 }, "GsmTimingAdvance": 1, "RxLevel": -110, "GsmNmr": [{ "Bsic": 7, "Bcch": 85, "RxLevel": -100, "GlobalIdentity": { "Lac": 1, "GeranCid": 1 } }] }], "Wcdma": [{ "Mcc": 262, "Mnc": 7, "Lac": 65535, "UtranCid": 14674663, "WcdmaNmr": [{ "Uarfcndl": 10786, "UtranCid": 14674663, "Psc": 149 }, { "Uarfcndl": 10762, "UtranCid": 14674663, "Psc": 211 } ] }], "Lte": [{ "Mcc": 262, "Mnc": 2, "EutranCid": 2898945, "Rsrp": -50, "Rsrq": -5, "LteNmr": [{ "Earfcn": 6300, "Pci": 237, "Rsrp": -60, "Rsrq": -6, "EutranCid": 2898945 }, { "Earfcn": 6300, "Pci": 442, "Rsrp": -70, "Rsrq": -7, "EutranCid": 2898945 } ] }] } } ``` 1. Para resolver la información de ubicación, elija **Resolver**. La información de ubicación es de tipo blob y se devuelve como una carga que utiliza el formato GeoJSON, que es un formato que se utiliza para codificar estructuras de datos geográficos. La carga contiene: + Las coordenadas WGS84 geográficas, que incluyen la información de latitud y longitud. También puede incluir información sobre la altitud. + El tipo de información de ubicación notificada, por ejemplo **Punto**. Un tipo de ubicación de punto representa la ubicación como WGS84 latitud y longitud, codificadas como un punto [GeoJSON](https://geojson.org/geojson-spec.html#point). + La información de precisión horizontal y vertical, que indica la diferencia en metros entre la información de ubicación estimada por los solucionadores y la ubicación real del dispositivo. + El nivel de confianza, que indica la incertidumbre en la respuesta a la estimación de ubicación. El valor predeterminado es 0,68, lo que indica una probabilidad del 68 % de que la ubicación real del dispositivo esté dentro del radio de incertidumbre de la ubicación estimada. + La ciudad, el estado, el país y el código postal donde se encuentra el dispositivo. Esta información solo se mostrará cuando se utilice el solucionador de búsqueda inversa de IP. + La información de marca temporal, que corresponde a la fecha y la hora a las que se ha resuelto la ubicación. Utiliza el formato de marca temporal de Unix. El siguiente código muestra un ejemplo de carga de GeoJSON devuelta al resolver la ubicación. **nota** Si la ubicación del AWS IoT Core dispositivo informa de errores al intentar resolver la ubicación, puedes solucionar los errores y resolver la ubicación. Para obtener más información, consulte [Solución de errores al resolver la ubicación](#location-resolve-troubleshoot). ``` { "coordinates": [ 13.376076698303223, 52.51823043823242 ], "type": "Point", "properties": { "verticalAccuracy": 45, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 303, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T12:23:58.189Z" } } ``` 1. Ve a la sección **Ubicación de los recursos** y verifica la información de geolocalización proporcionada por AWS IoT Core la ubicación del dispositivo. Puede copiar la carga útil para utilizarla con otras aplicaciones y aplicaciones. Servicio de AWS Por ejemplo, puede utilizar la [Ubicación](location-rule-action.md) para enviar sus datos de ubicación geográfica a Amazon Location Service. ## Resolver la ubicación del dispositivo (API) Para resolver la ubicación del dispositivo mediante la API AWS IoT inalámbrica, utilice la operación [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API o el comando [get-position-estimate](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position-estimate.html)CLI. Especifique los datos de medición de la carga como entrada y ejecute la operación de la API para resolver la ubicación del dispositivo. **nota** La operación de la API `GetPositionEstimate` no almacena información sobre ningún dispositivo o estado, y no se puede utilizar para recuperar datos de ubicación históricos. Realiza una operación única que resuelve los datos de medición y genera la ubicación estimada. Para recuperar la información de ubicación, debe especificar la información de carga cada vez que realice esta operación de la API. En el siguiente comando se muestra un ejemplo de cómo hacer esto con esta operación de la API. **nota** Al ejecutar el comando de la CLI `get-position-estimate`, debe especificar el archivo JSON de salida como primera entrada. Este archivo JSON almacenará la información de ubicación estimada obtenida como respuesta de la CLI en formato GeoJSON. Por ejemplo, el siguiente comando almacena la información de ubicación en el *locationout.json* archivo. ``` aws iotwireless get-position-estimate locationout.json \ --ip IpAddress=""54.240.198.35"" \ --wi-fi-access-points \ MacAddress="A0:EC:F9:1E:32:C1",Rss=-75 \ MacAddress="A0:EC:F9:15:72:5E",Rss=-67 ``` En este ejemplo, se incluyen los puntos de acceso Wi-Fi y la dirección IP como tipos de medición. AWS IoT Core Device Location elige entre el solucionador de Wi-Fi y el solucionador de búsqueda inversa de IP, y selecciona el solucionador con mayor precisión. La ubicación resuelta es una carga que utiliza el formato GeoJSON, que es un formato que se utiliza para codificar estructuras de datos geográficos. A continuación, se guarda en el archivo. *locationout.json* La carga útil contiene las coordenadas de WGS84 latitud y longitud, la información de precisión y nivel de confianza, el tipo de datos de ubicación y la marca de tiempo en la que se resolvió la ubicación. ``` { "coordinates": [ 13.37704086303711, 52.51865005493164 ], "type": "Point", "properties": { "verticalAccuracy": 707, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 389, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T14:03:57.391Z" } } ``` ## Solución de errores al resolver la ubicación Al intentar resolver la ubicación, es posible que aparezca alguno de los siguientes códigos de error. AWS IoT Core La ubicación del dispositivo puede generar un error al utilizar la operación de la `GetPositionEstimate` API o bien hacer referencia al número de línea correspondiente al error en la AWS IoT consola. + **Error 400** Este error indica que la ubicación del dispositivo no puede validar el formato JSON de la carga útil AWS IoT Core del dispositivo. El error puede producirse por las siguientes razones: + Los datos de medición de JSON tienen un formato incorrecto. + La carga contiene solo la información de la marca temporal. + Los parámetros de los datos de medición, como la dirección IP, no son válidos. Para resolver este error, compruebe si su JSON tiene el formato correcto y si contiene datos de uno o más tipos de medición como entrada. Si la dirección IP no es válida, para obtener información sobre cómo puede proporcionar una dirección IP válida para resolver el error, consulte [Solucionador de búsqueda inversa de IP](device-location-solvers-payload.md#location-solvers-ip). + **Error 403** Este error indica que no tienes los permisos para realizar la operación de la API o para usar la AWS IoT consola para recuperar la ubicación del dispositivo. Para resolver este error, compruebe que dispone de los permisos necesarios para realizar esta acción. Este error puede producirse si la Consola de administración de AWS sesión o el token de AWS CLI sesión han caducado. Para resolver este error, actualiza el token de sesión para usarlo o cierra sesión Consola de administración de AWS y AWS CLI, a continuación, inicia sesión con tus credenciales. + **Error 404** Este error indica que AWS IoT Core Device Location no encontró ni resolvió ninguna información de ubicación. El error puede deberse a casos como la insuficiencia de datos en la entrada de datos de medición. Por ejemplo: + La dirección MAC o la información de la torre de telefonía móvil no son suficientes. + La dirección IP no está disponible para buscar y recuperar la ubicación. + La carga de GNSS no es suficiente. Para resolver el error en estos casos, compruebe si los datos de medición contienen suficiente información necesaria para determinar la ubicación del dispositivo. + **Error 500** Este error indica que se produjo una excepción del servidor interno cuando AWS IoT Core Device Location intentó resolver la ubicación. Para intentar corregir este error, actualice la sesión y vuelva a intentar enviar los datos de medición que se van a resolver. # Resolución de la ubicación del dispositivo mediante los temas de ubicación del AWS IoT Core dispositivo (MQTT) Puede utilizar los temas de MQTT reservados para obtener la información más reciente sobre la ubicación de sus dispositivos con la función de ubicación del AWS IoT Core dispositivo. ## Formato de los temas de MQTT de ubicación de dispositivos Los temas reservados para la ubicación de AWS IoT Core dispositivos utilizan el siguiente prefijo: `$aws/device_location/{customer_device_id}/` Para crear un tema completo, primero reemplace `customer_device_id` por el identificador único que utiliza para identificar el dispositivo. Le recomendamos que especifique el`WirelessDeviceId`, por ejemplo, para los dispositivos LoRa WAN y Sidewalk`thingName`, y si el dispositivo está registrado como algo. AWS IoT A continuación, agregue el tema al código auxiliar del tema, como `get_position_estimate` o `get_position_estimate/accepted`, tal y como se muestra en la siguiente sección. **nota** `{customer_device_id}` solo puede contener letras, números y guiones. Al suscribirse a temas de ubicación de dispositivos, solo puede usar el signo más (\$1) como carácter comodín. Por ejemplo, puede usar el comodín `+` para que `{customer_device_id}` obtenga la información de ubicación de sus dispositivos. Cuando se suscribas al tema de `$aws/device_location/+/get_position_estimate/accepted`, se publicará un mensaje con la información de ubicación de los dispositivos que coincidan con cualquier ID de dispositivo si se ha resuelto correctamente. Los siguientes son los temas reservados que se utilizan para interactuar con la ubicación AWS IoT Core del dispositivo. **Temas de MQTT de ubicación de dispositivos** | Topic | Operaciones permitidas | Description (Descripción) | | --- | --- | --- | | \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Publish | Un dispositivo publica sobre este tema para que los datos de medición sin procesar escaneados se resuelvan según la ubicación del dispositivo. AWS IoT Core | | \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Suscribirse | AWS IoT Core La ubicación del dispositivo publica la información de ubicación en este tema cuando resuelve correctamente la ubicación del dispositivo. | | \$1aws/device\$1location/ /get\$1position\$1estimate/rejected *customer\$1device\$1id* | Suscribirse | AWS IoT Core La ubicación del dispositivo publica la información de error en este tema cuando no logra resolver la ubicación del dispositivo. | ## Política de los temas de MQTT de ubicación de dispositivos Para recibir mensajes relacionados con la ubicación del dispositivo, el dispositivo debe utilizar una política que le permita conectarse a la puerta de enlace del AWS IoT dispositivo y suscribirse a los temas de MQTT. A continuación se muestra un ejemplo de la política necesaria para recibir mensajes de los distintos temas. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted", "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected" ] }, { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted", "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected" ] } ] } ``` ## Temas y carga de Device Location A continuación, se muestran los temas sobre la ubicación de los AWS IoT Core dispositivos, el formato de la carga útil de sus mensajes y un ejemplo de política para cada tema. **Topics** + [/get\$1position\$1estimate](#get-position-estimate) + [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) + [/get\$1position\$1estimate/rejected](#get-position-estimate-rejected) ### /get\$1position\$1estimate Publique un mensaje sobre este tema para obtener los datos de medición sin procesar del dispositivo para resolverlos por ubicación del AWS IoT Core dispositivo. ``` $aws/device_location/customer_device_id/get_position_estimate ``` AWS IoT Core La ubicación del dispositivo responde publicando en una [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) u otra[/get\$1position\$1estimate/rejected](#get-position-estimate-rejected). **nota** El mensaje publicado en este tema debe ser una carga de JSON válida. Si el mensaje de entrada no está en un formato JSON válido, no recibirá ninguna respuesta. Para obtener más información, consulte [Carga útil del mensaje](#get-position-estimate-payload). #### Carga útil de mensaje El formato de carga útil del mensaje sigue una estructura similar a la del cuerpo de la solicitud de operación de la API AWS IoT inalámbrica, [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html). Contiene: + Una cadena `Timestamp` opcional, que corresponde a la fecha y la hora en que se resolvió la ubicación. La cadena `Timestamp` puede tener una longitud mínima de 1 y máxima de 10. + Una cadena `MessageId` opcional, que se puede utilizar para asignar la solicitud a la respuesta. Si especifica esta cadena, el mensaje publicado en los temas `get_position_estimate/accepted` o `get_position_estimate/rejected` contendrá este `MessageId`. La cadena `MessageID` puede tener una longitud mínima de 1 y máxima de 256. + Los datos de medición del dispositivo que contiene uno o más de los siguientes tipos de medición: + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html) A continuación se muestra un ejemplo de la carga del mensaje. ``` { "Timestamp": "1664313161", "MessageId": "ABCD1", "WiFiAccessPoints": [ { "MacAddress": "A0:EC:F9:1E:32:C1", "Rss": -66 } ], "Ip":{ "IpAddress": "54.192.168.0" }, "Gnss":{ "Payload":"8295A614A2029517F4F77C0A7823B161A6FC57E25183D96535E3689783F6CA48", "CaptureTime":1354393948 } } ``` #### Ejemplo de política de A continuación, mostramos un ejemplo de la política requerida: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate" ] } ] } ``` ### /get\$1position\$1estimate/accepted AWS IoT Core Device Location publica una respuesta a este tema al devolver la información de ubicación resuelta del dispositivo. La información de ubicación se devuelve en [formato GeoJSON](https://geojson.org/). ``` $aws/device_location/customer_device_id/get_position_estimate/accepted ``` A continuación se muestra la carga del mensaje y un ejemplo de política. #### Carga útil del mensaje A continuación, se muestra un ejemplo de la carga del mensaje en formato GeoJSON. Si especificó una `MessageId` en sus datos de medición sin procesar y AWS IoT Core Device Location resolvió la información de ubicación correctamente, la carga útil del mensaje devolverá la misma `MessageId` información. ``` { "coordinates": [ 13.37704086303711, 52.51865005493164 ], "type": "Point", "properties": { "verticalAccuracy": 707, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 389, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T14:03:57.391Z", "messageId": "ABCD1" } } ``` #### Ejemplo de política de A continuación, mostramos un ejemplo de la política requerida: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted" ] } ] } ``` ### /get\$1position\$1estimate/rejected AWS IoT Core La ubicación del dispositivo publica una respuesta de error sobre este tema cuando no logra resolver la ubicación del dispositivo. ``` $aws/device_location/customer_device_id/get_position_estimate/rejected ``` A continuación se muestra la carga del mensaje y un ejemplo de política. Para obtener información acerca de los errores, consulte [Solución de errores al resolver la ubicación](device-location-resolve-solvers.md#location-resolve-troubleshoot). #### Carga útil del mensaje A continuación se muestra un ejemplo de la carga útil del mensaje que proporciona el código y el mensaje de error, que indican por qué AWS IoT Core Device Location no pudo resolver la información de ubicación. Si especificó una `MessageId` al proporcionar los datos de medición sin procesar y la ubicación del AWS IoT Core dispositivo no pudo resolver la información de ubicación, se devolverá la misma `MessageId` información en la carga útil del mensaje. ``` { "errorCode": 500, "errorMessage":"Internal server error", "messageId": "ABCD1" } ``` #### Ejemplo de política de A continuación, mostramos un ejemplo de la política requerida: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected" ] } ] } ``` # Solucionadores de ubicación y carga útil del dispositivo Los solucionadores de ubicación son algoritmos que se pueden usar para resolver la ubicación de sus dispositivos de IoT. AWS IoT Core La ubicación del dispositivo admite los siguientes solucionadores de ubicaciones. Verá ejemplos del formato de carga JSON para estos tipos de mediciones, los dispositivos compatibles con el solucionador y cómo se resuelve la ubicación. Para resolver la ubicación del dispositivo, especifique uno o más de estos tipos de datos de medición. Se devolverá una única ubicación resuelta para todos los datos de medición combinados. **Topics** + [Solucionador basado en Wi-Fi](#location-solvers-wifi) + [Solucionador basado en dispositivos móviles](#location-solvers-cellular) + [Solucionador de búsqueda inversa de IP](#location-solvers-ip) + [Solucionador GNSS](#location-solvers-gnss) + [Solucionador BLE para dispositivos compatibles con Amazon Sidewalk](#location-solvers-ble) ## Solucionador basado en Wi-Fi Utilice el solucionador basado en Wi-Fi para resolver la ubicación utilizando la información escaneada de los puntos de acceso Wi-Fi. El solucionador es compatible con la tecnología WLAN y se puede usar para calcular la ubicación del dispositivo para dispositivos IoT generales que se conectan a través de TCP/IP, dispositivos inalámbricos LoRa WAN y dispositivos habilitados para Amazon Sidewalk. Los dispositivos LoRa WAN deben tener el chipset LoRa Edge, que puede decodificar la información de escaneo Wi-Fi entrante. LoRa Edge es una plataforma de consumo ultrabajo que integra un LoRa transceptor de largo alcance, un escáner GNSS multiconstelación y un escáner MAC inalámbrico pasivo destinado a aplicaciones de geolocalización. Cuando se recibe un mensaje de enlace ascendente del dispositivo, los datos del escaneo de Wi-Fi se envían a la ubicación del AWS IoT Core dispositivo y la ubicación se estima en función de los resultados del escaneo de Wi-Fi. Luego, la información descodificada se pasa al solucionador basado en Wi-Fi para recuperar la información de ubicación. Para obtener más información sobre cómo resolver los datos de ubicación de los dispositivos compatibles con Amazon Sidewalk, consulta la [guía para AWS IoT Core para Amazon Sidewalk desarrolladores](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/iot-sidewalk.html). ### Ejemplo de carga de un solucionador basado en Wi-Fi El siguiente código muestra un ejemplo de la carga JSON del dispositivo que contiene los datos de medición. Cuando AWS IoT Core Device Location recibe estos datos como entrada, envía una solicitud HTTP al proveedor del solucionador para resolver la información de ubicación. Para recuperar la información, especifique los valores de la dirección MAC y el RSS (intensidad de la señal recibida). Para ello, proporcione la carga útil JSON con este formato o utilice el parámetro [WiFiAccessPointsobject de la operación](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) de la [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. ``` { "Timestamp": 1664313161, // optional "WiFiAccessPoints": [ { "MacAddress": "A0:EC:F9:1E:32:C1", // required "Rss": -75 // required } ] } ``` ## Solucionador basado en dispositivos móviles Puede utilizar el solucionador basado en dispositivos móviles para resolver la ubicación mediante los datos de medición obtenidos de las torres de radio de telefonía móvil. El solucionador es compatible con las siguientes tecnologías. Se obtiene una única información de ubicación resuelta, incluso si incluye datos de medición de alguna o todas estas tecnologías. + GSM + CDMA + WCDMA + TD-SCDMA + LTE ### Ejemplos de carga de un solucionador basado en dispositivos móviles El siguiente código muestra ejemplos de la carga de JSON del dispositivo que contiene los datos de medición móviles. Cuando AWS IoT Core Device Location recibe estos datos como entrada, envía una solicitud HTTP al proveedor del solucionador para resolver la información de ubicación. Para recuperar la información, debe proporcionar la carga útil JSON con este formato en la consola o especificar valores para el [CellTowers](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-CellTowers)parámetro de la operación de la [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. Puede proporcionar los datos de medición especificando los valores de los parámetros mediante una o todas estas tecnologías móviles. #### LTE (evolución a largo plazo) Al utilizar estos datos de medición, debe especificar información como la red y el código de país de la red móvil, así como parámetros adicionales opcionales, incluida la información sobre el identificador local. El siguiente código muestra un ejemplo del formato de la carga. Para obtener información sobre estos parámetros, consulte [Objeto LTE](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_LteObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Lte": [ { "Mcc": int, // required "Mnc": int, // required "EutranCid": int, // required. Make sure that you use int for EutranCid. "Tac": int, // optional "LteLocalId": { // optional "Pci": int, // required "Earfcn": int, // required }, "LteTimingAdvance": int, // optional "Rsrp": int, // optional "Rsrq": float, // optional "NrCapable": boolean, // optional "LteNmr": [ // optional { "Pci": int, // required "Earfcn": int, // required "EutranCid": int, // required "Rsrp": int, // optional "Rsrq": float // optional } ] } ] } } ``` #### GSM (Sistema global de comunicaciones móviles) Cuando utilice estos datos de medición, deberá especificar información como la red y el código de país de la red móvil, la información de la estación base y parámetros adicionales opcionales. El siguiente código muestra un ejemplo del formato de la carga. Para obtener información sobre estos parámetros, consulte [Objeto GSM](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GsmObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Gsm": [ { "Mcc": int, // required "Mnc": int, // required "Lac": int, // required "GeranCid": int, // required "GsmLocalId": { // optional "Bsic": int, // required "Bcch": int, // required }, "GsmTimingAdvance": int, // optional "RxLevel": int, // optional "GsmNmr": [ // optional { "Bsic": int, // required "Bcch": int, // required "RxLevel": int, // optional "GlobalIdentity": { "Lac": int, // required "GeranCid": int // required } } ] } ] } ``` #### CDMA (Acceso múltiple por división de código) Cuando utilice estos datos de medición, deberá especificar información como la potencia de la señal y la información de identificación, la información de la estación base y parámetros adicionales opcionales. El siguiente código muestra un ejemplo del formato de la carga. Para obtener información sobre estos parámetros, consulte [Objeto CDMA](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Cdma": [ { "SystemId": int, // required "NetworkId": int, // required "BaseStationId": int, // required "RegistrationZone": int, // optional "CdmaLocalId": { // optional "PnOffset": int, // required "CdmaChannel": int, // required }, "PilotPower": int, // optional "BaseLat": float, // optional "BaseLng": float, // optional "CdmaNmr": [ // optional { "PnOffset": int, // required "CdmaChannel": int, // required "PilotPower": int, // optional "BaseStationId": int // optional } ] } ] } } ``` #### WCDMA (Acceso múltiple por división de código de banda ancha) Cuando utilice estos datos de medición, deberá especificar información como la red y el código del país, la potencia de la señal y la información de identificación, la información de la estación base y parámetros adicionales opcionales. El siguiente código muestra un ejemplo del formato de la carga. Para obtener información sobre estos parámetros, consulte [Objeto CDMA](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Wcdma": [ { "Mcc": int, // required "Mnc": int, // required "UtranCid": int, // required "Lac": int, // optional "WcdmaLocalId": { // optional "Uarfcndl": int, // required "Psc": int, // required }, "Rscp": int, // optional "Pathloss": int, // optional "WcdmaNmr": [ // optional { "Uarfcndl": int, // required "Psc": int, // required "UtranCid": int, // required "Rscp": int, // optional "Pathloss": int, // optional } ] } ] } } ``` #### TD-SCDMA (Acceso múltiple por división de código síncrono por división de tiempo) Cuando utilice estos datos de medición, deberá especificar información como la red y el código del país, la potencia de la señal y la información de identificación, la información de la estación base y parámetros adicionales opcionales. El siguiente código muestra un ejemplo del formato de la carga. Para obtener información sobre estos parámetros, consulte [Objeto CDMA](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Tdscdma": [ { "Mcc": int, // required "Mnc": int, // required "UtranCid": int, // required "Lac": int, // optional "TdscdmaLocalId": { // optional "Uarfcn": int, // required "CellParams": int, // required }, "TdscdmaTimingAdvance": int, // optional "Rscp": int, // optional "Pathloss": int, // optional "TdscdmaNmr": [ // optional { "Uarfcn": int, // required "CellParams": int, // required "UtranCid": int, // optional "Rscp": int, // optional "Pathloss": int, // optional } ] } ] } } ``` ## Solucionador de búsqueda inversa de IP Puede utilizar el solucionador de búsqueda inversa de IP para resolver la ubicación utilizando la dirección IP como entrada. El solucionador puede obtener la información de ubicación de los dispositivos aprovisionados. AWS IoT Especifique la información de la dirección IP mediante un formato que sea el patrón IPv6 estándar IPv4 o el patrón comprimido IPv6 hexadecimal. A continuación, obtendrá la estimación de la ubicación resuelta, que incluye información adicional, como la ciudad y el país donde se encuentra el dispositivo. **nota** Al utilizar la búsqueda inversa de IP, aceptas no utilizarla con el fin de identificar o localizar un hogar o una dirección postal específicos. ### Ejemplo de carga de un solucionador de búsqueda inversa de IP El siguiente código muestra un ejemplo de la carga JSON del dispositivo que contiene los datos de medición. Cuando AWS IoT Core Device Location recibe la información de la dirección IP de los datos de medición, busca esta información en la base de datos del proveedor del solucionador, que luego se utiliza para resolver la información de ubicación. Para recuperar la información, proporcione la carga útil JSON con este formato o especifique valores para el parámetro [IP de la operación](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Ip) de la [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. **nota** Cuando se utiliza este solucionador, además de las coordenadas, también se indica la ciudad, el estado, el país y el código postal en los que se encuentra el dispositivo. Para ver un ejemplo, consulta [Resolver la ubicación del dispositivo (consola)](device-location-resolve-solvers.md#location-resolve-console). ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress":"54.240.198.35" } } ``` ## Solucionador GNSS Utilice el solucionador GNSS (Sistema global de navegación por satélite) para recuperar la ubicación del dispositivo utilizando la información contenida en los mensajes de los resultados del escaneo GNSS o en los mensajes NAV. Si lo desea, puede proporcionar información de asistencia GNSS adicional, lo que reduce el número de variables que el solucionador debe utilizar para buscar señales. Al proporcionar esta información de asistencia, que incluye la posición, la altitud y la información sobre el tiempo de captura y la precisión, el solucionador puede identificar fácilmente los satélites a la vista y calcular la ubicación del dispositivo. Este solucionador se puede usar con dispositivos LoRa WAN y dispositivos habilitados para Amazon Sidewalk, así como con otros dispositivos que se hayan aprovisionado con dispositivos de AWS IoT que se hayan aprovisionado. AWS IoT Para los dispositivos IoT generales, si los dispositivos admiten la estimación de ubicación mediante GNSS, cuando se recibe la información de escaneo GNSS del dispositivo, los transceptores resuelven la información de ubicación. En el caso de los dispositivos LoRa WAN, los dispositivos deben tener el chipset Edge. LoRa Cuando se recibe un mensaje de enlace ascendente desde el dispositivo, los datos del escaneo GNSS se envían a la LoRa WAN o a AWS IoT AWS IoT Amazon Sidewalk, y la ubicación se estima en función de los resultados del escaneo de los transceptores. ### Ejemplo de carga útil de un solucionador GNSS El siguiente código muestra un ejemplo de la carga JSON del dispositivo que contiene los datos de medición. Cuando AWS IoT Core Device Location recibe la información de escaneo GNSS que contiene la carga útil incluida en los datos de medición, utiliza los transceptores y cualquier información de asistencia adicional incluida para buscar señales y resolver la información de ubicación. Para recuperar la información, proporcione la carga útil JSON con este formato o especifique valores para el parámetro [GNSS de la operación de la API. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Gnss) **nota** Para que la ubicación del AWS IoT Core dispositivo pueda resolver la ubicación del dispositivo, debe eliminar el byte de destino de la carga útil. ``` { "Timestamp": 1664313161, // optional "Gnss": { "AssistAltitude": number, // optional "AssistPosition": [ number ], // optional "CaptureTime": number, // optional "CaptureTimeAccuracy": number, // optional "Payload": "string", // required "Use2DSolver": boolean // optional } } ``` ## Solucionador BLE para dispositivos compatibles con Amazon Sidewalk **nota** En el caso de la ubicación basada en Bluetooth Low Energy, AWS IoT devuelve las coordenadas de ubicación en función de la ubicación aproximada de los Sidewalk Gateways cercanos que estén conectados a Amazon Sidewalk y tengan habilitada la función de búsqueda de comunidades. Los datos de ubicación de Gateway son AWS contenido y se le proporcionan únicamente con el fin de ayudarlo a localizar los dispositivos que están conectados a Amazon Sidewalk, y solo debe usar los datos para ese propósito. Solo debe usar los datos de ubicación y acceder a ellos a través de la interfaz y la funcionalidad que generalmente ponemos a su disposición, y no debe intentar volver a identificar, aplicar ingeniería inversa o volver a mapear los datos de ubicación de Gateway que le proporcionemos. Los dispositivos finales de Amazon Sidewalk que se conecten a través de ellos AWS IoT Core para Amazon Sidewalk pueden resolver sus datos de ubicación mediante mensajes de enlace ascendente BLE, Wi-Fi o GNSS publicados por el dispositivo final de Amazon Sidewalk. [Para obtener más información, consulte la guía para desarrolladores.AWS IoT Core para Amazon Sidewalk](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/sidewalk-getting-started.html)