Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pelacak Layanan Lokasi Amazon
![\[Diagram ini menunjukkan cara membuat dan menggunakan sumber daya pelacak.\]](http://docs.aws.amazon.com/id_id/location/latest/developerguide/images/illustration-trackers.PNG)
**catatan**
Penyimpanan pelacak dienkripsi dengan kunci yang AWS dimiliki secara otomatis. Anda dapat menambahkan lapisan enkripsi lain menggunakan kunci KMS yang Anda kelola, untuk memastikan bahwa hanya Anda yang dapat mengakses data Anda. Untuk informasi selengkapnya, lihat [Enkripsi data saat istirahat untuk Amazon Location Service](encryption-at-rest.md).
Pelacak menyimpan pembaruan posisi untuk koleksi perangkat. Pelacak dapat digunakan untuk menanyakan lokasi perangkat saat ini atau riwayat lokasi. Ini menyimpan pembaruan, tetapi mengurangi ruang penyimpanan dan kebisingan visual dengan memfilter lokasi sebelum menyimpannya.
Setiap pembaruan posisi yang disimpan dalam sumber daya pelacak Anda dapat mencakup ukuran akurasi posisi dan hingga 3 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.
Pemfilteran dan kueri posisi pelacak berguna sendiri, tetapi pelacak sangat berguna saat dipasangkan dengan geofences. Anda dapat menautkan pelacak ke satu atau beberapa sumber daya pengumpulan geofence Anda, dan pembaruan posisi dievaluasi secara otomatis terhadap geofences dalam koleksi tersebut. Penggunaan penyaringan yang tepat dapat sangat mengurangi biaya evaluasi geofence Anda juga.
1. Pertama, Anda membuat sumber daya pelacak di AWS akun Anda.
1. Selanjutnya, putuskan bagaimana Anda mengirim pembaruan lokasi ke sumber daya pelacak Anda. Gunakan [AWS SDKs](dev-sdks.md)untuk mengintegrasikan kemampuan pelacakan ke dalam aplikasi seluler Anda. [Sebagai alternatif, Anda dapat menggunakan MQTT dengan mengikuti step-by-step petunjuk dalam melacak menggunakan MQTT.](tracking-using-mqtt.md)
1. Anda sekarang dapat menggunakan sumber daya pelacak Anda untuk merekam riwayat lokasi dan memvisualisasikannya di peta.
1. Anda juga dapat menautkan sumber daya pelacak Anda ke satu atau beberapa koleksi geofence sehingga setiap pembaruan posisi yang dikirim ke sumber daya pelacak Anda dievaluasi secara otomatis terhadap semua geofence di semua koleksi geofence yang ditautkan. Anda dapat menautkan sumber daya di halaman detail sumber daya pelacak di konsol Lokasi Amazon atau dengan menggunakan Amazon Location Trackers API.
1. Anda kemudian dapat mengintegrasikan pemantauan menggunakan layanan seperti Amazon CloudWatch dan AWS CloudTrail. Untuk informasi lebih lanjut lihat, [Monitor dengan Amazon CloudWatch](cloudwatch.md) dan[Pantau dan log dengan AWS CloudTrail](cloudtrail.md).
## Fitur
+ **Penyaringan posisi** - Pelacak dapat secara otomatis memfilter posisi yang dikirim kepada mereka. Ada beberapa alasan mengapa Anda mungkin ingin memfilter beberapa pembaruan lokasi perangkat Anda. Jika Anda memiliki sistem yang hanya mengirim laporan setiap menit atau lebih, Anda mungkin ingin memfilter perangkat berdasarkan waktu, menyimpan dan mengevaluasi posisi hanya setiap 30 detik. Bahkan jika Anda memantau lebih sering, Anda mungkin ingin memfilter pembaruan posisi untuk membersihkan kebisingan yang melekat terkait dengan perangkat keras GPS dan pelaporan posisi. Akurasinya tidak 100% sempurna, sehingga bahkan perangkat yang stasioner tampaknya bergerak sedikit. Pada kecepatan rendah, *jitter* ini menyebabkan kekacauan visual dan dapat menyebabkan peristiwa masuk dan keluar yang salah jika perangkat berada di dekat tepi geofence.
Pemfilteran posisi berfungsi saat pembaruan posisi diterima oleh pelacak, mengurangi gangguan visual di jalur perangkat Anda (jitter), mengurangi jumlah peristiwa masuk dan keluar geofence palsu, dan membantu mengelola biaya dengan mengurangi jumlah pembaruan posisi yang disimpan dan evaluasi geofence yang dipicu.
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 GPS dan perangkat seluler menyediakan informasi ini.*
Keakuratan setiap pengukuran posisi dipengaruhi oleh banyak faktor lingkungan, termasuk penerimaan satelit GPS, lanskap, dan kedekatan WiFi dan perangkat Bluetooth. Sebagian besar perangkat, termasuk sebagian besar perangkat seluler, dapat memberikan perkiraan keakuratan pengukuran bersama dengan pengukuran. Dengan `AccuracyBased` pemfilteran, 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, dan tidak ada penyaringan yang akan diterapkan pada pembaruan.
**catatan**
Anda 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.
`DistanceBased`pemfilteran mengabaikan pembaruan lokasi di mana perangkat telah bergerak kurang dari 30 m (98,4 kaki). Saat Anda menggunakan pemfilteran `DistanceBased` posisi, 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, `DistanceBased` penyaringan 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.
Pemfilteran berbasis jarak berguna jika Anda ingin memfilter, tetapi perangkat Anda tidak memberikan pengukuran akurasi, atau Anda ingin memfilter lebih banyak pembaruan dibandingkan dengan berbasis akurasi.
+ **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 `TimeBased` pemfilteran, 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.
Pemfilteran berbasis waktu sangat berguna ketika Anda ingin menyimpan lebih sedikit posisi, tetapi ingin setiap pembaruan posisi dievaluasi terhadap koleksi geofence terkait.
**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.
## Kasus penggunaan untuk pelacak Amazon Location Service
Berikut ini adalah beberapa kegunaan umum untuk pelacak Amazon Location Service.
**Gunakan pelacak dengan geofences**
Pelacak menyediakan fungsionalitas tambahan saat dipasangkan dengan geofences. Anda mengaitkan pelacak dengan koleksi geofence, baik melalui konsol Lokasi Amazon atau API, untuk mengevaluasi lokasi pelacak secara otomatis. Setiap kali pelacak menerima lokasi yang diperbarui, lokasi tersebut akan dievaluasi terhadap setiap geofence dalam koleksi, dan yang sesuai `ENTER` serta `EXIT` peristiwa dihasilkan di Amazon. EventBridge Anda juga dapat menerapkan pemfilteran ke pelacak, dan, tergantung pada pemfilterannya, Anda dapat mengurangi biaya untuk evaluasi geofence dengan hanya mengevaluasi pembaruan lokasi yang bermakna.
Jika Anda mengaitkan pelacak dengan koleksi geofence setelah menerima beberapa pembaruan posisi, pembaruan posisi pertama setelah asosiasi diperlakukan sebagai pembaruan awal untuk evaluasi geofence. Jika berada dalam geofence, Anda akan menerima acara`ENTER`. Jika tidak dalam geofences apa pun, Anda tidak akan menerima `EXIT` acara, terlepas dari keadaan sebelumnya.
**Meningkatkan operasi layanan lapangan**
Pertahankan denyut nadi pada tenaga kerja seluler Anda dengan pelacakan waktu nyata. Tetapkan geofences di sekitar situs pelanggan dan area layanan untuk menerima peringatan ketika staf tiba dan berangkat. Gunakan data lokasi untuk mengoptimalkan penjadwalan, mengirim teknisi terdekat yang tersedia, dan mengurangi waktu respons. Berdayakan tim lapangan Anda (seperti bisnis perbaikan pipa ledeng atau HVAC Anda) untuk bekerja lebih efisien, sambil meningkatkan pengalaman pelanggan.
**Memantau dan mengendalikan aset penting**
Manfaatkan Amazon Location Service untuk melacak lokasi dan status real-time peralatan berharga, inventaris, dan aset seluler Anda lainnya. Siapkan geofences untuk menerima peringatan tentang pergerakan atau pemindahan yang tidak sah, meningkatkan keamanan dan kepatuhan. Gunakan visibilitas lokasi ini untuk meningkatkan pemanfaatan aset, mengoptimalkan jadwal pemeliharaan, dan memastikan sumber daya penting Anda diperhitungkan setiap saat. Selalu pantau alat berat, perangkat keras TI, atau inventaris ritel Anda dengan presisi, kurangi kerugian, dan buat keputusan operasional yang lebih tepat.
**Meningkatkan visibilitas rantai pasokan**
Manfaatkan Amazon Location Service untuk melacak pengiriman dan pengiriman di seluruh rantai pasokan Anda. Tentukan geofences di sekitar pusat distribusi, toko, dan fasilitas utama lainnya untuk memantau pergerakan inventaris dan aset. Gunakan data lokasi real-time untuk meningkatkan manajemen inventaris, mengoptimalkan perencanaan logistik, dan memberikan pengalaman pelanggan yang unggul. Dapatkan end-to-end visibilitas ke dalam operasi rantai pasokan Anda, identifikasi kemacetan, dan buat keputusan berdasarkan data yang mendorong efisiensi dan daya tanggap.
**Pemasaran berbasis lokasi**
Buka kekuatan data lokasi untuk meningkatkan upaya geomarketing Anda. Gunakan Amazon Location Service untuk menetapkan batas virtual di sekitar lokasi pesaing, acara, dan area lalu lintas tinggi. Picu iklan, penawaran, dan pemberitahuan yang dipersonalisasi saat pelanggan memasuki zona geofenced ini. Analisis pola lalu lintas pejalan kaki untuk mengoptimalkan penempatan iklan dan mengungkap situs utama untuk lokasi bisnis baru. Pantau pergerakan pelanggan dalam ruang geografis Anda sendiri untuk mendapatkan wawasan yang lebih dalam tentang perilaku penelusuran dan. path-to-purchase Gabungkan pelacakan lokasi real-time dengan geofencing presisi untuk memberikan keterlibatan kontekstual yang sangat bertarget yang mendorong penjualan dan loyalitas di dunia fisik.
# Konsep pelacak
Bagian ini merinci konsep pelacak umum.
## Terminologi umum pelacak Amazon Location Service
**Sumber daya pelacak**
AWS Sumber daya yang menerima pembaruan lokasi dari perangkat. Sumber daya pelacak menyediakan dukungan untuk kueri lokasi, seperti lokasi perangkat saat ini dan bersejarah. Menautkan sumber daya pelacak ke koleksi geofence mengevaluasi pembaruan lokasi terhadap semua geofences dalam koleksi geofence tertaut secara otomatis.
**Data posisi dilacak**
Sumber daya pelacak menyimpan informasi tentang perangkat Anda dari waktu ke waktu. Informasi tersebut mencakup serangkaian pembaruan posisi, di mana setiap pembaruan mencakup lokasi, waktu, dan metadata opsional. Metadata dapat mencakup akurasi posisi, dan hingga tiga pasangan nilai kunci untuk membantu Anda melacak informasi penting tentang setiap posisi, seperti kecepatan, arah, tekanan ban, sisa bahan bakar, atau suhu mesin kendaraan yang Anda lacak. Pelacak mempertahankan riwayat lokasi perangkat selama 30 hari.
**Penyaringan posisi**
Pemfilteran posisi dapat membantu Anda mengontrol biaya dan meningkatkan kualitas aplikasi pelacakan Anda dengan memfilter pembaruan posisi yang tidak memberikan informasi berharga sebelum pembaruan disimpan atau dievaluasi terhadap geofences.
Anda dapat memilih`AccuracyBased`,`DistanceBased`, atau `TimeBased` memfilter. Secara default, penyaringan posisi diatur ke`TimeBased`.
Anda dapat mengonfigurasi pemfilteran posisi saat membuat atau memperbarui sumber daya pelacak.
**Format stempel waktu RFC 3339 **
Pelacak Amazon Location Service menggunakan format [RFC 3339](https://tools.ietf.org/html/rfc3339), yang mengikuti format [International Organization for Standardization (ISO) 8601](https://www.iso.org/iso-8601-date-and-time-format.html) untuk tanggal dan waktu.
Formatnya adalah “YYYY-MM-:MM: SS.SSSSZ\$1 00:00 “: DDThh
+ `YYYY-MM-DD`— Merupakan format tanggal.
+ `T`— Menunjukkan bahwa nilai waktu akan mengikuti.
+ `hh:mm:ss.sss`— Merupakan waktu dalam format 24 jam.
+ `Z`— Menunjukkan bahwa zona waktu yang digunakan adalah UTC, yang dapat diikuti dengan penyimpangan dari zona waktu UTC.
+ `+00:00`— Secara opsional menunjukkan penyimpangan dari zona waktu UTC. Misalnya, \$1 01:00 menunjukkan UTC \$1 1 jam.
**Contoh**
Untuk 2 Juli 2020, pukul 12:15:20 sore, dengan penyesuaian tambahan 1 jam ke zona waktu UTC.
```
2020-07-02T12:15:20.000Z+01:00
```
# Memulai pelacak Amazon Location Service
Bagian ini memberikan panduan komprehensif untuk membuat dan menggunakan pelacak dengan Lokasi Amazon. Pelacak memungkinkan Anda menyimpan, memproses, dan mengevaluasi posisi perangkat sambil memfilter pembaruan lokasi untuk mengurangi kebisingan dan mengelola biaya. Dengan opsi penyaringan posisi lanjutan, dukungan untuk koleksi geofence tertaut, dan integrasi dengan AWS layanan seperti dan EventBridge IoT Core, pelacak memungkinkan aplikasi pelacakan dan geofencing waktu nyata yang akurat yang disesuaikan dengan kebutuhan spesifik Anda.
**Topics**
+ [Membuat pelacak](start-create-tracker.md)
+ [Mengautentikasi permintaan Anda](tracking-identity-pool.md)
+ [Perbarui pelacak Anda dengan posisi perangkat](send-location-updates.md)
+ [Dapatkan riwayat lokasi perangkat dari pelacak](get-location-history.md)
+ [Buat daftar posisi perangkat Anda](list-device-positions.md)
# Membuat 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 Location APIs.
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 satelit GPS, 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 `AccuracyBased` pemfilteran, 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. `DistanceBased`pemfilteran mengabaikan pembaruan lokasi di mana perangkat telah bergerak kurang dari 30 m (98,4 kaki). Saat Anda menggunakan pemfilteran `DistanceBased` posisi, 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, `DistanceBased` penyaringan 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 `TimeBased` pemfilteran, 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 [Tautkan pelacak ke koleksi geofence](associate-consumer.md).
Anda dapat mengaktifkan acara untuk semua pembaruan posisi yang difilter untuk sumber daya pelacak. Untuk informasi selengkapnya, lihat [Aktifkan peristiwa pembaruan untuk pelacak](location-events.md#enable-update-events).
**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.
------
#### [ Console ]
**Untuk membuat pelacak menggunakan konsol Lokasi Amazon**
1. Buka konsol Amazon Location Service di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Di panel navigasi kiri, pilih **Pelacak**.
1. Pilih **Buat pelacak**.
1. Isi kolom berikut:
+ ****Nama**** — Masukkan nama unik. Misalnya, *ExampleTracker*. Maksimum 100 karakter. Entri yang valid termasuk karakter alfanumerik, tanda hubung, titik, dan garis bawah.
+ ****Deskripsi**** - Masukkan deskripsi opsional.
1. Di bawah **Pemfilteran posisi**, pilih opsi yang paling sesuai dengan cara Anda ingin menggunakan sumber daya pelacak Anda. Jika Anda tidak mengatur **Pemfilteran posisi**, pengaturan defaultnya adalah`TimeBased`. Untuk informasi selengkapnya, lihat [Pelacak Layanan Lokasi Amazon](trackers.md) di panduan ini, dan `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` di Referensi API Amazon Location Service Trackers.
1. (Opsional) Di bawah **Tag**, masukkan tag **Kunci** dan **Nilai**. Ini menambahkan tag koleksi geofence baru Anda. Untuk informasi selengkapnya, lihat [Cara menggunakan tag](manage-resources.md#manage-resources_how-to).
1. (Opsional) Di bawah **enkripsi kunci terkelola Pelanggan**, Anda dapat memilih untuk **Menambahkan kunci terkelola pelanggan**. Ini menambahkan kunci terkelola pelanggan simetris yang Anda buat, miliki, dan kelola melalui enkripsi yang AWS dimiliki default. Untuk informasi selengkapnya, lihat [Mengenkripsi data saat istirahat](encryption-at-rest.md).
1. (Opsional) Di bawah **KmsKeyEnableGeospatialQueries**, Anda dapat memilih untuk mengaktifkan **Kueri Geospasial**. Ini memungkinkan Anda menggunakan fitur Bounding Polygon Queries, sambil mengenkripsi data Anda menggunakan kunci terkelola KMS pelanggan. AWS
**catatan**
Saat Anda menggunakan fitur Bounding Polygon Query, representasi posisi perangkat Anda tidak akan dienkripsi menggunakan kunci terkelola. AWS KMS Namun, posisi perangkat yang tepat masih dienkripsi menggunakan kunci terkelola Anda.
1. (Opsional) Di bawah **EventBridge konfigurasi**, Anda dapat memilih untuk mengaktifkan EventBridge acara untuk pembaruan posisi yang difilter. Ini akan mengirimkan acara setiap kali pembaruan posisi untuk perangkat di pelacak ini memenuhi evaluasi penyaringan posisi.
1. Pilih **Buat pelacak**.
------
#### [ API ]
**Untuk membuat pelacak dengan menggunakan Lokasi Amazon APIs**
Gunakan `[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut menggunakan permintaan API untuk membuat pelacak yang disebut*ExampleTracker*. Sumber daya pelacak dikaitkan dengan [AWS KMS kunci yang dikelola pelanggan untuk mengenkripsi data pelanggan](encryption-at-rest.md), dan tidak [mengaktifkan pembaruan posisi](location-events.md#enable-update-events). EventBridge
```
POST /tracking/v0/trackers
Content-type: application/json
{
"TrackerName": "ExampleTracker",
"Description": "string",
"KmsKeyEnableGeospatialQueries": false,
"EventBridgeEnabled": false,
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"PositionFiltering": "AccuracyBased",
"Tags": {
"string" : "string"
}
}
```
**Buat pelacak dengan diaktifkan `KmsKeyEnableGeospatialQueries`**
Contoh berikut memiliki parameter `KmsKeyEnableGeospatialQueries` diatur ke true. Ini memungkinkan Anda menggunakan fitur Bounding Polygon Queries, sambil mengenkripsi data menggunakan kunci yang dikelola pelanggan. AWS KMS
Untuk informasi tentang penggunaan fitur Bounding Polygon Query, lihat [Buat daftar posisi perangkat Anda](list-device-positions.md)
**catatan**
Saat Anda menggunakan fitur Bounding Polygon Query, representasi posisi perangkat Anda tidak akan dienkripsi menggunakan kunci terkelola. AWS KMS Namun, posisi perangkat yang tepat masih dienkripsi menggunakan kunci terkelola Anda.
```
POST /tracking/v0/trackers
Content-type: application/json
{
"TrackerName": "ExampleTracker",
"Description": "string",
"KmsKeyEnableGeospatialQueries": true,
"EventBridgeEnabled": false,
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"PositionFiltering": "AccuracyBased",
"Tags": {
"string" : "string"
}
}
```
------
#### [ AWS CLI ]
**Untuk membuat pelacak menggunakan perintah AWS CLI **
Gunakan perintah `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`.
Contoh berikut menggunakan AWS CLI untuk membuat pelacak yang disebut*ExampleTracker*. Sumber daya pelacak dikaitkan dengan [AWS KMS kunci yang dikelola pelanggan untuk mengenkripsi data pelanggan](encryption-at-rest.md), dan tidak [mengaktifkan pembaruan posisi](location-events.md#enable-update-events). EventBridge
```
aws location \
create-tracker \
--tracker-name "ExampleTracker" \
--position-filtering "AccuracyBased" \
--event-bridge-enabled false \
--kms-key-enable-geospatial-queries false \
--kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab"
```
**Buat pelacak dengan diaktifkan `KmsKeyEnableGeospatialQueries`**
Contoh berikut memiliki parameter `KmsKeyEnableGeospatialQueries` diatur ke true. Ini memungkinkan Anda menggunakan fitur Bounding Polygon Queries, sambil mengenkripsi data menggunakan kunci yang dikelola pelanggan. AWS KMS
Untuk informasi tentang penggunaan fitur Bounding Polygon Query, lihat [Buat daftar posisi perangkat Anda](list-device-positions.md)
**catatan**
Saat Anda menggunakan fitur Bounding Polygon Query, representasi posisi perangkat Anda tidak akan dienkripsi menggunakan kunci terkelola. AWS KMS Namun, posisi perangkat yang tepat masih dienkripsi menggunakan kunci terkelola Anda.
```
aws location \
create-tracker \
--tracker-name "ExampleTracker" \
--position-filtering "AccuracyBased" \
--event-bridge-enabled false \
--kms-key-enable-geospatial-queries true \
--kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab"
```
------
**catatan**
Penagihan tergantung pada penggunaan Anda. Anda mungkin dikenakan biaya untuk penggunaan AWS layanan lain. Untuk informasi selengkapnya, lihat [harga Amazon Location Service](https://aws.amazon.com/location/pricing/).
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 menjelajahi cara Anda dapat mengakses layanan, lihat[Autentikasi dengan Amazon Location Service](access.md).
+ 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 SDK v3,](https://aws.amazon.com/sdk-for-javascript/) dan Lokasi Amazon. [Web](how-to-auth-helper.md#loc-sdk-auth-web)
```
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, lihat[Membuat pelacak](start-create-tracker.md).
Untuk informasi selengkapnya tentang peristiwa geofence, lihat. [Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge](location-events.md)
Gunakan salah satu metode ini untuk mengirim pembaruan perangkat:
+ [Kirim pembaruan MQTT](tracking-using-mqtt.md) ke sumber daya AWS IoT Core dan tautkan ke sumber daya pelacak Anda.
+ Kirim pembaruan lokasi menggunakan API Pelacak Lokasi Amazon, dengan menggunakan AWS CLI, atau Lokasi APIs Amazon. Anda dapat menggunakan [AWS SDKs](dev-sdks.md)untuk menelepon APIs dari aplikasi iOS atau Android Anda.
------
#### [ API ]
**Untuk mengirim pembaruan posisi menggunakan Lokasi Amazon APIs**
Gunakan `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut menggunakan permintaan API untuk memposting pembaruan posisi perangkat *ExampleDevice* ke pelacak*ExampleTracker*.
```
POST /tracking/v0/trackers/ExampleTracker/positions
Content-type: application/json
{
"Updates": [
{
"DeviceId": "1",
"Position": [
-123.12245146162303, 49.27521118043802
],
"SampleTime": "2022-10-24T19:09:07.327Z",
"PositionProperties": {
"name" : "device1"
},
"Accuracy": {
"Horizontal": 10
}
},
{
"DeviceId": "2",
"Position": [
-123.1230104928471, 49.27752402723152
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "3",
"Position": [
-123.12325592118916, 49.27340530543111
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "4",
"Position": [
-123.11958813096311, 49.27774641063121
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "5",
"Position": [
-123.1277418058896, 49.2765989015285
],
"SampleTime": "2022-10-02T19:09:07.327Z"
},
{
"DeviceId": "6",
"Position": [
-123.11964267059481, 49.274188155916534
],
"SampleTime": "2022-10-02T19:09:07.327Z"
}
]
}
```
------
#### [ AWS CLI ]
**Untuk mengirim pembaruan posisi menggunakan AWS CLI perintah**
Gunakan perintah `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.
Contoh berikut menggunakan AWS CLI untuk memposting pembaruan posisi perangkat untuk *ExampleDevice-1* dan *ExampleDevice-2* ke pelacak*ExampleTracker*.
```
aws location batch-update-device-position \
--tracker-name ExampleTracker \
--updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```
------
# 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 Amazon APIs.
------
#### [ API ]
**Untuk mendapatkan riwayat lokasi perangkat dari pelacak menggunakan Lokasi Amazon APIs**
Gunakan `[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut menggunakan permintaan URI API untuk mendapatkan riwayat lokasi perangkat dari pelacak yang disebut *ExampleTracker* mulai *ExampleDevice* dari `19:05:07` (inklusif) dan berakhir pada `19:20:07` (eksklusif) aktif. `2020–10–02`
```
POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions
Content-type: application/json
{
"StartTimeInclusive": "2020-10-02T19:05:07.327Z",
"EndTimeExclusive": "2020-10-02T19:20:07.327Z"
}
```
------
#### [ AWS CLI ]
**Untuk mendapatkan riwayat lokasi perangkat dari pelacak menggunakan perintah AWS CLI **
Gunakan perintah `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`.
Contoh berikut menggunakan AWS CLI untuk mendapatkan riwayat lokasi perangkat dari pelacak yang disebut *ExampleTracker* mulai *ExampleDevice* dari `19:05:07` (inklusif) dan berakhir pada `19:20:07` (eksklusif) aktif. `2020–10–02`
```
aws location \
get-device-position-history \
--device-id "ExampleDevice" \
--start-time-inclusive "2020-10-02T19:05:07.327Z" \
--end-time-exclusive "2020-10-02T19:20:07.327Z" \
--tracker-name "ExampleTracker"
```
------
# Buat daftar posisi perangkat Anda
Anda dapat melihat daftar posisi perangkat untuk pelacak menggunakan AWS CLI, atau Lokasi Amazon APIs, dengan ListDevicePositions API. Saat Anda memanggil ListDevicePositions API, daftar posisi terbaru untuk semua perangkat yang terkait dengan pelacak tertentu akan ditampilkan. Secara default API ini 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.
------
#### [ API ]
Gunakan `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut adalah permintaan API untuk mendapatkan daftar posisi perangkat di area poligonal, menggunakan parameter opsional. `[FilterGeometry](https://docs.aws.amazon.com/)` Contoh mengembalikan 3 lokasi perangkat hadir di area yang ditentukan oleh `Polygon` array.
```
POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1
Content-type: application/json
{
"FilterGeometry": {
"Polygon": [
[
[
-123.12003339442259,
49.27425121147397
],
[
-123.1176984148229,
49.277063620879744
],
[
-123.12389509145294,
49.277954183760926
],
[
-123.12755921328647,
49.27554025235713
],
[
-123.12330236586217,
49.27211836076236
],
[
-123.12003339442259,
49.27425121147397
]
]
]
},
"MaxResults": 3,
"NextToken": "1234-5678-9012"
}
```
Berikut ini adalah contoh respons untuk`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`:
```
{
"Entries": [
{
"DeviceId": "1",
"SampleTime": "2022-10-24T19:09:07.327Z",
"Position": [
-123.12245146162303,
49.27521118043802
],
"Accuracy": {
"Horizontal": 10
},
"PositionProperties": {
"name": "device1"
}
},
{
"DeviceId": "3",
"SampleTime": "2022-10-02T19:09:07.327Z",
"Position": [
-123.12325592118916,
49.27340530543111
]
},
{
"DeviceId": "2",
"SampleTime": "2022-10-02T19:09:07.327Z",
"Position": [
-123.1230104928471,
49.27752402723152
]
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Gunakan perintah `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan daftar perangkat di area poligonal.
```
aws location list-device-positions TODO: add arguments add props for filter geo
```
------
# Cara bekerja dengan pelacak Amazon Location Service
Bagian ini memberikan petunjuk untuk bekerja dengan pelacak Lokasi Amazon. Pelajari cara memverifikasi posisi perangkat, menautkan pelacak ke koleksi geofence, dan melacak lokasi menggunakan IoT AWS dan MQTT. Selain itu, pelajari cara mengelola pelacak Anda secara efektif untuk mendukung aplikasi berbasis lokasi Anda dan memastikan pelacakan waktu nyata yang akurat.
**Topics**
+ [Verifikasi posisi perangkat](verify-device-positions.md)
+ [Tautkan pelacak ke koleksi geofence](associate-consumer.md)
+ [Lacak penggunaan AWS IoT dan MQTT dengan Amazon Location Service](tracking-using-mqtt.md)
+ [Kelola pelacak Layanan Lokasi Amazon Anda](managing-trackers.md)
# Verifikasi posisi perangkat
Untuk memeriksa integritas posisi perangkat, gunakan [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API. API ini menampilkan informasi tentang integritas posisi perangkat, dengan mengevaluasi properti seperti sinyal sel perangkat, titik akses Wi-Fi, alamat Ipv4, dan jika proxy sedang digunakan.
## Prasyarat
Sebelum dapat menggunakan yang tercantum APIs untuk verifikasi perangkat, pastikan Anda memiliki prasyarat berikut:
+ Anda telah membuat pelacak untuk perangkat atau perangkat yang ingin Anda periksa. Untuk informasi selengkapnya, lihat [Memulai pelacak Amazon Location Service](start-tracking.md).
Contoh berikut menunjukkan permintaan untuk Amazon Location [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API.
------
#### [ API ]
**Untuk memverifikasi posisi perangkat menggunakan Lokasi Amazon APIs**
Gunakan `[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)` operasi dari Pelacakan Lokasi Amazon APIs.
Contoh berikut menunjukkan permintaan API untuk mengevaluasi integritas posisi perangkat. Ganti nilai-nilai ini dengan perangkat Anda sendiri IDs.
```
POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1
Content-type: application/json
{
"DeviceState": {
"Accuracy": {
"Horizontal": number
},
"CellSignals": {
"LteCellDetails": [
{
"CellId": number,
"LocalId": {
"Earfcn": number,
"Pci": number
},
"Mcc": number,
"Mnc": number,
"NetworkMeasurements": [
{
"CellId": number,
"Earfcn": number,
"Pci": number,
"Rsrp": number,
"Rsrq": number
}
],
"NrCapable": boolean,
"Rsrp": number,
"Rsrq": number,
"Tac": number,
"TimingAdvance": number
}
]
},
"DeviceId": "ExampleDevice",
"Ipv4Address": "string",
"Position": [ number ],
"SampleTime": "string",
"WiFiAccessPoints": [
{
"MacAddress": "string",
"Rss": number
}
]
},
"DistanceUnit": "string"
}
```
------
**catatan**
**Integrity SDK** menyediakan fitur yang disempurnakan terkait dengan verifikasi perangkat, dan tersedia untuk digunakan berdasarkan permintaan. Untuk mendapatkan akses ke SDK, hubungi [Sales Support](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn).
# Tautkan pelacak ke koleksi geofence
Sekarang setelah Anda memiliki koleksi geofence dan pelacak, Anda dapat menautkannya bersama-sama sehingga pembaruan lokasi secara otomatis dievaluasi terhadap semua geofences Anda. Jika Anda tidak ingin mengevaluasi semua pembaruan lokasi, atau sebagai alternatif, jika Anda tidak menyimpan beberapa lokasi di sumber daya pelacak, Anda dapat [mengevaluasi posisi perangkat terhadap geofences](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) sesuai permintaan.
Ketika posisi perangkat dievaluasi terhadap geofences, peristiwa dihasilkan. Anda dapat mengatur tindakan untuk acara ini. Untuk informasi selengkapnya tentang tindakan yang dapat Anda setel untuk peristiwa geofence, lihat [Meneaksi peristiwa Amazon Location Service dengan](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html) Amazon. EventBridge
Peristiwa Lokasi Amazon menyertakan atribut pembaruan posisi perangkat yang menghasilkannya dan beberapa atribut geofence yang dimasukkan atau keluar. Untuk informasi selengkapnya tentang data yang disertakan dalam peristiwa geofence, lihat. [Contoh EventBridge acara Amazon untuk Amazon Location Service](location-events.md#example-event)
Contoh berikut menautkan sumber daya pelacak ke koleksi geofence menggunakan konsol, lokasi, atau Amazon. AWS CLI APIs
------
#### [ Console ]
**Untuk menautkan sumber daya pelacak ke koleksi geofence menggunakan konsol Amazon Location Service**
1. Buka konsol Amazon Location Service di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Di panel navigasi kiri, pilih **Pelacak**.
1. Di bawah **Pelacak perangkat**, pilih tautan nama pelacak target.
1. Di bawah **Koleksi Geofence Tertaut**, pilih **Link Geofence** Collection.
1. Di jendela **Linked Geofence Collection, pilih koleksi** geofence dari menu tarik-turun.
1. Pilih **Tautkan**.
Setelah Anda menautkan sumber daya pelacak, itu akan diberi status **Aktif**.
------
#### [ API ]
**Untuk menautkan sumber daya pelacak ke koleksi geofence menggunakan Lokasi Amazon APIs**
Gunakan `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut menggunakan permintaan API yang terkait *ExampleTracker* dengan koleksi geofence menggunakan [Amazon Resource Name (](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)ARN).
```
POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json
{
"ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}
```
------
#### [ AWS CLI ]
**Untuk menautkan sumber daya pelacak ke koleksi geofence menggunakan perintah AWS CLI **
Gunakan perintah `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`.
Contoh berikut menggunakan AWS CLI untuk membuat koleksi geofence yang disebut. *ExampleGeofenceCollection*
```
aws location \
associate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
--tracker-name "ExampleTracker"
```
------
# Lacak penggunaan AWS IoT dan MQTT dengan Amazon Location Service
[MQTT](http://mqtt.org/) adalah protokol pesan ringan dan diadopsi secara luas yang dirancang untuk perangkat terbatas. AWS IoT Core mendukung koneksi perangkat yang menggunakan protokol MQTT dan protokol MQTT over WebSocket Secure (WSS).
[AWS IoT Core](https://aws.amazon.com/iot-core/)menghubungkan perangkat ke AWS dan memungkinkan Anda untuk mengirim dan menerima pesan di antara mereka. Mesin AWS IoT Core aturan menyimpan kueri tentang topik pesan perangkat Anda dan memungkinkan Anda menentukan tindakan untuk mengirim pesan ke AWS layanan lain, seperti Amazon Location Service. Perangkat yang mengetahui lokasinya sebagai koordinat dapat meneruskan lokasinya ke Lokasi Amazon melalui mesin aturan.
**catatan**
Perangkat mungkin mengetahui posisinya sendiri, misalnya melalui GPS bawaan. AWS IoT juga memiliki dukungan untuk pelacakan lokasi perangkat pihak ketiga. Untuk informasi selengkapnya, lihat [Lokasi Perangkat AWS IoT Inti](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) di *Panduan Pengembang AWS IoT Inti*.
Panduan berikut menjelaskan pelacakan menggunakan AWS IoT Core aturan. Anda juga dapat mengirim informasi perangkat ke AWS Lambda fungsi Anda sendiri, jika Anda perlu memprosesnya sebelum mengirim ke Lokasi Amazon. Untuk detail selengkapnya tentang penggunaan Lambda untuk memproses lokasi perangkat, lihat. [Gunakan AWS Lambda dengan MQTT](tracking-using-mqtt-with-lambda.md)
**Topics**
+ [Prasyarat](#mqtt-prerequisite)
+ [Buat AWS IoT Core aturan](#mqtt-create-iot-rule)
+ [Uji AWS IoT Core aturan Anda di konsol](#mqtt-test-iot-rule)
+ [Gunakan AWS Lambda dengan MQTT](tracking-using-mqtt-with-lambda.md)
## Prasyarat
Sebelum Anda dapat mulai melacak, Anda harus menyelesaikan prasyarat berikut:
+ [Buat sumber daya pelacak](start-create-tracker.md) yang akan Anda kirimi data lokasi perangkat.
+ [Buat peran IAM](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html) untuk memberikan AWS IoT Core akses ke pelacak Anda.
Saat mengikuti langkah-langkah tersebut, gunakan kebijakan berikut untuk memberikan akses ke pelacak Anda:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
## Buat AWS IoT Core aturan
Selanjutnya, buat AWS IoT Core aturan untuk meneruskan telemetri posisi perangkat Anda ke Amazon Location Service. Untuk informasi selengkapnya tentang membuat aturan, lihat topik berikut di *Panduan AWS IoT Core Pengembang*:
+ [Membuat AWS IoT aturan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) untuk informasi tentang membuat aturan baru.
+ [Tindakan lokasi](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) untuk informasi khusus untuk membuat aturan untuk penerbitan ke Lokasi Amazon
## Uji AWS IoT Core aturan Anda di konsol
Jika saat ini tidak ada perangkat yang menerbitkan telemetri yang menyertakan lokasi, Anda dapat menguji aturan menggunakan konsol. AWS IoT Core Konsol memiliki klien pengujian tempat Anda dapat mempublikasikan pesan sampel untuk memverifikasi hasil solusi.
1. Masuk ke AWS IoT Core konsol di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Di navigasi kiri, perluas **Uji**, dan pilih klien uji **MQTT**.
1. Di bawah **Publikasikan ke topik****, setel nama Topik** ke *iot/topic* (atau nama topik yang Anda atur dalam AWS IoT Core aturan, jika berbeda), dan berikan yang berikut ini untuk **muatan Pesan**. Ganti stempel waktu *1604940328* dengan stempel waktu yang valid dalam 30 hari terakhir (stempel waktu yang lebih lama dari 30 hari diabaikan oleh pelacak Amazon Location Service).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Pilih **Publikasikan** ke topik untuk mengirim pesan pengujian.
1. Untuk memvalidasi bahwa pesan diterima oleh Amazon Location Service, gunakan AWS CLI perintah berikut. Jika Anda memodifikasinya selama pengaturan, ganti nama pelacak dengan yang Anda gunakan.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# Gunakan AWS Lambda dengan MQTT
Meskipun penggunaan AWS Lambda tidak lagi diperlukan saat mengirim data lokasi perangkat ke Lokasi Amazon untuk dilacak, Anda mungkin masih ingin menggunakan Lambda dalam beberapa kasus. Misalnya, jika Anda ingin memproses sendiri data lokasi perangkat Anda, sebelum mengirimkannya ke Lokasi Amazon. Topik berikut menjelaskan cara menggunakan Lambda untuk memproses pesan sebelum mengirimnya ke pelacak Anda. Untuk informasi lebih lanjut tentang pola ini, lihat [arsitektur referensi](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf).
**Topics**
+ [Prasyarat](#mqtt-prerequisite-with-lambda)
+ [Buat fungsi Lambda](#mqtt-with-lambda-create-lambda)
+ [Buat AWS IoT Core aturan](#mqtt-create-iot-rule-with-lambda)
+ [Uji AWS IoT Core aturan Anda di konsol](#mqtt-test-iot-rule-with-lambda)
## Prasyarat
Sebelum Anda dapat mulai melacak, Anda harus [membuat sumber daya pelacak](start-tracking.md). Untuk membuat sumber daya pelacak, Anda dapat menggunakan konsol Lokasi Amazon, lokasi AWS CLI, atau Amazon Location APIs.
Contoh berikut menggunakan konsol Amazon Location Service untuk membuat resource tracker:
1. Buka konsol Amazon Location Service di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Di panel navigasi kiri, pilih **Pelacak**.
1. Pilih **Buat pelacak**.
1. Isi kotak-kotak berikut:
+ **Nama** — Masukkan nama unik yang memiliki maksimal 100 karakter. Entri yang valid termasuk karakter alfanumerik, tanda hubung, dan garis bawah. Misalnya, *MyTracker*.
+ **Deskripsi** - Masukkan deskripsi opsional. Misalnya, *Tracker for storing AWS IoT Core device positions*.
+ **Pemfilteran posisi** - Pilih pemfilteran yang ingin Anda gunakan untuk pembaruan posisi. Misalnya, pemfilteran **berbasis akurasi**.
1. Pilih **Buat pelacak**.
## Buat fungsi Lambda
Untuk membuat koneksi antara AWS IoT Core dan Amazon Location Service, Anda memerlukan AWS Lambda fungsi untuk memproses pesan yang diteruskan oleh. AWS IoT Core Fungsi ini akan mengekstrak data posisi apa pun, memformatnya untuk Amazon Location Service, dan mengirimkannya melalui Amazon Location Tracker API. Anda dapat membuat fungsi ini melalui AWS Lambda konsol, atau Anda dapat menggunakan AWS Command Line Interface (AWS CLI) atau AWS Lambda APIs.
Untuk membuat fungsi Lambda yang menerbitkan pembaruan posisi ke Lokasi Amazon menggunakan konsol:
1. Buka AWS Lambda konsol di [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home).
1. Dari navigasi kiri, pilih **Fungsi**.
1. Pilih **Create Function**, dan pastikan bahwa **Author dari awal** dipilih.
1. Isi kotak-kotak berikut:
+ **Nama fungsi** - Masukkan nama unik untuk fungsi Anda. Entri yang valid termasuk karakter alfanumerik, tanda hubung, dan garis bawah tanpa spasi. Misalnya, *MyLambda*.
+ **Runtime** — Pilih*Python 3.8*.
1. Pilih **Buat fungsi**.
1. Pilih tab **Kode** untuk membuka editor.
1. [Timpa kode placeholder `lambda_function.py` dengan yang berikut ini, ganti nilai yang ditetapkan `TRACKER_NAME` dengan nama pelacak yang Anda buat sebagai prasyarat.](#mqtt-prerequisite-with-lambda)
```
from datetime import datetime
import json
import os
import boto3
# Update this to match the name of your Tracker resource
TRACKER_NAME = "MyTracker"
"""
This Lambda function receives a payload from AWS IoT Core and publishes device updates to
Amazon Location Service via the BatchUpdateDevicePosition API.
Parameter 'event' is the payload delivered from AWS IoT Core.
In this sample, we assume that the payload has a single top-level key 'payload' and a nested key
'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in
the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For
example:
>>> event
{ 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328,
'location': { 'lat': 49.2819, 'long': -123.1187 },
'accuracy': {'Horizontal': 20.5 },
'positionProperties': {'field1':'value1','field2':'value2'} }
}
If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to
format the data before delivering it to this Lambda function, or you can modify the code below to
match it.
"""
def lambda_handler(event, context):
update = {
"DeviceId": event["payload"]["deviceid"],
"SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"),
"Position": [
event["payload"]["location"]["long"],
event["payload"]["location"]["lat"]
]
}
if "accuracy" in event["payload"]:
update["Accuracy"] = event["payload"]['accuracy']
if "positionProperties" in event["payload"]:
update["PositionProperties"] = event["payload"]['positionProperties']
client = boto3.client("location")
response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update])
return {
"statusCode": 200,
"body": json.dumps(response)
}
```
1. Pilih **Deploy** untuk menyimpan fungsi yang diperbarui.
1. Pilih tab **Konfigurasi**.
1. Di bagian **Izin, pilih nama Peran** hyperlink untuk memberikan izin Amazon Location Service ke fungsi Lambda Anda.
1. Dari halaman **Ringkasan** peran Anda, pilih **Tambahkan izin**, lalu dari daftar tarik-turun, pilih **Buat** kebijakan sebaris.
1. Pilih tab **JSON**, dan timpa kebijakan dengan dokumen berikut. Ini memungkinkan fungsi Lambda Anda memperbarui posisi perangkat yang dikelola oleh semua sumber daya pelacak di semua Wilayah.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
1. Pilih **Tinjau kebijakan**.
1. Masukkan nama kebijakan. Misalnya, *AmazonLocationTrackerWriteOnly*.
1. Pilih **Buat kebijakan**.
Anda dapat memodifikasi kode fungsi ini, jika perlu, untuk beradaptasi dengan skema pesan perangkat Anda sendiri.
## Buat AWS IoT Core aturan
Selanjutnya, buat AWS IoT Core aturan untuk meneruskan telemetri posisi perangkat Anda ke AWS Lambda fungsi untuk transformasi dan publikasi ke Amazon Location Service. Aturan contoh yang diberikan mengasumsikan bahwa setiap transformasi muatan perangkat yang diperlukan ditangani oleh fungsi Lambda Anda. Anda dapat membuat aturan ini melalui AWS IoT Core konsol, AWS Command Line Interface (AWS CLI), atau AWS IoT Core APIs.
**catatan**
Meskipun AWS IoT konsol menangani izin yang diperlukan AWS IoT Core untuk mengizinkan menjalankan fungsi Lambda, jika Anda membuat aturan dari AWS CLI atau SDK, Anda [harus mengonfigurasi kebijakan untuk memberikan](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements) izin. AWS IoT
**Untuk membuat AWS IoT Core menggunakan konsol**
1. Masuk ke AWS IoT Core konsol di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Di navigasi kiri, perluas **Act**, dan pilih **Rules**.
1. Pilih **Buat aturan** untuk memulai panduan aturan baru.
1. Masukkan nama dan deskripsi untuk aturan Anda.
1. Untuk **pernyataan kueri Aturan**, perbarui `FROM` atribut untuk merujuk ke topik di mana setidaknya satu perangkat menerbitkan telemetri yang menyertakan lokasi. Jika Anda menguji solusinya, tidak diperlukan modifikasi.
```
SELECT * FROM 'iot/topic'
```
1. Di bawah **Setel satu atau beberapa tindakan**, pilih **Tambah tindakan**.
1. Pilih **Kirim pesan ke fungsi lambda**.
1. Pilih **Konfigurasi tindakan**.
1. Temukan dan pilih fungsi Lambda Anda dari daftar.
1. Pilih **Tambahkan tindakan**.
1. Pilih **Buat aturan**.
## Uji AWS IoT Core aturan Anda di konsol
Jika saat ini tidak ada perangkat yang menerbitkan telemetri yang menyertakan lokasi, Anda dapat menguji aturan dan solusi ini menggunakan konsol. AWS IoT Core Konsol memiliki klien pengujian tempat Anda dapat mempublikasikan pesan sampel untuk memverifikasi hasil solusi.
1. Masuk ke AWS IoT Core konsol di [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Di navigasi kiri, perluas **Uji**, dan pilih klien uji **MQTT**.
1. Di bawah **Publikasikan ke topik****, setel nama Topik** ke *iot/topic* (atau nama topik yang Anda atur dalam AWS IoT Core aturan, jika berbeda), dan berikan yang berikut ini untuk **muatan Pesan**. Ganti stempel waktu *1604940328* dengan stempel waktu yang valid dalam 30 hari terakhir (stempel waktu yang lebih dari 30 hari diabaikan).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Pilih **Publikasikan** ke topik untuk mengirim pesan pengujian.
1. Untuk memvalidasi bahwa pesan diterima oleh Amazon Location Service, gunakan AWS CLI perintah berikut. Jika Anda memodifikasinya selama penyiapan, ganti nama pelacak dan id perangkat dengan yang Anda gunakan.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# Kelola pelacak Layanan Lokasi Amazon Anda
Anda dapat mengelola pelacak menggunakan konsol Amazon Location, the AWS CLI, atau Amazon Location APIs.
## Daftar pelacak Anda
Anda dapat melihat daftar pelacak menggunakan konsol Lokasi Amazon, lokasi Amazon AWS CLI, atau Lokasi APIs Amazon:
------
#### [ Console ]
**Untuk melihat daftar pelacak yang ada menggunakan konsol Lokasi Amazon**
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **Pelacak** dari navigasi kiri.
1. Lihat daftar sumber daya pelacak Anda di bawah **Pelacak saya**.
------
#### [ API ]
Gunakan `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut adalah permintaan API untuk mendapatkan daftar pelacak di AWS akun Anda.
```
POST /tracking/v0/list-trackers
```
Berikut ini adalah contoh respons untuk`[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`:
```
{
"Entries": [
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Gunakan perintah `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan daftar pelacak di AWS akun Anda.
```
aws location list-trackers
```
------
## Memutuskan sambungan pelacak dari koleksi geofence
Anda dapat memutuskan sambungan pelacak dari koleksi geofence menggunakan konsol Lokasi Amazon, AWS CLI atau Lokasi Amazon: APIs
------
#### [ Console ]
**Untuk memisahkan pelacak dari koleksi geofence terkait menggunakan konsol Lokasi Amazon**
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **Pelacak** dari panel navigasi kiri.
1. Di bawah **Pelacak saya**, pilih tautan nama pelacak target.
1. **Di bawah Koleksi **Geofence Tertaut, pilih koleksi** geofence dengan status Tertaut.**
1. Pilih **Putuskan Tautan**.
------
#### [ API ]
Gunakan `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` operasi dari Pelacak APIs Lokasi Amazon.
Contoh berikut adalah permintaan API untuk memisahkan pelacak dari koleksi geofence terkait.
```
DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection
```
Berikut ini adalah contoh respons untuk`[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`:
```
HTTP/1.1 200
```
------
#### [ CLI ]
Gunakan perintah `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`.
Contoh berikut adalah AWS CLI perintah untuk memisahkan pelacak dari koleksi geofence terkait.
```
aws location disassociate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \
--tracker-name "ExampleTracker"
```
------
## Dapatkan detail pelacak
Anda bisa mendapatkan detail tentang pelacak apa pun di AWS akun Anda dengan menggunakan konsol Lokasi Amazon, the AWS CLI, atau Lokasi APIs Amazon.
------
#### [ Console ]
**Untuk melihat detail pelacak dengan menggunakan konsol Lokasi Amazon**
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **Pelacak** dari navigasi kiri.
1. Di bawah **Pelacak saya**, pilih tautan nama pelacak target.
1. Lihat detail pelacak di bawah **Informasi**.
------
#### [ API ]
Gunakan `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` operasi dari Amazon Location Tracker APIs.
Contoh berikut adalah permintaan API untuk mendapatkan detail pelacak. *ExampleTracker*
```
GET /tracking/v0/trackers/ExampleTracker
```
Berikut ini adalah contoh respons untuk`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`:
```
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"EventBridgeEnabled": false,
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"PositionFiltering": "TimeBased",
"Tags": {
"Tag1" : "Value1"
},
"TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
```
------
#### [ CLI ]
Gunakan perintah `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`.
Contoh berikut adalah AWS CLI perintah untuk mendapatkan detail pelacak untuk*ExampleTracker*.
```
aws location describe-tracker \
--tracker-name "ExampleTracker"
```
------
## Hapus pelacak
Anda dapat menghapus pelacak dari AWS akun menggunakan konsol Lokasi Amazon, lokasi Amazon AWS CLI, atau Lokasi APIs Amazon:
------
#### [ Console ]
**Untuk menghapus sumber daya peta yang ada menggunakan konsol Lokasi Amazon**
**Awas**
Operasi ini menghapus sumber daya secara permanen. Jika sumber daya pelacak sedang digunakan, Anda mungkin mengalami kesalahan. Pastikan bahwa sumber daya target bukan dependensi untuk aplikasi Anda.
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **Pelacak** dari panel navigasi kiri.
1. Di bawah **Pelacak saya**, pilih pelacak target.
1. Pilih **Hapus pelacak**.
------
#### [ API ]
Gunakan `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` operasi dari Amazon Location Tracker APIs.
Contoh berikut adalah permintaan API untuk menghapus pelacak*ExampleTracker*.
```
DELETE /tracking/v0/trackers/ExampleTracker
```
Berikut ini adalah contoh respons untuk`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`:
```
HTTP/1.1 200
```
------
#### [ CLI ]
Gunakan perintah `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`.
Contoh berikut adalah AWS CLI perintah untuk menghapus pelacak*ExampleTracker*.
```
aws location delete-tracker \
--tracker-name "ExampleTracker"
```
------
# Mengelola biaya dan penggunaan
Saat Anda terus belajar tentang pelacak Lokasi Amazon, penting untuk memahami cara mengelola kapasitas layanan, memastikan Anda mengikuti batas penggunaan, dan mendapatkan hasil terbaik melalui pengoptimalan kuota dan API. Dengan menerapkan praktik terbaik untuk kinerja dan akurasi, Anda dapat menyesuaikan aplikasi Anda untuk menangani kueri terkait tempat secara efisien dan memaksimalkan permintaan API Anda.
**Topics**
+ [Harga pelacak](trackers-pricing.md)
+ [Kuota dan penggunaan pelacak](trackers-quotas.md)
# Harga pelacak
Untuk informasi harga untuk tracking dan geofencing APIs, lihat halaman [harga Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Posisi Ditulis**
Anda dapat menggunakan `BatchUpdateDevicePosition` untuk mengunggah data pembaruan posisi untuk satu atau beberapa perangkat ke sumber daya pelacak (hingga sepuluh perangkat per batch). Harga didasarkan pada jumlah posisi perangkat dalam permintaan API Anda. Harga satuan per pembaruan posisi perangkat didasarkan pada total volume penggunaan bulanan. Lihat [halaman harga Amazon Location Service](https://aws.amazon.com/location/pricing/) untuk detail harga satuan dan tingkatan volume.
Anda dapat mengoptimalkan biaya Ditulis Posisi dengan mengonfigurasi frekuensi pembaruan posisi perangkat (juga dikenal sebagai ping rate) dari perangkat pelacak, dan secara opsional menggunakan filter lokal untuk hanya mengunggah pembaruan posisi perangkat yang relevan ke Amazon Location Service.
**Posisi Baca**
Anda dapat menggunakan `BatchGetDevicePosition` daftar posisi perangkat terbaru untuk perangkat yang diminta, hingga 100 perangkat per permintaan. Anda juga dapat menggunakan `GetDevicePosition` untuk mengambil posisi terbaru perangkat sesuai dengan waktu sampelnya.
Harga didasarkan pada jumlah permintaan API.
**Hapus Posisi**
Anda dapat menggunakan `BatchDeleteDevicePositionHistory` untuk menghapus riwayat posisi satu atau beberapa perangkat dari sumber daya pelacak, hingga 100 perangkat per permintaan.
Harga didasarkan pada jumlah perangkat dalam permintaan API Anda.
**Evaluasi Integritas Posisi**
Anda dapat menggunakan `VerifyDevicePosition` untuk memverifikasi integritas posisi perangkat dengan menentukan apakah itu dilaporkan di belakang proxy, dan dengan membandingkannya dengan perkiraan posisi yang disimpulkan berdasarkan status perangkat.
Harga didasarkan pada jumlah permintaan API.
# Kuota dan penggunaan pelacak
Topik ini memberikan ringkasan batas tarif dan kuota untuk pelacak Amazon Location Service.
**catatan**
Jika Anda memerlukan kuota yang lebih tinggi, Anda dapat menggunakan konsol Service Quotas [untuk meminta peningkatan kuota untuk kuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) yang dapat disesuaikan. Saat meminta kenaikan kuota, pilih Wilayah tempat Anda memerlukan peningkatan kuota, karena sebagian besar kuota khusus untuk Wilayah. AWS Anda dapat meminta hingga dua kali batas default untuk setiap API.
Untuk permintaan yang melebihi dua kali batas default, permintaan Anda akan mengirimkan tiket dukungan. Anda juga dapat terhubung ke tim dukungan premium Anda. Tidak ada biaya langsung untuk permintaan peningkatan kuota, tetapi tingkat penggunaan yang lebih tinggi dapat menyebabkan peningkatan biaya layanan berdasarkan sumber daya tambahan yang dikonsumsi. Untuk informasi selengkapnya, lihat [Kelola kuota dengan Service Quotas](manage-quotas.md).
Service Quotas adalah jumlah maksimum sumber daya yang dapat Anda miliki per AWS akun dan AWS Wilayah. Amazon Location Service menolak permintaan tambahan yang melebihi kuota layanan.
## Sumber Daya
| Nama API | Default | Batas maksimum yang dapat disesuaikan |
| --- | --- | --- |
| Sumber daya pelacak per akun | 500 | 1000 Jika Anda membutuhkan lebih dari ini, [minta kenaikan kuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) atau hubungi tim dukungan. |
| Pelacak konsumen per pelacak | 5 | Batas maksimum yang dapat disesuaikan tidak berlaku. Hubungi tim dukungan. |
## API MENTAH
**catatan**
Jika Anda memerlukan batas yang lebih tinggi untuk semua ini APIs, [minta kenaikan kuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) atau hubungi tim dukungan.
| Nama API | Default | Batas maksimum yang dapat disesuaikan |
| --- | --- | --- |
| [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 |
| [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 |
| [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 |
| [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 |
| [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 |
| [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 |
| [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 |
| [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 |
## Data API
**catatan**
Jika Anda memerlukan batas yang lebih tinggi untuk semua ini APIs, [minta kenaikan kuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) atau hubungi tim dukungan.
| Nama API | Default | Batas maksimum yang dapat disesuaikan |
| --- | --- | --- |
| [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 |
| [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 |
| [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 |
| [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 |
| [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 |
| [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 |
## Batas penggunaan lainnya