

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

# Membuat pelacak
<a name="start-create-tracker"></a>

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.