

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.

# Solucionadores de ubicación y carga útil del dispositivo
<a name="device-location-solvers-payload"></a>

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
<a name="location-solvers-wifi"></a>

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
<a name="location-solvers-wifi-payload"></a>

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
<a name="location-solvers-cellular"></a>

 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
<a name="location-solvers-cellular-payload"></a>

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)
<a name="location-solvers-cellular-lte"></a>

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)
<a name="location-solvers-cellular-gsm"></a>

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)
<a name="location-solvers-cellular-cdma"></a>

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)
<a name="location-solvers-cellular-wcdma"></a>

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)
<a name="location-solvers-cellular-tdscdma"></a>

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
<a name="location-solvers-ip"></a>

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
<a name="location-solvers-ip-payload"></a>

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
<a name="location-solvers-gnss"></a>

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
<a name="location-solvers-gnss-payload"></a>

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
<a name="location-solvers-ble"></a>

**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)