Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mulai melacak dengan Lokasi Amazon
Bagian ini memandu Anda melalui pembuatan aplikasi pelacakan yang menangkap lokasi perangkat.
Topik
Buat pelacak
Buat sumber daya pelacak untuk menyimpan dan memproses pembaruan posisi dari perangkat Anda. Anda dapat menggunakan konsol Amazon Location Service, the AWS CLI, atau Amazon LocationAPIs.
Setiap pembaruan posisi yang disimpan dalam sumber daya pelacak Anda dapat mencakup ukuran akurasi posisi, dan hingga tiga bidang metadata tentang posisi atau perangkat yang ingin Anda simpan. Metadata disimpan sebagai pasangan nilai kunci, dan dapat menyimpan informasi seperti kecepatan, arah, tekanan ban, atau suhu mesin.
Pelacak memfilter pembaruan posisi saat diterima. Ini mengurangi noise visual di jalur perangkat Anda (disebut jitter), dan mengurangi jumlah peristiwa masuk dan keluar geofence palsu. Ini juga membantu mengelola biaya dengan mengurangi jumlah evaluasi geofence yang dimulai.
Pelacak menawarkan tiga opsi pemfilteran posisi untuk membantu mengelola biaya dan mengurangi jitter di pembaruan lokasi Anda.
-
Berbasis akurasi - Gunakan dengan perangkat apa pun yang memberikan pengukuran akurasi. Sebagian besar perangkat seluler memberikan informasi ini. Keakuratan setiap pengukuran posisi dipengaruhi oleh banyak faktor lingkungan, termasuk penerimaan GPS satelit, lanskap, dan kedekatan perangkat Wi-Fi dan Bluetooth. Sebagian besar perangkat, termasuk sebagian besar perangkat seluler, dapat memberikan perkiraan keakuratan pengukuran bersama dengan pengukuran. Dengan
AccuracyBasedpemfilteran, Lokasi Amazon mengabaikan pembaruan lokasi jika perangkat bergerak kurang dari akurasi yang diukur. Misalnya, jika dua pembaruan berturut-turut dari perangkat memiliki rentang akurasi 5 m dan 10 m, Amazon Location mengabaikan pembaruan kedua jika perangkat telah bergerak kurang dari 15 m. Lokasi Amazon tidak mengevaluasi pembaruan yang diabaikan terhadap geofences, atau menyimpannya.Ketika akurasi tidak disediakan, itu diperlakukan sebagai nol, dan pengukuran dianggap sangat akurat.
catatan
Anda juga dapat menggunakan pemfilteran berbasis akurasi untuk menghapus semua pemfilteran. Jika Anda memilih pemfilteran berbasis akurasi, tetapi mengganti semua data akurasi ke nol, atau menghilangkan akurasi sepenuhnya, maka Lokasi Amazon tidak akan memfilter pembaruan apa pun.
-
Berbasis jarak — Gunakan saat perangkat Anda tidak memberikan pengukuran akurasi, tetapi Anda tetap ingin memanfaatkan penyaringan untuk mengurangi jitter dan mengelola biaya.
DistanceBasedpemfilteran mengabaikan pembaruan lokasi di mana perangkat telah bergerak kurang dari 30 m (98,4 kaki). Saat Anda menggunakan pemfilteranDistanceBasedposisi, Amazon Location tidak mengevaluasi pembaruan yang diabaikan ini terhadap geofences atau menyimpan pembaruan.Keakuratan sebagian besar perangkat seluler, termasuk akurasi rata-rata perangkat iOS dan Android, berada dalam jarak 15 m. Di sebagian besar aplikasi,
DistanceBasedpenyaringan dapat mengurangi efek ketidakakuratan lokasi saat menampilkan lintasan perangkat pada peta, dan efek pantulan dari beberapa peristiwa masuk dan keluar berturut-turut saat perangkat berada di dekat perbatasan geofence. Hal ini juga dapat membantu mengurangi biaya aplikasi Anda, dengan membuat lebih sedikit panggilan untuk mengevaluasi terhadap geofences terkait atau mengambil posisi perangkat. -
Berbasis waktu — (default) Gunakan saat perangkat Anda mengirim pembaruan posisi sangat sering (lebih dari sekali setiap 30 detik), dan Anda ingin mencapai evaluasi geofence mendekati waktu nyata tanpa menyimpan setiap pembaruan.Dalam
TimeBasedpemfilteran, setiap pembaruan lokasi dievaluasi terhadap koleksi geofence yang ditautkan, tetapi tidak setiap pembaruan lokasi disimpan. Jika frekuensi pembaruan Anda lebih sering dari 30 detik, hanya satu pembaruan per 30 detik yang disimpan untuk setiap ID perangkat unik.
catatan
Perhatikan biaya aplikasi pelacakan Anda saat memutuskan metode penyaringan Anda dan frekuensi pembaruan posisi. Anda ditagih untuk setiap pembaruan lokasi dan sekali untuk mengevaluasi pembaruan posisi terhadap setiap koleksi geofence yang ditautkan. Misalnya, saat menggunakan pemfilteran berbasis waktu, jika pelacak Anda ditautkan ke dua koleksi geofence, setiap pembaruan posisi akan dihitung sebagai satu permintaan pembaruan lokasi dan dua evaluasi pengumpulan geofence. Jika Anda melaporkan pembaruan posisi setiap 5 detik untuk perangkat Anda dan menggunakan pemfilteran berbasis waktu, Anda akan ditagih untuk 720 pembaruan lokasi dan 1.440 evaluasi geofensi per jam untuk setiap perangkat.
Tagihan Anda tidak terpengaruh oleh jumlah geofences di setiap koleksi. Karena setiap koleksi geofence dapat berisi hingga 50,000 geofences, Anda mungkin ingin menggabungkan geofences Anda menjadi koleksi yang lebih sedikit, jika memungkinkan, untuk mengurangi biaya evaluasi geofence Anda.
Secara default, Anda akan mendapatkan EventBridge acara setiap kali perangkat yang dilacak masuk atau keluar dari geofence yang ditautkan. Untuk informasi selengkapnya, lihat Tutorial: Tautkan pelacak ke koleksi geofence di Lokasi Amazon.
Anda dapat mengaktifkan acara untuk semua pembaruan posisi yang difilter untuk sumber daya pelacak. Untuk informasi selengkapnya, lihat Aktifkan peristiwa pembaruan untuk pelacak.
catatan
Jika Anda ingin mengenkripsi data menggunakan kunci yang dikelola AWS KMS pelanggan Anda sendiri, maka fitur Bounding Polygon Queries akan dinonaktifkan secara default. Ini karena dengan menggunakan fitur Bounding Polygon Queries ini, representasi posisi perangkat Anda tidak akan dienkripsi menggunakan kunci terkelola Anda. AWS KMS Namun, posisi perangkat yang tepat masih dienkripsi menggunakan kunci terkelola Anda.
Anda dapat memilih untuk ikut serta ke fitur Bounding Polygon Query dengan menyetel KmsKeyEnableGeospatialQueries parameter ke true saat membuat atau memperbarui Tracker.
catatan
Penagihan tergantung pada penggunaan Anda. Anda mungkin dikenakan biaya untuk penggunaan AWS
layanan lain. Untuk informasi selengkapnya, lihat harga Amazon Location Service
Anda dapat mengedit Deskripsi, Pemfilteran posisi, dan EventBridge konfigurasi setelah pelacak dibuat dengan memilih Edit tracker.
Mengautentikasi permintaan Anda
Setelah Anda membuat sumber daya pelacak dan Anda siap untuk mulai mengevaluasi posisi perangkat terhadap geofences, pilih bagaimana Anda akan mengautentikasi permintaan Anda:
-
Untuk mempelajari cara mengakses layanan, lihat Mengakses Amazon Location Service.
-
Jika Anda ingin mempublikasikan posisi perangkat dengan permintaan yang tidak diautentikasi, Anda mungkin ingin menggunakan Amazon Cognito.
Contoh
Contoh berikut menunjukkan penggunaan kumpulan identitas Amazon Cognito untuk otorisasi, menggunakan AWS JavaScript SDKv3, dan Lokasi
Amazon. JavaScript Pembantu otentikasi import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command);
Perbarui pelacak Anda dengan posisi perangkat
Untuk melacak perangkat Anda, Anda dapat memposting pembaruan posisi perangkat ke pelacak Anda. Anda kemudian dapat mengambil posisi perangkat ini atau riwayat posisi perangkat dari sumber daya pelacak Anda.
Setiap pembaruan posisi harus menyertakan ID perangkat, stempel waktu, dan posisi. Anda dapat secara opsional menyertakan metadata lain, termasuk akurasi dan hingga 3 pasangan nilai kunci untuk Anda gunakan sendiri.
Jika pelacak Anda ditautkan ke satu atau beberapa koleksi geofence, pembaruan akan dievaluasi terhadap geofences tersebut (mengikuti aturan pemfilteran yang Anda tentukan untuk pelacak). Jika perangkat melanggar area geofenced (dengan berpindah dari dalam area ke luar, atau sebaliknya), Anda akan menerima acara di. EventBridge Ini ENTER atau EXIT peristiwa mencakup detail pembaruan posisi, termasuk ID perangkat, stempel waktu, dan metadata terkait apa pun.
catatan
Untuk informasi selengkapnya tentang pemfilteran posisi, lihatBuat pelacak.
Untuk informasi selengkapnya tentang peristiwa geofence, lihat. Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge
Gunakan salah satu metode ini untuk mengirim pembaruan perangkat:
-
Kirim MQTT pembaruan ke sumber daya AWS IoT Core dan tautkan ke sumber daya pelacak Anda.
-
Kirim pembaruan lokasi menggunakan Pelacak Lokasi AmazonAPI, dengan menggunakan AWS CLI, atau Lokasi APIs Amazon. Anda dapat menggunakan AWS SDKsuntuk menelepon APIs dari aplikasi iOS atau Android Anda.
Dapatkan riwayat lokasi perangkat dari pelacak
Sumber daya pelacak Lokasi Amazon Anda menyimpan riwayat lokasi semua perangkat yang dilacak selama 30 hari. Anda dapat mengambil riwayat lokasi perangkat, termasuk semua metadata terkait, dari sumber daya pelacak Anda. Contoh berikut menggunakan AWS CLI, atau Lokasi AmazonAPIs.
Cantumkan posisi perangkat Anda
Anda dapat melihat daftar posisi perangkat untuk pelacak menggunakan AWS CLI, atau Lokasi AmazonAPIs, dengan. ListDevicePositions API Saat Anda menelepon ListDevicePositions API, daftar posisi terbaru untuk semua perangkat yang terkait dengan pelacak tertentu dikembalikan. Secara default, ini API mengembalikan 100 posisi perangkat terbaru per halaman hasil untuk pelacak tertentu. Untuk hanya mengembalikan perangkat dalam wilayah tertentu, gunakan FilterGeometry parameter untuk membuat Kueri Poligon Bounding. Dengan cara ini saat Anda menelepon ListDevicePositions, hanya perangkat di dalam poligon yang akan dikembalikan.
catatan
Jika Anda ingin mengenkripsi data menggunakan kunci yang dikelola AWS KMS pelanggan Anda sendiri, maka fitur Bounding Polygon Queries akan dinonaktifkan secara default. Ini karena dengan menggunakan fitur ini, representasi posisi perangkat Anda tidak akan dienkripsi menggunakan kunci AWS KMS terkelola Anda. Posisi perangkat yang tepat, bagaimanapun; masih dienkripsi menggunakan kunci terkelola Anda.
Anda dapat memilih untuk ikut serta dalam fitur Bounding Polygon Queries. Ini dilakukan dengan mengatur KmsKeyEnableGeospatialQueries parameter ke true saat membuat atau memperbarui Tracker.
