View a markdown version of this page

Menyelesaikan lokasi perangkat IoT - AWS IoT Core
Menyelesaikan lokasi perangkat (konsol)Menyelesaikan lokasi perangkat (API)Memecahkan masalah kesalahan saat menyelesaikan lokasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menyelesaikan lokasi perangkat IoT

Gunakan Lokasi AWS IoT Core Perangkat untuk memecahkan kode data pengukuran dari perangkat Anda, dan menyelesaikan lokasi perangkat menggunakan pemecah pihak ketiga. Lokasi yang diselesaikan dihasilkan sebagai muatan GeoJSON dengan koordinat geografis dan informasi akurasi. Anda dapat menyelesaikan lokasi perangkat Anda dari AWS IoT konsol, API Nir AWS IoT kabel, atau AWS CLI.

Menyelesaikan lokasi perangkat (konsol)

Untuk menyelesaikan lokasi perangkat (konsol)

  1. Buka halaman Lokasi Perangkat di AWS IoT konsol.

  2. Dapatkan data pengukuran muatan dari log perangkat Anda atau dari CloudWatch Log, dan masukkan di bagian Resolve position melalui payload.

    Kode berikut menunjukkan contoh muatan JSON. Payload berisi data seluler dan Wi-Fi pengukuran. Jika muatan Anda berisi jenis data pengukuran tambahan, pemecah dengan akurasi terbaik akan digunakan. Untuk informasi selengkapnya dan contoh muatan, lihatPemecah lokasi dan muatan perangkat.

    catatan

    Muatan JSON harus berisi setidaknya satu jenis data pengukuran.

    {
    "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
                }
            ]
        }]
    },
    "AdvancedConfiguration": {
        "WiFiCellular": {
            "ConfidencePercent": 68
        }
    }
}

  3. Untuk menyelesaikan informasi lokasi, pilih Sel esaikan.

    Informasi lokasi adalah tipe blob dan dikembalikan sebagai payload yang menggunakan format GeoJSON, yang merupakan format yang digunakan untuk pengkodean struktur data geografis. Payload berisi:

    • Koordinat geografis WGS84, yang mencakup informasi lintang dan bujur. Ini mungkin juga termasuk informasi ketinggian.

    • Jenis informasi lokasi yang dilaporkan, seperti Point. Tipe lokasi titik mewakili lokasi sebagai garis lintang dan bujur WGS84, dikodekan sebagai titik GeoJSON.

    • Informasi akurasi horizontal dan vertikal, yang menunjukkan perbedaan, dalam meter, antara informasi lokasi yang diperkirakan oleh pemecah dan lokasi perangkat yang sebenarnya.

    • Tingkat kepercayaan, yang menunjukkan ketidakpastian dalam respon perkiraan lokasi. Nilai defaultnya adalah 0,68, yang menunjukkan probabilitas 68% bahwa lokasi perangkat sebenarnya berada dalam radius ketidakpastian lokasi yang diperkirakan. Anda dapat menyesuaikan nilai ini menggunakan AdvancedConfiguration parameter. Untuk informasi selengkapnya, lihat Konfigurasi lanjutan untuk AWS IoT Core Lokasi Perangkat.

    • Kota, negara bagian, negara, dan kode pos tempat perangkat berada. Informasi ini akan dilaporkan hanya ketika pemecah pencarian terbalik IP digunakan.

    • Informasi stempel waktu, yang sesuai dengan tanggal dan waktu di mana lokasi diselesaikan. Ini menggunakan format timestamp Unix.

    Kode berikut menunjukkan contoh payload GeoJSON yang dikembalikan dengan menyelesaikan lokasi.

    catatan

    Jika Lokasi AWS IoT Core Perangkat melaporkan kesalahan saat mencoba menyelesaikan lokasi, Anda dapat memecahkan masalah kesalahan dan menyelesaikan lokasi. Untuk informasi selengkapnya, lihat Memecahkan masalah kesalahan saat menyelesaikan lokasi.

    {
    "coordinates": [
        13.376077,
        52.51823,
        80.1
    ],
    "type": "Point",
    "properties": {
        "verticalAccuracy": 45,
        "verticalConfidenceLevel": 0.68,
        "horizontalAccuracy": 303,
        "horizontalConfidenceLevel": 0.68,
        "timestamp": "2026-04-07T01:16:39.971767716Z"
    }
}

  4. Buka bagian Lokasi sumber daya dan verifikasi informasi geolokasi yang dilaporkan oleh Lokasi AWS IoT Core Perangkat. Anda dapat menyalin payload untuk digunakan dengan aplikasi lain dan Layanan AWS s. Misalnya, Anda dapat menggunakan Lokasi untuk mengirim data lokasi geografis Anda ke Layanan Lokasi Amazon.

Menyelesaikan lokasi perangkat (API)

Untuk menyelesaikan lokasi perangkat menggunakan API Nir AWS IoT kabel, gunakan operasi GetPositionEstimate API atau perintah get-position- estimate CLI. Tentukan data pengukuran payload sebagai input, dan jalankan operasi API untuk menyelesaikan lokasi perangkat.

catatan

Operasi GetPositionEstimate API tidak menyimpan informasi perangkat atau status apa pun dan tidak dapat digunakan untuk mengambil data lokasi historis. Ini melakukan operasi satu kali yang menyelesaikan data pengukuran dan menghasilkan perkiraan lokasi. Untuk mengambil informasi lokasi, Anda harus menentukan informasi payload setiap kali Anda melakukan operasi API ini.

Perintah berikut menunjukkan contoh cara menyelesaikan lokasi menggunakan operasi API ini.

catatan

Saat menjalankan perintah get-position-estimate CLI, Anda harus menentukan file JSON keluaran sebagai input pertama. File JSON ini akan menyimpan perkiraan informasi lokasi yang diperoleh sebagai respons dari CLI dalam format GeoJSON. Misalnya, perintah berikut menyimpan informasi lokasi dalam 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 \
    --advanced-configuration \
        WiFiCellular={ConfidencePercent=68}

Contoh ini mencakup titik Wi-Fi akses dan alamat IP sebagai jenis pengukuran. AWS IoT Core Lokasi Perangkat memilih antara pemec Wi-Fi ah dan pemecah pencarian terbalik IP, dan memilih pemecah dengan akurasi yang lebih tinggi.

--advanced-configurationParameter opsional berisi WiFiCellular objek, yang mencakup ConfidencePercent bidang untuk menyesuaikan tingkat kepercayaan untuk Wi-Fi dan data pengukuran Seluler. Dalam contoh ini, ConfidencePercent diatur ke68, yang juga merupakan nilai default ketika parameter ini tidak ditentukan. Untuk informasi selengkapnya, lihat Konfigurasi lanjutan untuk AWS IoT Core Lokasi Perangkat.

Lokasi yang diselesaikan dikembalikan sebagai payload yang menggunakan format GeoJSON, yang merupakan format yang digunakan untuk pengkodean struktur data geografis. Kemudian disimpan dalam locationout.json file. Payload berisi koordinat lintang dan bujur WGS84, informasi tingkat akurasi dan kepercayaan, jenis data lokasi, dan stempel waktu di mana lokasi diselesaikan.

{
    "coordinates": [
        13.376077,
        52.51823,
        80.1
    ],
    "type": "Point",
    "properties": {
        "verticalAccuracy": 45,
        "verticalConfidenceLevel": 0.68,
        "horizontalAccuracy": 303,
        "horizontalConfidenceLevel": 0.68,
        "timestamp": "2026-04-07T01:16:39.971767716Z"
    }
}

Memecahkan masalah kesalahan saat menyelesaikan lokasi

Saat mencoba menyelesaikan lokasi, Anda mungkin melihat salah satu kode kesalahan berikut. AWS IoT Core Lokasi Perangkat mungkin menghasilkan kesalahan saat menggunakan operasi GetPositionEstimate API, atau merujuk ke nomor baris yang sesuai dengan kesalahan di AWS IoT konsol.

  • 400 kesalahan

    Kesalahan ini menunjukkan bahwa format JSON payload perangkat tidak dapat divalidasi oleh Lokasi AWS IoT Core Perangkat. Kesalahan mungkin terjadi karena:

    • Data pengukuran JSON tidak diformat dengan benar.

    • Payload hanya berisi informasi stempel waktu.

    • Parameter data pengukuran, seperti alamat IP, tidak valid.

    Untuk mengatasi kesalahan ini, periksa apakah JSON Anda diformat dengan benar dan berisi data dari satu atau beberapa jenis pengukuran sebagai input. Jika alamat IP tidak valid, untuk informasi tentang bagaimana Anda dapat memberikan alamat IP yang valid untuk mengatasi kesalahan, lihatPemecah pencarian terbalik IP.

  • Kesalahan 403

    Kesalahan ini menunjukkan bahwa Anda tidak memiliki izin untuk melakukan operasi API atau menggunakan AWS IoT konsol untuk mengambil lokasi perangkat. Untuk mengatasi kesalahan ini, verifikasi bahwa Anda memiliki izin yang diperlukan untuk melakukan tindakan ini. Kesalahan ini mungkin terjadi jika Konsol Manajemen AWS sesi atau token AWS CLI sesi Anda telah kedaluwarsa. Untuk mengatasi kesalahan ini, segarkan token sesi untuk menggunakan AWS CLI, atau keluar dari Konsol Manajemen AWS dan kemudian masuk menggunakan kredenSIAL Anda.

  • Kesalahan 404

    Kesalahan ini menunjukkan bahwa tidak ada informasi lokasi yang ditemukan atau diselesaikan oleh Lokasi AWS IoT Core Perangkat. Kesalahan mungkin terjadi karena kasus-kasus seperti data yang tidak mencukupi dalam input data pengukuran. Contoh:

    • Alamat MAC atau informasi menara seluler tidak cukup.

    • Alamat IP tidak tersedia untuk mencari dan mengambil lokasi.

    • Payload GNSS tidak cukup.

    Untuk mengatasi kesalahan dalam kasus seperti itu, periksa apakah data pengukuran Anda berisi informasi yang cukup yang diperlukan untuk menyelesaikan lokasi perangkat.

  • 500 kesalahan

    Kesalahan ini menunjukkan bahwa pengecualian server internal terjadi ketika Lokasi AWS IoT Core Perangkat mencoba menyelesaikan lokasi. Untuk mencoba memperbaiki kesalahan ini, segarkan sesi dan coba lagi mengirim data pengukuran untuk diselesaikan.