Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # AWS IoT Core Ubicazione del dispositivo | | | --- | | Prima di utilizzare la funzione di localizzazione del AWS IoT Core dispositivo, consulta i Termini e condizioni di questa funzione. Tieni presente che AWS potrebbe trasmettere i parametri della richiesta di ricerca di geolocalizzazione, come i dati sulla posizione utilizzati per eseguire le ricerche, e altre informazioni al fornitore di dati terzo prescelto, che potrebbe essere diverso da Regione AWS quello che stai utilizzando attualmente. Il provider terzo e il solutore da utilizzare vengono scelti in base al payload di input ricevuto. Per ulteriori informazioni, consultare [Termini del servizio AWS](https://aws.amazon.com/service-terms). | Usa AWS IoT Core Device Location per testare la posizione dei tuoi dispositivi IoT utilizzando solutori di terze parti. I *risolutori* sono algoritmi forniti da fornitori di terze parti che risolvono i dati di misurazione e stimano la posizione del dispositivo. Identificando la posizione dei dispositivi, è possibile monitorarli ed eseguirne il debug in loco per risolvere eventuali problemi. I dati di misurazione raccolti da varie fonti vengono risolti e le informazioni di geolocalizzazione vengono riportate come un payload [GeoJSON](https://geojson.org/). Il formato GeoJSON viene utilizzato per codificare strutture di dati geografici. Il payload contiene le coordinate di latitudine e longitudine della posizione del dispositivo, che si basano sul sistema di coordinate del [World Geodetic](https://gisgeography.com/wgs84-world-geodetic-system/) System (). WGS84 **Topics** + [Tipi di misurazione e risolutori](#location-measurement-types) + [Come funziona AWS IoT Core Device Location](#location-how-works) + [Come usare Device Location AWS IoT Core](#location-how-use) + [Risoluzione della posizione di dispositivi IoT](device-location-resolve-solvers.md) + [Risoluzione della posizione del dispositivo utilizzando gli argomenti MQTT di AWS IoT Core Device Location](device-location-reserved-topics.md) + [Risolutori di posizione e payload del dispositivo](device-location-solvers-payload.md) ## Tipi di misurazione e risolutori AWS IoT Core Device Location collabora con fornitori terzi per risolvere i dati di misurazione e fornire una posizione stimata del dispositivo. Nella tabella seguente vengono visualizzati i tipi di misurazione e i risolutori di posizione di terze parti, nonché le informazioni sui dispositivi supportati. Per informazioni sui dispositivi LoRa WAN e sulla configurazione della posizione dei dispositivi per essi, vedere [Configurazione della posizione delle LoRa](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) risorse WAN. **Nota** I dispositivi IoT generici e i dispositivi Sidewalk possono utilizzare gli argomenti MQTT sulla posizione dei dispositivi per ottenere informazioni sulla posizione. Per i tipi di misurazione degli indirizzi Wi-Fi, cellulare e IP, se i dispositivi pubblicano i dati di misurazione negli [argomenti riservati](device-location-reserved-topics.md) nel formato GeoJSON definito AWS IoT Core , Device Location può risolvere la posizione del dispositivo. Per il tipo di misurazione GNSS, il dispositivo deve disporre del LR11xx chip per scansionare i dati di misurazione per ottenere le informazioni sulla posizione risolte utilizzando il risolutore GNSS. *Per informazioni su come ottenere informazioni sulla posizione dei dispositivi LoRa WAN, vedere [Configurazione della posizione per le risorse LoRa WAN](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) nella documentazione Wireless.AWS IoT * **Tipi di misurazione e risolutori** | Tipo di misurazione | Risolutori di terze parti | Dispositivi supportati | | --- | --- | --- | | Punti di accesso Wi-Fi | Risolutore basato su Wi-Fi | Dispositivi IoT generici, LoRa WAN e dispositivi Amazon Sidewalk | | Torri radio della rete cellulare: dati GSM, LTE, CDMA, SCDMA, WCMDA e TD-SCDMA | Risolutore basato su rete cellulare | Dispositivi IoT generici, LoRa WAN e dispositivi Amazon Sidewalk | | IP address (Indirizzo IP) | Risolutore di ricerca inversa IP | Qualsiasi dispositivo IoT che si connette tramite TCP/IP | | Dati di scansione GNSS (messaggi NAV) | Risolutore GNSS | Dispositivi IoT generici, LoRa WAN e dispositivi Amazon Sidewalk | | Bluetooth Low Energy (BLE) | Risolutore basato su BLE | Dispositivi Amazon Sidewalk | Per ulteriori informazioni sui risolutori di posizione ed esempi che mostrano il payload del dispositivo per i vari tipi di misurazione, consulta [Risolutori di posizione e payload del dispositivo](device-location-solvers-payload.md). ## Come funziona AWS IoT Core Device Location Il diagramma seguente mostra come AWS IoT Core Device Location raccoglie i dati di misurazione e risolve le informazioni sulla posizione dei dispositivi. ![\[Immagine che mostra come AWS IoT Core Device Location utilizza i dati di misurazione non elaborati e risolve la posizione del dispositivo.\]](http://docs.aws.amazon.com/it_it/iot/latest/developerguide/images/iot-device-location.png) I passaggi seguenti mostrano come funziona AWS IoT Core Device Location. 1. **Ricezione dei dati di misurazione** I dati di misurazione non elaborati correlati alla posizione del dispositivo vengono innanzitutto inviati dal dispositivo. I dati di misurazione sono specificati come un payload JSON. 1. **Elaborazione dei dati di misurazione** I dati di misurazione vengono elaborati e AWS IoT Core Device Location sceglie i dati di misurazione da utilizzare, che possono essere informazioni Wi-Fi, cellulare, scansione GNSS o informazioni sull'indirizzo IP. 1. **Scelta del risolutore** Il risolutore di terze parti viene scelto in base ai dati di misurazione. Ad esempio, se i dati di misurazione contengono informazioni su Wi-Fi e indirizzo IP, viene scelto il risolutore Wi-Fi e il risolutore di ricerca inversa IP. 1. **Ottenere la posizione risolta** Una richiesta API viene inviata ai fornitori di solver che richiedono di risolvere la posizione. AWS IoT Core Device Location ottiene quindi le informazioni di geolocalizzazione stimate dai solutori. 1. **Scelta della posizione risolta** Le informazioni sulla posizione risolte e la relativa precisione vengono confrontate e AWS IoT Core Device Location sceglie i risultati di geolocalizzazione con la massima precisione. 1. **Generazione delle informazioni sulla posizione** Le informazioni di geolocalizzazione vengono inviate all'utente come un payload GeoJSON. Il payload contiene le coordinate geografiche, le informazioni WGS84 sulla precisione, i livelli di confidenza e il timestamp in cui è stata ottenuta la posizione risolta. ## Come usare Device Location AWS IoT Core I passaggi seguenti mostrano come utilizzare AWS IoT Core Device Location. 1. **Fornire dati di misurazione** Specificare i dati di misurazione grezzi relativi alla posizione del dispositivo come un payload JSON. Per recuperare i dati di misurazione del payload, accedi ai registri del dispositivo o utilizza CloudWatch Logs e copia le informazioni sui dati del payload. Il payload JSON deve contenere uno o più tipi di dati di misurazione. Per esempi che mostrano il formato di payload per vari risolutori, consulta [Risolutori di posizione e payload del dispositivo](device-location-solvers-payload.md). 1. **Risolvere le informazioni sulla posizione** Utilizzando la pagina [Device Location](https://console.aws.amazon.com/iot/home#/device-location-test) nella AWS IoT console o il funzionamento dell'[GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API, trasmetti i dati di misurazione del payload e risolvi la posizione del dispositivo. AWS IoT Core Device Location sceglie quindi il solutore con la massima precisione e riporta la posizione del dispositivo. Per ulteriori informazioni, consulta [Risoluzione della posizione di dispositivi IoT](device-location-resolve-solvers.md). 1. **Copiare le informazioni sulla posizione** Verifica le informazioni di geolocalizzazione che sono state risolte da AWS IoT Core Device Location e riportate come payload GeoJSON. Puoi copiare il payload per utilizzarlo con le tue applicazioni e altri file. Servizio AWS Ad esempio, puoi inviare i dati della tua posizione geografica ad Amazon Location Service utilizzando l'azione della [Location (Ubicazione)](location-rule-action.md) AWS IoT regola. I seguenti argomenti mostrano come utilizzare AWS IoT Core Device Location ed esempi di payload di localizzazione del dispositivo. + [Risoluzione della posizione di dispositivi IoT](device-location-resolve-solvers.md) + [Risolutori di posizione e payload del dispositivo](device-location-solvers-payload.md) # Risoluzione della posizione di dispositivi IoT Utilizzate AWS IoT Core Device Location per decodificare i dati di misurazione dai dispositivi e risolvere la posizione del dispositivo utilizzando solutori di terze parti. La posizione risolta viene generata come un payload GeoJSON con le coordinate geografiche e le informazioni sulla precisione. Puoi determinare la posizione del dispositivo dalla AWS IoT console, dall'API AWS IoT wireless o. AWS CLI **Topics** + [Risoluzione della posizione del dispositivo (console)](#location-resolve-console) + [Risoluzione della posizione del dispositivo (API)](#location-resolve-api) + [Risoluzione dei problemi relativi alla risoluzione della posizione](#location-resolve-troubleshoot) ## Risoluzione della posizione del dispositivo (console) Per risolvere la posizione del dispositivo (console) 1. Vai alla pagina di [localizzazione del dispositivo](https://console.aws.amazon.com/iot/home#/device-location-test) nella AWS IoT console. 1. Ottieni i dati di misurazione del carico utile dai registri del dispositivo o dai CloudWatch registri e inseriscili nella sezione **Risolvi la posizione tramite** payload. Il codice riportato di seguito mostra un payload JSON di esempio. Il payload contiene dati di misurazione della rete cellulare e Wi-Fi. Se il payload contiene altri tipi di dati di misurazione, verrà utilizzato il risolutore con la precisione maggiore. Per ulteriori informazioni ed esempi di payload, consulta [Risolutori di posizione e payload del dispositivo](device-location-solvers-payload.md). **Nota** Il payload JSON deve contenere almeno un tipo di dati di misurazione. ``` { "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. Per risolvere le informazioni sulla posizione, scegli **Resolve** (Risolvi). Le informazioni sulla posizione sono di tipo blob e vengono restituite come un payload che utilizza il formato GeoJSON, ideale per codificare strutture di dati geografici. Il payload contiene: + Le coordinate geografiche, che includono le informazioni WGS84 sulla latitudine e la longitudine. Potrebbe anche includere un'informazione di altitudine. + Il tipo di informazioni sulla posizione restituite, ad esempio **Point** (Punto). [Un tipo di posizione del punto rappresenta la posizione come WGS84 latitudine e longitudine, codificata come punto GeoJSON.](https://geojson.org/geojson-spec.html#point) + Le informazioni di precisione orizzontale e verticale, che indicano la differenza, espressa in metri, tra le informazioni sulla posizione stimate dai risolutori e la posizione effettiva del dispositivo. + Il livello di affidabilità, che indica l'incertezza nella risposta della stima sulla posizione. Il valore predefinito è 0,68, che indica una probabilità del 68% che la posizione effettiva del dispositivo sia compresa nel raggio di incertezza della posizione stimata. + La città, lo stato, il Paese e il codice postale in cui si trova il dispositivo. Queste informazioni verranno riportate solo quando viene utilizzato il risolutore di ricerca inversa IP. + Le informazioni sul timestamp, che corrisponde alla data e ora in cui la posizione è stata risolta. Viene utilizzato il formato timestamp Unix. Il codice riportato di seguito mostra un payload GeoJSON di esempio restituito risolvendo la posizione. **Nota** Se AWS IoT Core Device Location segnala errori durante il tentativo di risolvere la posizione, puoi risolvere gli errori e risolvere la posizione. Per ulteriori informazioni, consulta [Risoluzione dei problemi relativi alla risoluzione della posizione](#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. Vai alla sezione **Posizione delle risorse** e verifica le informazioni di geolocalizzazione riportate da Device Location. AWS IoT Core È possibile copiare il payload per utilizzarlo con altre applicazioni e applicazioni. Servizio AWS Ad esempio, è possibile utilizzare la [Location (Ubicazione)](location-rule-action.md) per inviare i dati relativi alla posizione geografica al servizio di posizione Amazon. ## Risoluzione della posizione del dispositivo (API) Per risolvere la posizione del dispositivo utilizzando l'API AWS IoT wireless, utilizza l'operazione [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API o il comando [get-position-estimate](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position-estimate.html)CLI. Specificare i dati di misurazione del payload come input ed eseguire l'operazione API per risolvere la posizione del dispositivo. **Nota** L'operazione API `GetPositionEstimate` non memorizza alcuna informazione sul dispositivo o sullo stato e non può essere utilizzata per recuperare dati storici sulla posizione. Esegue un'operazione una tantum che risolve i dati di misurazione e produce la posizione stimata. Per recuperare le informazioni sulla posizione, è necessario specificare le informazioni sul payload ogni volta che si esegue questa operazione API. Il seguente comando mostra un esempio di come risolvere la posizione mediante questa operazione API. **Nota** Durante l'esecuzione del comando dell'interfaccia a riga di comando `get-position-estimate`, è necessario specificare il file JSON di output come il primo input. Questo file JSON archivierà le informazioni sulla posizione stimata ottenute come risposta dall'interfaccia a riga di comando in formato GeoJSON. Ad esempio, il comando seguente memorizza le informazioni sulla posizione nel *locationout.json* file. ``` 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 ``` Questo esempio include sia i punti di accesso Wi-Fi che l'indirizzo IP come tipi di misurazione. AWS IoT Core Device Location sceglie tra il solver Wi-Fi e il solutore di ricerca inversa IP e seleziona il solutore con la maggiore precisione. La posizione risolta viene restituita come un payload che utilizza il formato GeoJSON, ideale per codificare strutture di dati geografici. Viene quindi memorizzato nel file. *locationout.json* Il payload contiene le coordinate di WGS84 latitudine e longitudine, le informazioni sul livello di precisione e confidenza, il tipo di dati sulla posizione e il timestamp in cui la posizione è stata risolta. ``` { "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" } } ``` ## Risoluzione dei problemi relativi alla risoluzione della posizione Quando tenti di risolvere la posizione, potresti visualizzare uno dei seguenti codici di errore. AWS IoT Core La posizione del dispositivo potrebbe generare un errore durante l'utilizzo dell'operazione `GetPositionEstimate` API oppure fare riferimento al numero di riga corrispondente all'errore nella AWS IoT console. + **Errore 400** Questo errore indica che il formato del payload del dispositivo JSON non può essere convalidato da AWS IoT Core Device Location. Le possibile cause dell'errore sono: + I dati di misurazione JSON sono formattati in modo errato. + Il payload contiene solo le informazioni sul timestamp. + I parametri dei dati di misurazione, come l'indirizzo IP, non sono validi. Per risolvere questo errore, verificare se il JSON sia formattato correttamente e contenga dati di uno o più tipi di misurazione come input. Se l'indirizzo IP non è valido, per informazioni su come fornire un indirizzo IP valido per risolvere l'errore, consulta [Risolutore di ricerca inversa IP](device-location-solvers-payload.md#location-solvers-ip). + **Errore 403** Questo errore indica che non disponi delle autorizzazioni per eseguire l'operazione API o per utilizzare la AWS IoT console per recuperare la posizione del dispositivo. Per risolvere questo errore, verificare di disporre delle autorizzazioni richieste per eseguire questa azione. Questo errore può verificarsi se la Console di gestione AWS sessione o il token di AWS CLI sessione sono scaduti. Per risolvere questo errore, aggiorna il token di sessione per utilizzare o disconnettiti da Console di gestione AWS e quindi accedi utilizzando le tue credenziali. AWS CLI + **Errore 404** Questo errore indica che nessuna informazione sulla posizione è stata trovata o risolta da AWS IoT Core Device Location. L'errore potrebbe verificarsi a causa di problemi quali dati insufficienti nell'immissione dei dati di misurazione. Esempio: + L'indirizzo MAC o le informazioni sul ripetitore di rete cellulare non sono sufficienti. + L'indirizzo IP non è disponibile per cercare e recuperare la posizione. + Il payload GNSS non è sufficiente. In questi casi, per risolvere l'errore, verificare se i dati di misurazione contengono informazioni sufficienti per risolvere la posizione del dispositivo. + **Errore 500** Questo errore indica che si è verificata un'eccezione interna del server quando AWS IoT Core Device Location ha tentato di risolvere la posizione. Per tentare di correggere questo errore, aggiornare la sessione e riprovare a inviare i dati di misurazione da risolvere. # Risoluzione della posizione del dispositivo utilizzando gli argomenti MQTT di AWS IoT Core Device Location È possibile utilizzare argomenti MQTT riservati per ottenere le informazioni più recenti sulla posizione dei dispositivi con la funzione AWS IoT Core Device Location. ## Formato degli argomenti relativi alla posizione del dispositivo Gli argomenti riservati per AWS IoT Core Device Location utilizzano il seguente prefisso: `$aws/device_location/{customer_device_id}/` Per creare un argomento completo, sostituisci prima `customer_device_id` con l’ID univoco che usi per identificare il tuo dispositivo. Ti consigliamo di specificare`WirelessDeviceId`, ad esempio per i dispositivi LoRa WAN e Sidewalk, e`thingName`, se il dispositivo è registrato come oggetto AWS IoT . Poi aggiungi l'argomento insieme allo stub dell'argomento, ad esempio `get_position_estimate` o `get_position_estimate/accepted`, come mostrato nella sezione seguente. **Nota** `{customer_device_id}` può contenere solo lettere, numeri e trattini. Quando ti iscrivi agli argomenti relativi alla posizione del dispositivo, puoi utilizzare solo il segno più (\$1) come jolly. Ad esempio, puoi usare il jolly `+` per consentire a `{customer_device_id}` di ottenere le informazioni sulla posizione dei tuoi dispositivi. Quando ti iscrivi all'argomento `$aws/device_location/+/get_position_estimate/accepted`, verrà pubblicato un messaggio con le informazioni sulla posizione dei dispositivi che corrispondono a qualsiasi ID dispositivo se il problema è stato risolto con successo. Di seguito sono riportati gli argomenti riservati utilizzati per interagire con AWS IoT Core Device Location. **Argomenti relativi alla posizione del dispositivo** | Topic | Operazioni consentite | Description | | --- | --- | --- | | \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Pubblica | Un dispositivo pubblica su questo argomento per ottenere i dati di misurazione grezzi scansionati da risolvere tramite Device Location. AWS IoT Core | | \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Subscribe | AWS IoT Core Device Location pubblica le informazioni sulla posizione in questo argomento quando risolve correttamente la posizione del dispositivo. | | *customer\$1device\$1id*\$1aws/device\$1location/ /get\$1position\$1estimate/rejected | Subscribe | AWS IoT Core Device Location pubblica le informazioni sull'errore in questo argomento quando non riesce a risolvere la posizione del dispositivo. | ## Policy per gli argomenti MQTT relativi alla posizione dei dispositivi Per ricevere messaggi dagli argomenti relativi alla localizzazione del dispositivo, il dispositivo deve utilizzare una politica che gli consenta di connettersi al gateway del AWS IoT dispositivo e sottoscrivere gli argomenti MQTT. Di seguito viene mostrato un esempio della policy necessaria per la ricezione di messaggi per i vari argomenti. **** ``` { "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" ] } ] } ``` ## Argomenti relativi alla posizione del dispositivo e payload Di seguito vengono illustrati gli argomenti relativi alla localizzazione del AWS IoT Core dispositivo, il formato del relativo payload dei messaggi e un esempio di policy per ogni argomento. **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 Pubblicate un messaggio su questo argomento per far sì che i dati di misurazione grezzi del dispositivo vengano risolti da AWS IoT Core Device Location. ``` $aws/device_location/customer_device_id/get_position_estimate ``` AWS IoT Core Device Location risponde pubblicando su uno [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) o[/get\$1position\$1estimate/rejected](#get-position-estimate-rejected). **Nota** Il messaggio pubblicato su questo argomento deve essere un payload JSON valido. Se il messaggio di input non è in formato JSON valido, non riceverai alcuna risposta. Per ulteriori informazioni, consulta [Payload del messaggio](#get-position-estimate-payload). #### Payload del messaggio Il formato del payload del messaggio segue una struttura simile a quella del corpo della richiesta di operazione dell'API AWS IoT Wireless,. [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 stringa opzionale `Timestamp`, che corrisponde alla data e all’ora in cui la posizione è stata risolta. La stringa `Timestamp` può avere una lunghezza minima di 1 e una lunghezza massima di 10. + Una stringa opzionale `MessageId`, che può essere utilizzata per mappare la richiesta alla risposta. Se specifichi questa stringa, il messaggio pubblicato negli argomenti `get_position_estimate/accepted` o`get_position_estimate/rejected` conterrà questo `MessageId`. La stringa `MessageID` può avere una lunghezza minima di 1 e una lunghezza massima di 256. + I dati di misurazione del dispositivo che contengono uno o più dei seguenti tipi di misurazione: + [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) Quello che segue è un playload del messaggio di esempio. ``` { "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 } } ``` #### Policy di esempio Di seguito è illustrato un esempio della policy necessaria: **** ``` { "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 pubblica una risposta a questo argomento quando restituisce le informazioni sulla posizione risolte per il dispositivo. Le informazioni sulla posizione vengono restituite in formato [GeoJSON](https://geojson.org/). ``` $aws/device_location/customer_device_id/get_position_estimate/accepted ``` Di seguito viene illustrato il payload del messaggio e un esempio di policy. #### Payload del messaggio Di seguito è riportato un esempio di payload del messaggi in formato GeoJSON. Se hai specificato a `MessageId` nei dati di misurazione grezzi e AWS IoT Core Device Location ha risolto correttamente le informazioni sulla posizione, il payload del messaggio restituisce le stesse `MessageId` informazioni. ``` { "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" } } ``` #### Policy di esempio Di seguito è illustrato un esempio della policy necessaria: **** ``` { "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 Device Location pubblica una risposta di errore a questo argomento quando non riesce a risolvere la posizione del dispositivo. ``` $aws/device_location/customer_device_id/get_position_estimate/rejected ``` Di seguito viene illustrato il payload del messaggio e una policy di esempio. Per informazioni sugli errori, vedi [Risoluzione dei problemi relativi alla risoluzione della posizione](device-location-resolve-solvers.md#location-resolve-troubleshoot). #### Payload del messaggio Di seguito è riportato un esempio del payload del messaggio che fornisce il codice e il messaggio di errore, che indicano perché AWS IoT Core Device Location non è riuscito a risolvere le informazioni sulla posizione. Se hai specificato a `MessageId` quando hai fornito i dati di misurazione non elaborati e AWS IoT Core Device Location non è riuscito a risolvere le informazioni sulla posizione, le stesse `MessageId` informazioni verranno restituite nel payload del messaggio. ``` { "errorCode": 500, "errorMessage":"Internal server error", "messageId": "ABCD1" } ``` #### Policy di esempio Di seguito è illustrato un esempio della policy necessaria: **** ``` { "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" ] } ] } ``` # Risolutori di posizione e payload del dispositivo I location solver sono algoritmi che possono essere utilizzati per determinare la posizione dei dispositivi IoT. AWS IoT Core Device Location supporta i seguenti risolutori di posizione. Sono disponibili esempi del formato di payload JSON per questi tipi di misurazione, dei dispositivi supportati dal risolutore e della modalità di risoluzione della posizione. Per risolvere la posizione del dispositivo, specificare uno o più di questi tipi di dati di misurazione. Una singola posizione risolta verrà restituita per tutti i dati di misurazione combinati. **Topics** + [Risolutore basato su Wi-Fi](#location-solvers-wifi) + [Risolutore basato su rete cellulare](#location-solvers-cellular) + [Risolutore di ricerca inversa IP](#location-solvers-ip) + [Risolutore GNSS](#location-solvers-gnss) + [Solver BLE per dispositivi compatibili con Amazon Sidewalk](#location-solvers-ble) ## Risolutore basato su Wi-Fi Utilizzare il risolutore basato su Wi-Fi per risolvere la posizione utilizzando le informazioni di scansione di punti di accesso Wi-Fi. Il solver supporta la tecnologia WLAN e può essere utilizzato per calcolare la posizione del dispositivo per dispositivi IoT generici che si connettono tramite TCP/IP, dispositivi LoRa wireless WAN e dispositivi abilitati per Amazon Sidewalk. I dispositivi LoRa WAN devono disporre del chipset LoRa Edge, in grado di decodificare le informazioni di scansione Wi-Fi in ingresso. LoRa Edge è una piattaforma a bassissimo consumo che integra un LoRa ricetrasmettitore a lungo raggio, uno scanner GNSS a più costellazioni e uno scanner MAC Wi-Fi passivo destinato alle applicazioni di geolocalizzazione. Quando viene ricevuto un messaggio uplink dal dispositivo, i dati di scansione Wi-Fi vengono inviati a Device Location e la posizione viene stimata in base ai AWS IoT Core risultati della scansione Wi-Fi. Le informazioni decodificate vengono quindi passate al risolutore basato su Wi-Fi per recuperare le informazioni sulla posizione. Per ulteriori informazioni sulla risoluzione dei dati di localizzazione per i dispositivi compatibili con Amazon Sidewalk, consulta la guida per [AWS IoT Core per Amazon Sidewalk sviluppatori](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/iot-sidewalk.html). ### Esempio di payload del risolutore basato su Wi-Fi Il codice seguente mostra un esempio di payload JSON del dispositivo contenente i dati di misurazione. Quando AWS IoT Core Device Location riceve questi dati come input, invia una richiesta HTTP al solver provider per risolvere le informazioni sulla posizione. Per recuperare le informazioni, specificare i valori per Indirizzo MAC e l'RSS (intensità del segnale ricevuto). A tale scopo, fornite il payload JSON utilizzando questo formato o utilizzate il parametro [WiFiAccessPointsobject dell'](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html)operazione API. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) ``` { "Timestamp": 1664313161, // optional "WiFiAccessPoints": [ { "MacAddress": "A0:EC:F9:1E:32:C1", // required "Rss": -75 // required } ] } ``` ## Risolutore basato su rete cellulare È possibile utilizzare il risolutore basato su rete cellulare per risolvere la posizione utilizzando i dati di misurazione ottenuti dalle torri radio di reti cellulare. Il risolutore supporta le tecnologie riportate di seguito. Anche se si includono i dati di misurazione di una o tutte queste tecnologie, viene ottenuta una singola informazione sulla posizione risolta. + GSM + CDMA + WCDMA + TD-SCDMA + LTE ### Esempi di payload di risolutore basato su rete cellulare Il codice seguente mostra esempi di payload JSON del dispositivo contenente i dati di misurazione della rete cellulare. Quando AWS IoT Core Device Location riceve questi dati come input, invia una richiesta HTTP al solver provider per risolvere le informazioni sulla posizione. Per recuperare le informazioni, è possibile fornire il payload JSON utilizzando questo formato nella console o specificare i valori per il [CellTowers](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-CellTowers)parametro dell'operazione API. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) È possibile fornire i dati di misurazione specificando i valori dei parametri utilizzando una o tutte queste tecnologie di rete cellulare. #### LTE (Long-term evolution) Quando si utilizzano questi dati di misurazione, è necessario specificare informazioni quali la rete e il codice paese della rete mobile, nonché parametri aggiuntivi opzionali, incluse le informazioni sull'ID locale. Il codice seguente mostra un esempio del formato di payload. Per ulteriori informazioni su questi parametri, consulta [Oggetto 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 (Global System for Mobile Communications) Quando si utilizzano questi dati di misurazione, è necessario specificare informazioni quali la rete e il codice paese della rete mobile, le informazioni sulla stazione base, nonché parametri aggiuntivi opzionali. Il codice seguente mostra un esempio del formato di payload. Per ulteriori informazioni su questi parametri, consulta [Oggetto 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 (Code-division multiple access) Quando si utilizzano questi dati di misurazione, è necessario specificare informazioni quali la potenza del segnale e le informazioni di identificazione, le informazioni sulla stazione base, nonché parametri aggiuntivi opzionali. Il codice seguente mostra un esempio del formato di payload. Per ulteriori informazioni su questi parametri, consulta [Oggetto 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 (Wideband code-division multiple access) Quando si utilizzano questi dati di misurazione, è necessario specificare informazioni quali la rete e il codice paese, la potenza del segnale e le informazioni di identificazione, le informazioni sulla stazione base, nonché parametri aggiuntivi opzionali. Il codice seguente mostra un esempio del formato di payload. Per ulteriori informazioni su questi parametri, consulta [Oggetto 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 (Time division synchronous code-division multiple access) Quando si utilizzano questi dati di misurazione, è necessario specificare informazioni quali la rete e il codice paese, la potenza del segnale e le informazioni di identificazione, le informazioni sulla stazione base, nonché parametri aggiuntivi opzionali. Il codice seguente mostra un esempio del formato di payload. Per ulteriori informazioni su questi parametri, consulta [Oggetto 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 } ] } ] } } ``` ## Risolutore di ricerca inversa IP È possibile utilizzare il risolutore di ricerca inversa IP per risolvere la posizione utilizzando l'indirizzo IP come input. Il solver può ottenere le informazioni sulla posizione dai dispositivi di cui è stato fornito. AWS IoT Specificate le informazioni sull'indirizzo IP utilizzando un formato che sia il modello IPv6 standard IPv4 o il modello compresso IPv6 esadecimale. Si ottiene quindi la stima della posizione risolta, incluse informazioni aggiuntive quali la città e il paese in cui si trova il dispositivo. **Nota** Utilizzando la ricerca inversa IP, l'utente accetta di non utilizzarla allo scopo di identificare o localizzare un indirizzo residenziale o stradale specifico. ### Esempio di payload del risolutore di ricerca inversa IP Il codice seguente mostra un esempio di payload JSON del dispositivo contenente i dati di misurazione. Quando AWS IoT Core Device Location riceve le informazioni sull'indirizzo IP contenute nei dati di misurazione, cerca tali informazioni nel database del solver provider, che viene quindi utilizzato per risolvere le informazioni sulla posizione. Per recuperare le informazioni, fornite il payload JSON utilizzando questo formato o specificate i valori per il parametro [Ip dell'operazione](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Ip) API. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) **Nota** Quando si utilizza questo risolutore, oltre alle coordinate vengono riportati anche la città, lo stato, il Paese e il codice postale in cui si trova il dispositivo. Per vedere un esempio, consulta [Risoluzione della posizione del dispositivo (console)](device-location-resolve-solvers.md#location-resolve-console). ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress":"54.240.198.35" } } ``` ## Risolutore GNSS Utilizzare il risolutore GNSS (Global Navigation Satellite System) per recuperare la posizione del dispositivo utilizzando le informazioni contenute nei messaggi del risultato di scansione GNSS o nei messaggi NAV. Facoltativamente, è possibile fornire informazioni di assistenza GNSS aggiuntive, che riducono il numero di variabili che il risolutore deve utilizzare per cercare i segnali. Fornendo queste informazioni di assistenza, che includono la posizione, l'altitudine, il tempo di acquisizione e le informazioni sulla precisione, il risolutore può identificare facilmente i satelliti in vista e calcolare la posizione del dispositivo. Questo solver può essere utilizzato con dispositivi LoRa WAN e dispositivi abilitati per Amazon Sidewalk, nonché con altri dispositivi che sono stati dotati di dispositivi AWS IoT di cui è stato effettuato il provisioning. AWS IoT Per dispositivi IoT generici, se i dispositivi supportano la stima della posizione mediante GNSS, quando le informazioni di scansione GNSS vengono ricevute dal dispositivo, i ricetrasmettitori risolvono le informazioni sulla posizione. Per i dispositivi LoRa WAN, i dispositivi devono disporre del chipset Edge. LoRa Quando viene ricevuto un messaggio di uplink dal dispositivo, i dati di scansione GNSS vengono inviati alla LoRa rete WAN o AWS IoT ad AWS IoT Amazon Sidewalk e la posizione viene stimata in base ai risultati della scansione dei ricetrasmettitori. ### Esempio di payload del risolutore GNSS Il codice seguente mostra un esempio di payload JSON del dispositivo contenente i dati di misurazione. Quando AWS IoT Core Device Location riceve le informazioni di scansione GNSS contenenti il payload nei dati di misurazione, utilizza i ricetrasmettitori e tutte le informazioni di assistenza aggiuntive incluse per cercare segnali e risolvere le informazioni sulla posizione. [Per recuperare le informazioni, fornite il payload JSON utilizzando questo formato o specificate i valori per il parametro Gnss dell'operazione 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** Prima che AWS IoT Core Device Location possa risolvere la posizione del dispositivo, è necessario rimuovere il byte di destinazione dal payload. ``` { "Timestamp": 1664313161, // optional "Gnss": { "AssistAltitude": number, // optional "AssistPosition": [ number ], // optional "CaptureTime": number, // optional "CaptureTimeAccuracy": number, // optional "Payload": "string", // required "Use2DSolver": boolean // optional } } ``` ## Solver BLE per dispositivi compatibili con Amazon Sidewalk **Nota** Per la posizione basata su Bluetooth Low Energy, AWS IoT restituisce le coordinate della posizione in base alla posizione approssimativa dei Sidewalk Gateway vicini collegati ad Amazon Sidewalk e con la funzione Community Finding abilitata. I dati di localizzazione del gateway sono AWS Contenuti e vengono forniti all'utente esclusivamente allo scopo di aiutarlo a localizzare i dispositivi collegati ad Amazon Sidewalk e l'utente deve utilizzare i dati solo a tale scopo. Devi utilizzare e accedere ai dati sulla posizione solo tramite l'interfaccia e la funzionalità che generalmente ti mettiamo a disposizione e non devi tentare di reidentificare, decodificare o ri-mappare i dati sulla posizione del Gateway che ti abbiamo fornito. I dispositivi terminali Amazon Sidewalk che si connettono AWS IoT Core per Amazon Sidewalk possono risolvere i dati sulla posizione utilizzando messaggi uplink BLE, Wi-Fi o GNSS pubblicati dal dispositivo finale Amazon Sidewalk. [Per ulteriori informazioni, consulta la guida per gli sviluppatori.AWS IoT Core per Amazon Sidewalk](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/sidewalk-getting-started.html)