As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Solucionadores de localização e carga do dispositivo Os solucionadores de localização são algoritmos que podem ser usados para resolver a localização de seus dispositivos de IoT. AWS IoT Core A localização do dispositivo é compatível com os seguintes solucionadores de localização. Você verá exemplos do formato de carga JSON para esses tipos de medição, os dispositivos suportados pelo solucionador e como a localização é resolvida. Para resolver o local do dispositivo, especifique um ou mais desses tipos de dados de medição. Uma única localização resolvida será retornada para todos os dados de medição combinados. **Topics** + [Solucionador baseado em Wi-Fi](#location-solvers-wifi) + [Solucionador baseado em celular](#location-solvers-cellular) + [Solucionador de pesquisa reversa de IP](#location-solvers-ip) + [Solucionador GNSS](#location-solvers-gnss) + [Solucionador BLE para dispositivos habilitados para Amazon Sidewalk](#location-solvers-ble) ## Solucionador baseado em Wi-Fi Use o solucionador baseado em Wi-Fi para resolver a localização usando as informações de varredura dos pontos de acesso Wi-Fi. O solucionador suporta a tecnologia WLAN e pode ser usado para calcular a localização do dispositivo para dispositivos IoT gerais conectados por TCP/IP, dispositivos LoRa sem fio WAN e dispositivos habilitados para Amazon Sidewalk. Os dispositivos LoRa WAN devem ter o chipset LoRa Edge, que pode decodificar as informações de digitalização Wi-Fi recebidas. LoRa O Edge é uma plataforma de potência ultrabaixa que integra um LoRa transceptor de longo alcance, um scanner GNSS de várias constelações e um scanner MAC Wi-Fi passivo voltado para aplicativos de geolocalização. Quando uma mensagem de uplink é recebida do dispositivo, os dados da varredura de Wi-Fi são enviados para a Localização do AWS IoT Core dispositivo, e a localização é estimada com base nos resultados da verificação de Wi-Fi. As informações decodificadas são passadas para o solucionador baseado em Wi-Fi para recuperar as informações de localização. Para saber mais sobre como resolver dados de localização para dispositivos habilitados para Amazon Sidewalk, visite o guia do [AWS IoT Core para Amazon Sidewalk desenvolvedor](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/iot-sidewalk.html). ### Exemplo de carga de solucionador baseado em Wi-Fi O código a seguir mostra um exemplo da carga JSON do dispositivo que contém os dados de medição. Quando AWS IoT Core o Device Location recebe esses dados como entrada, ele envia uma solicitação HTTP ao provedor do solucionador para resolver as informações de localização. Para recuperar as informações, especifique valores para o endereço MAC e intensidade do sinal recebido (RSS). Para fazer isso, forneça a carga JSON usando esse formato ou use o parâmetro de [WiFiAccessPointsobjeto](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) da operação da [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 baseado em celular Você pode usar o solucionador baseado em celular para resolver a localização usando dados de medição obtidos das torres de rádio celular. O solucionador oferece suporte às tecnologias a seguir. Uma única informação de localização resolvida é obtida, mesmo se você incluir dados de medição de qualquer uma ou de todas essas tecnologias. + GSM + CDMA + WCDMA + TD-SCDMA + LTE ### Exemplos de carga de solucionador baseado em celular O código a seguir mostra um exemplo da carga JSON do dispositivo que contém os dados de medição celular. Quando AWS IoT Core o Device Location recebe esses dados como entrada, ele envia uma solicitação HTTP ao provedor do solucionador para resolver as informações de localização. Para recuperar as informações, você fornece a carga JSON usando esse formato no console ou especifica valores para o [CellTowers](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-CellTowers)parâmetro da operação da [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. Você pode fornecer os dados de medição especificando valores para parâmetros usando qualquer uma ou todas essas tecnologias celulares. #### Evolução de longo prazo (LTE) Ao usar esses dados de medição, você deve especificar informações como a rede e o código do país da rede móvel e parâmetros adicionais opcionais, incluindo informações sobre o ID da localização. Veja a seguir um exemplo do formato da carga. Para mais informações sobre esses 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 } ] } ] } } ``` #### Sistema Global de Comunicações Móveis (GSM) Ao usar esses dados de medição, você deve especificar informações como a rede e o código do país da rede móvel, informações de estação base e parâmetros adicionais opcionais. Veja a seguir um exemplo do formato da carga. Para obter mais informações sobre esses 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 } } ] } ] } ``` #### Acesso múltiplo por divisão de código (CDMA) Ao usar esses dados de medição, você deve especificar informações, como a potência do sinal e informações de identificação, da estação base e parâmetros adicionais opcionais. Veja a seguir um exemplo do formato da carga. Para obter mais informações sobre esses 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 } ] } ] } } ``` #### Acesso múltiplo por divisão de código de ondas longas (CDMA) Ao usar esses dados de medição, você deve especificar informações, como o código de rede e do país, potência do sinal e informações de identificação, da estação base e parâmetros adicionais opcionais. Veja a seguir um exemplo do formato da carga. Para obter mais informações sobre esses 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 } ] } ] } } ``` #### Acesso múltiplo por divisão de código síncrona por divisão de tempo (TD-SCDMA) Ao usar esses dados de medição, você deve especificar informações, como o código de rede e do país, potência do sinal e informações de identificação, da estação base e parâmetros adicionais opcionais. Veja a seguir um exemplo do formato da carga. Para obter mais informações sobre esses 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 pesquisa reversa de IP Você pode usar o solucionador de pesquisa reversa de IP para resolver a localização usando o endereço IP como entrada. O solucionador pode obter as informações de localização dos dispositivos que foram provisionados com. AWS IoT Especifique as informações do endereço IP usando um formato que seja o IPv6 padrão padrão IPv4 ou o padrão comprimido IPv6 hexadecimal. Em seguida, você obtém a estimativa de localização resolvida, incluindo informações adicionais, como cidade e país onde o dispositivo está localizado. **nota** Ao usar a pesquisa reversa de IP, você concorda em não usá-la com a finalidade de identificar ou localizar uma residência específica ou um endereço. ### Exemplo de carga do solucionador de pesquisa reversa de IP O código a seguir mostra um exemplo da carga JSON do dispositivo que contém os dados de medição. Quando o AWS IoT Core Device Location recebe as informações do endereço IP nos dados de medição, ele consulta essas informações no banco de dados do provedor do solucionador, que é então usado para resolver as informações de localização. Para recuperar as informações, forneça a carga JSON usando esse formato ou especifique valores para o parâmetro [Ip da operação](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Ip) da [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API. **nota** Quando esse solucionador é usado, a cidade, o estado, o país e o código postal em que o dispositivo está localizado também são informados, além das coordenadas. Para ver um exemplo, consulte [Como resolver o local do dispositivo (console)](device-location-resolve-solvers.md#location-resolve-console). ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress":"54.240.198.35" } } ``` ## Solucionador GNSS Use o solucionador Sistema de navegação por satélite (GNSS) para recuperar o local do dispositivo usando as informações contidas nas mensagens de resultado de varredura de GNSS ou nas mensagens NAV. Opcionalmente, você pode fornecer informações adicionais de assistência GNSS, o que reduz o número de variáveis que o solucionador deve usar para pesquisar sinais. Ao fornecer essas informações de assistência, que incluem a posição, a altitude, o tempo de captura e as informações de precisão, o solucionador pode identificar facilmente os satélites à vista e calcular o local do dispositivo. Esse solucionador pode ser usado com dispositivos LoRa WAN e dispositivos habilitados para Amazon Sidewalk, bem como outros dispositivos que foram provisionados com dispositivos de AWS IoT que foram provisionados com. AWS IoT Para dispositivos IoT gerais, se os dispositivos são compatíveis com a estimativa de localização usando GNSS, quando as informações de varredura de GNSS são recebidas do dispositivo, os transceptores resolvem as informações de local. Para dispositivos LoRa WAN, os dispositivos devem ter o chipset LoRa Edge. Quando uma mensagem de uplink é recebida do dispositivo, os dados de escaneamento GNSS são enviados para a LoRa WAN ou AWS IoT para o AWS IoT Amazon Sidewalk, e a localização é estimada com base nos resultados da verificação dos transceptores. ### Exemplo de carga do solucionador GNSS O código a seguir mostra um exemplo da carga JSON do dispositivo que contém os dados de medição. Quando o AWS IoT Core Device Location recebe as informações de varredura GNSS contendo a carga nos dados de medição, ele usa os transceptores e qualquer informação de assistência adicional incluída para pesquisar sinais e resolver as informações de localização. Para recuperar as informações, forneça a carga JSON usando esse formato ou especifique valores para o parâmetro [Gnss da operação](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Gnss) da API. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) **nota** Antes AWS IoT Core que a localização do dispositivo possa resolver a localização do dispositivo, você deve remover o byte de destino da carga. ``` { "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 habilitados para Amazon Sidewalk **nota** Para localização baseada em Bluetooth Low Energy, AWS IoT retorna as coordenadas de localização com base na localização aproximada dos Sidewalk Gateways próximos que estão conectados ao Amazon Sidewalk e têm o recurso Community Finding ativado. Os dados de localização do gateway são AWS conteúdo e são fornecidos a você exclusivamente com a finalidade de ajudá-lo a localizar seus dispositivos conectados ao Amazon Sidewalk, e você só deve usar os dados para essa finalidade. Você só deve usar e acessar os dados de localização por meio da interface e da funcionalidade que geralmente disponibilizamos para você, e não deve tentar reidentificar, fazer engenharia reversa ou remapear quaisquer dados de localização do Gateway fornecidos por nós a você. Os dispositivos finais do Amazon Sidewalk conectados AWS IoT Core para Amazon Sidewalk podem resolver seus dados de localização usando mensagens de uplink BLE, Wi-Fi ou GNSS publicadas pelo dispositivo final Amazon Sidewalk. Para obter mais informações, consulte o [guia do AWS IoT Core para Amazon Sidewalk desenvolvedor](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/sidewalk-getting-started.html).