Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Geofences Layanan Lokasi Amazon
![\[Ikhtisar Amazon Location Service Geofences.\]](http://docs.aws.amazon.com/id_id/location/latest/developerguide/images/geofences-overview.png)
Sumber daya pengumpulan geofence memungkinkan Anda untuk menyimpan dan mengelola geofences - batas virtual pada peta. Anda dapat mengevaluasi lokasi terhadap sumber daya pengumpulan geofence dan menerima pemberitahuan saat pembaruan lokasi melintasi batas salah satu geofences dalam koleksi.
**Geofences dan koleksi geofence**
Geofence adalah lingkaran, poligon, atau geometri multipoligon yang mendefinisikan batas virtual pada peta. Koleksi geofence berisi nol atau lebih geofences. Ini mampu memantau geofence dengan memancarkan `ENTER` dan `EXIT` peristiwa, ketika diminta, untuk mengevaluasi posisi perangkat terhadap geofences nya.
**Acara geofence**
Lokasi untuk posisi yang Anda pantau direferensikan oleh ID yang disebut a`DeviceId`. Posisi disebut sebagai posisi perangkat. Anda dapat mengirim daftar posisi perangkat untuk mengevaluasi langsung ke sumber daya pengumpulan geofence, atau Anda dapat menggunakan pelacak. Untuk informasi selengkapnya tentang menggunakan pelacak, lihat[Pelacak Layanan Lokasi Amazon](trackers.md).
Anda menerima peristiwa (melalui Amazon EventBridge) hanya ketika perangkat masuk atau keluar dari geofence, tidak untuk setiap perubahan posisi. Ini berarti bahwa Anda biasanya akan menerima acara dan harus meresponsnya jauh lebih jarang daripada setiap pembaruan posisi perangkat.
**catatan**
Untuk evaluasi lokasi pertama untuk spesifik`DeviceID`, diasumsikan bahwa perangkat sebelumnya tidak berada di geofences apa pun. Jadi pembaruan pertama akan menghasilkan `ENTER` acara, jika di dalam geofence dalam koleksi, dan tidak ada acara jika tidak.
Untuk menghitung apakah perangkat telah masuk atau keluar dari geofence, Amazon Location Service harus mempertahankan status posisi sebelumnya untuk perangkat tersebut. Status posisi ini disimpan selama 30 hari. Setelah 30 hari tanpa pembaruan untuk perangkat, pembaruan lokasi baru akan diperlakukan sebagai pembaruan posisi pertama.
## Kasus penggunaan untuk Amazon Location Service Geofences
Berikut ini adalah beberapa kegunaan umum untuk Amazon Location Service Geofences.
**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.
**Memperkuat keselamatan dan keamanan**
Geofencing memungkinkan Anda untuk mengatur batas virtual di sekitar area aman, zona terbatas, dan lokasi penting lainnya. Menerima peringatan instan ketika personel atau aset yang tidak sah masuk atau keluar dari geofences yang telah ditentukan ini. Manfaatkan pemantauan lokasi real-time ini untuk meningkatkan keselamatan tempat kerja, mencegah pelanggaran, dan memastikan kepatuhan terhadap peraturan. Baik Anda mengelola fasilitas manufaktur, lokasi konstruksi, atau kampus perusahaan, geofencing memberdayakan Anda untuk mempertahankan kontrol yang lebih ketat atas akses, meningkatkan respons insiden, dan melindungi orang, properti, dan aset Anda.
**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 menemukan 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 geofence
Bagian ini menjelaskan beberapa konsep geofence umum, termasuk terminologi umum dan cara mengelola geofences.
## Terminologi geofence Amazon Location Service
Geofensi
Batas virtual untuk area geografis di peta.
Koleksi Geofence
Sekelompok geofences yang mampu memancarkan `Entry` dan `Exit` peristiwa, ketika diminta, untuk mengevaluasi posisi perangkat terhadap geofences komponennya.
Geometri geofensi
Bentuk geometris atau serangkaian bentuk yang menentukan area yang akan dimasukkan atau dikecualikan dari geofence. Geometri geofence dapat direpresentasikan sebagai`Circle`,, `Polygon` atau. `MultiPolygon`
A `Circle` adalah titik dengan jarak di sekitarnya. Gunakan lingkaran saat Anda ingin diberi tahu jika perangkat berada dalam jarak tertentu dari suatu lokasi.
A `Polygon` adalah daftar cincin linier yang mewakili bentuk geofence. Daftar ini *harus* mencakup cincin eksterior yang mewakili perimeter luar geofensi, dan secara opsional dapat mencakup beberapa cincin interior yang mewakili ruang poligonal di dalam perimeter, yang dikecualikan dari area geofensi.
A `MultiPolygon` adalah `Polygon` elemen daftar yang mewakili bentuk geofence. `Polygon`Komponen `MultiPolygon` geometri dapat menentukan wilayah geografis terpisah yang dianggap sebagai bagian dari geofence yang sama, perimeter area eksterior yang lebih besar dengan ruang interior yang lebih kecil yang dikecualikan dari geofence, atau beberapa kombinasi dari kasus penggunaan ini untuk membentuk batas geofensi yang kompleks.
Untuk informasi selengkapnya tentang mendefinisikan geometri geofence, termasuk persyaratan sintaks, batasan, dan contoh, lihat di Referensi API [GeofenceGeometry](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html)Amazon Location *Service*.
# Memulai Amazon Location Service Geofences
Geofences adalah alat yang ampuh untuk menentukan batas geografis dan memicu tindakan berdasarkan pembaruan lokasi. Panduan ini memandu Anda melalui proses pembuatan dan penggunaan sumber daya pengumpulan geofence di Lokasi Amazon. Dengan menyiapkan geofences dan mengevaluasi lokasi terhadapnya, Anda dapat memantau pergerakan dan menghasilkan peristiwa otomatis, seperti pemberitahuan saat perangkat masuk atau keluar dari area yang ditentukan. Fitur-fitur ini ideal untuk aplikasi seperti pelacakan armada, notifikasi berbasis lokasi, dan banyak lagi.
1. Buat sumber daya koleksi geofence di akun Anda AWS .
1. Tambahkan geofences ke koleksi. Anda dapat menggunakan alat unggah geofence di konsol Lokasi Amazon atau Amazon Location Geofences API. Untuk informasi lebih lanjut tentang menambahkan opsi, lihat [Autentikasi dengan Amazon Location Service](access.md). Geofence dapat didefinisikan sebagai`Circle`,`Polygon`, atau. `MultiPolygon` Gunakan `Polygon` atau `MultiPolygon` untuk menentukan kapan perangkat memasuki area tertentu. Gunakan a `Circle` untuk menentukan kapan perangkat berada dalam jarak tertentu (radius) dari suatu titik. Untuk informasi selengkapnya, lihat [terminologi geofensi Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/geofence-components.html#geofence-terminology).
1. Anda dapat mulai mengevaluasi lokasi terhadap semua geofences Anda. Saat pembaruan lokasi melintasi batas satu atau beberapa geofences, sumber daya pengumpulan geofence Anda akan memancarkan salah satu jenis peristiwa geofence berikut di Amazon: EventBridge
+ **ENTER** - Satu acara dihasilkan untuk setiap geofence di mana pembaruan lokasi melintasi batasnya dengan memasukkannya.
+ **EXIT** - Satu peristiwa dihasilkan untuk setiap geofence di mana pembaruan lokasi melintasi batasnya dengan keluar dari itu.
Untuk informasi selengkapnya, lihat [Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge](location-events.md). Anda juga 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).
Misalnya, Anda melacak armada truk dan ingin diberi tahu ketika sebuah truk datang dalam area tertentu dari salah satu gudang Anda. Buat geofence untuk area di sekitar setiap gudang. Saat truk mengirimi Anda lokasi yang diperbarui, gunakan Amazon Location Service untuk mengevaluasi posisi tersebut dan lihat apakah truk telah memasuki (atau keluar) salah satu area geofence.
**catatan**
Anda ditagih oleh jumlah koleksi geofence yang Anda evaluasi. 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. Peristiwa yang dihasilkan akan mencakup ID geofence individu dalam koleksi, serta ID koleksi.
# Cara bekerja dengan Amazon Location Service Geofences
Bagian ini memberikan step-by-step panduan untuk bekerja dengan tugas terkait geofence di Lokasi Amazon. Pelajari cara mengevaluasi posisi perangkat terhadap geofences, merespons peristiwa geofence menggunakan Amazon EventBridge, dan mengelola sumber daya geofence Anda secara efektif. Tutorial ini dirancang untuk membantu Anda menerapkan fungsionalitas utama untuk melacak dan mengelola acara berbasis lokasi dengan mudah.
**Topics**
+ [Mengevaluasi posisi perangkat terhadap geofences](evaluate-geofences.md)
+ [Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge](location-events.md)
+ [Kelola sumber daya pengumpulan geofence Anda](managing-geofence-collections.md)
# Mengevaluasi posisi perangkat terhadap geofences
Ada dua cara untuk mengevaluasi posisi terhadap geofences untuk menghasilkan peristiwa geofence:
+ Anda dapat menautkan Pelacak dan Koleksi Geofence. Untuk informasi lebih lanjut, lihat bagian:[Tautkan pelacak ke koleksi geofence](associate-consumer.md).
+ Anda dapat membuat permintaan langsung ke sumber daya pengumpulan geofence untuk mengevaluasi satu atau lebih posisi.
Jika Anda juga ingin melacak riwayat lokasi perangkat atau menampilkan lokasi di peta, tautkan pelacak dengan koleksi geofence. Atau, Anda mungkin tidak ingin mengevaluasi semua pembaruan lokasi, atau Anda tidak bermaksud menyimpan data lokasi di sumber daya pelacak. Jika salah satu dari ini terjadi, Anda dapat membuat permintaan langsung ke koleksi geofence dan mengevaluasi satu atau lebih posisi perangkat terhadap geofences nya.
Mengevaluasi posisi perangkat terhadap geofences menghasilkan peristiwa. Anda dapat bereaksi terhadap peristiwa ini dan mengarahkannya ke AWS layanan lain. Untuk informasi selengkapnya tentang tindakan yang dapat Anda lakukan saat menerima peristiwa geofence, lihat [Bereaksi terhadap 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, termasuk metadata waktu, posisi, akurasi, dan nilai kunci, serta 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 menggunakan AWS CLI, atau Lokasi Amazon APIs.
------
#### [ API ]
**Untuk mengevaluasi posisi perangkat terhadap posisi geofences menggunakan Lokasi Amazon APIs**
Gunakan `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut menggunakan permintaan API untuk mengevaluasi posisi perangkat *ExampleDevice* ke koleksi geofence terkait. *ExampleGeofenceCollection* Ganti nilai-nilai ini dengan geofence dan perangkat Anda sendiri. IDs
```
POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json
{
"DevicePositionUpdates": [
{
"DeviceId": "ExampleDevice",
"Position": [-123.123, 47.123],
"SampleTime": "2021-11-30T21:47:25.149Z",
"Accuracy": {
"Horizontal": 10.30
},
"PositionProperties": {
"field1": "value1",
"field2": "value2"
}
}
]
}
```
------
#### [ AWS CLI ]
**Untuk mengevaluasi posisi perangkat terhadap posisi geofences menggunakan perintah AWS CLI **
Gunakan perintah `[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`.
Contoh berikut menggunakan AWS CLI untuk mengevaluasi posisi *ExampleDevice* terhadap koleksi geofence terkait. *ExampleGeofenceCollection* Ganti nilai-nilai ini dengan geofence dan perangkat Anda sendiri. IDs
```
aws location \
batch-evaluate-geofences \
--collection-name ExampleGeofenceCollection \
--device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```
------
# Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge
Amazon EventBridge adalah bus acara tanpa server yang secara efisien menghubungkan aplikasi bersama-sama menggunakan data dari AWS layanan seperti Amazon Location. EventBridge menerima peristiwa dari Lokasi Amazon dan merutekan data tersebut ke target seperti AWS Lambda. Anda dapat mengatur aturan perutean untuk menentukan ke mana harus mengirim data Anda untuk membangun arsitektur aplikasi yang bereaksi secara real time.
Hanya peristiwa geofence (`ENTER`dan `EXIT` peristiwa, saat perangkat memasuki atau meninggalkan area geofensi) yang dikirim secara default. EventBridge Anda juga dapat mengaktifkan semua peristiwa pembaruan posisi yang difilter untuk sumber daya pelacak. Untuk informasi selengkapnya, lihat [Aktifkan peristiwa pembaruan untuk pelacak](#enable-update-events).
Untuk informasi selengkapnya, lihat [Pola Peristiwa dan Peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan EventBridge Pengguna Amazon*.
**Topics**
+ [Aktifkan peristiwa pembaruan untuk pelacak](#enable-update-events)
+ [Membuat aturan acara untuk Lokasi Amazon](#create-event-rule)
+ [Contoh EventBridge acara Amazon untuk Amazon Location Service](#example-event)
## Aktifkan peristiwa pembaruan untuk pelacak
Secara default, Lokasi Amazon hanya mengirim `ENTER` dan peristiwa `EXIT` geofence ke. EventBridge Anda dapat mengaktifkan semua `UPDATE` peristiwa posisi yang difilter untuk pelacak yang akan dikirim EventBridge. Anda dapat melakukan ini ketika Anda [membuat](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) atau [memperbarui](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) pelacak.
Misalnya, untuk memperbarui pelacak yang ada menggunakan AWS CLI, Anda dapat menggunakan perintah berikut (gunakan nama sumber daya pelacak Anda sebagai pengganti). *MyTracker*
```
aws location update-tracker --tracker-name MyTracker --event-bridge-enabled
```
Untuk menonaktifkan peristiwa posisi untuk pelacak, Anda harus menggunakan API atau konsol Amazon Location Service.
## Membuat aturan acara untuk Lokasi Amazon
Anda dapat membuat [hingga 300 aturan per bus acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-quota.html) EventBridge untuk mengonfigurasi tindakan yang diambil sebagai respons terhadap peristiwa Lokasi Amazon.
Misalnya, Anda dapat membuat aturan untuk peristiwa geofence di mana pemberitahuan push akan dikirim saat ponsel terdeteksi dalam batas geografis.
**Untuk membuat aturan untuk acara Lokasi Amazon**
Dengan menggunakan nilai berikut, [buat EventBridge aturan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-visual.html) berdasarkan peristiwa Lokasi Amazon:
+ Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.
+ Dalam kotak **pola acara**, tambahkan pola berikut:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"]
}
```
Untuk membuat aturan untuk pembaruan posisi pelacak, Anda dapat menggunakan pola berikut:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Device Position Event"]
}
```
Anda dapat secara opsional menentukan hanya `ENTER` atau `EXIT` peristiwa dengan menambahkan `detail` tag (jika aturan Anda adalah untuk pembaruan posisi pelacak, hanya ada satu`EventType`, jadi tidak perlu memfilternya):
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"]
}
}
```
Anda juga dapat secara opsional memfilter properti posisi atau geofence:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"],
"GeofenceProperties": {
"Type": "LoadingDock"
},
"PositionProperties": {
"VehicleType": "Truck"
}
}
}
```
+ Untuk **target Pilih**, pilih tindakan target yang akan diambil saat peristiwa diterima dari Amazon Location Service.
Misalnya, Anda dapat menggunakan topik Amazon Simple Notification Service (SNS) untuk mengirim email atau pesan teks ketika peristiwa terjadi. Anda harus terlebih dahulu membuat topik Amazon SNS menggunakan konsol Amazon SNS. Untuk informasi selengkapnya, lihat [Menggunakan Amazon SNS untuk pemberitahuan pengguna](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html).
**Awas**
Praktik terbaik untuk mengonfirmasi bahwa aturan acara berhasil diterapkan atau tindakan otomatis Anda mungkin tidak dimulai seperti yang diharapkan. Untuk memverifikasi aturan acara Anda, mulai kondisi untuk aturan acara. Misalnya, simulasikan perangkat yang memasuki area geofenced.
Anda juga dapat menangkap semua acara dari Lokasi Amazon, hanya dengan mengecualikan `detail-type` bagian tersebut. Contoh:
```
{
"source": [
"aws.geo"
]
}
```
**catatan**
Acara yang sama dapat disampaikan lebih dari satu kali. Anda dapat menggunakan id acara untuk menghapus duplikat peristiwa yang Anda terima.
## Contoh EventBridge acara Amazon untuk Amazon Location Service
Berikut ini adalah contoh acara untuk memasukkan geofence yang diprakarsai dengan menelepon. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "636103698109",
"time": "2020-11-10T23:43:37Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "ENTER",
"GeofenceId": "polygon_14",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:43:37.531Z",
"Position": [
-123.12390073297821,
49.23433613216247
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Berikut ini adalah contoh acara untuk keluar dari geofence yang diprakarsai dengan menelepon. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "EXIT",
"GeofenceId": "polygon_10",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Berikut ini adalah contoh peristiwa untuk update posisi, dimulai dengan memanggil`BatchUpdateDevicePosition`.
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Device Position Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "UPDATE",
"TrackerName": "tracker_2",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"ReceivedTime": "2020-11-10T23:41:39.235Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
# Kelola sumber daya pengumpulan geofence Anda
Kelola koleksi geofence Anda menggunakan konsol Lokasi Amazon, Lokasi Amazon AWS CLI, atau Lokasi Amazon. APIs
## Buat daftar sumber daya koleksi geofence Anda
Anda dapat melihat daftar koleksi geofence menggunakan konsol Lokasi Amazon, lokasi Amazon AWS CLI, atau Lokasi Amazon: APIs
------
#### [ Console ]
**Untuk melihat daftar koleksi geofence 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 **koleksi Geofence** dari panel navigasi kiri.
1. Lihat daftar koleksi geofence Anda di bawah Koleksi geofence **saya**.
------
#### [ API ]
Gunakan `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut adalah permintaan API untuk mendapatkan daftar koleksi geofence di akun. AWS
```
POST /geofencing/v0/list-collections
```
Berikut ini adalah contoh respons untuk`ListGeofenceCollections`:
```
{
"Entries": [
{
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"UpdateTime": 2020-09-30T23:59:34.142Z
},
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Gunakan perintah `[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan daftar koleksi geofence di akun. AWS
```
aws location list-geofence-collections
```
------
## Dapatkan detail koleksi geofence
Anda bisa mendapatkan detail tentang sumber daya pengumpulan geofence apa pun di AWS akun Anda menggunakan konsol Lokasi Amazon, AWS CLI, atau Lokasi Amazon: APIs
------
#### [ Console ]
**Untuk melihat detail koleksi geofence 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 **koleksi Geofence** dari panel navigasi kiri.
1. Di bawah **Koleksi geofence saya**, pilih tautan nama koleksi geofence target.
------
#### [ API ]
Gunakan `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut adalah permintaan API untuk mendapatkan detail koleksi geofence. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection
```
Berikut ini adalah contoh respons untuk`DescribeGeofenceCollection`:
```
{
"CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
"CollectionName": "ExampleCollection",
"CreateTime": 2020-09-30T22:59:34.142Z,
"Description": "string",
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"Tags": {
"Tag1" : "Value1"
},
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
Gunakan perintah `[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan detail koleksi geofence untuk. *ExampleCollection*
```
aws location describe-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Hapus koleksi geofence
Anda dapat menghapus koleksi geofence dari AWS akun menggunakan konsol Lokasi Amazon, lokasi Amazon AWS CLI, atau Lokasi Amazon. APIs
------
#### [ Console ]
**Untuk menghapus koleksi geofence menggunakan konsol Lokasi Amazon**
**Awas**
Operasi ini menghapus sumber daya secara permanen.
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **koleksi Geofence** dari panel navigasi kiri.
1. Di bawah Koleksi **geofence saya, pilih koleksi** geofence target.
1. Pilih **Hapus koleksi geofence.**
------
#### [ API ]
Gunakan `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` operasi dari Lokasi Amazon APIs.
Contoh berikut adalah permintaan API untuk menghapus koleksi geofence. *ExampleCollection*
```
DELETE /geofencing/v0/collections/ExampleCollection
```
Berikut ini adalah contoh respons untuk`DeleteGeofenceCollection`:
```
HTTP/1.1 200
```
------
#### [ CLI ]
Gunakan perintah `[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)`.
Contoh berikut adalah AWS CLI perintah untuk menghapus koleksi geofence. *ExampleCollection*
```
aws location delete-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Daftar geofences yang disimpan
Anda dapat mencantumkan geofences yang disimpan dalam koleksi geofence tertentu menggunakan konsol Lokasi Amazon, AWS CLI atau Lokasi Amazon. APIs
------
#### [ Console ]
**Untuk melihat daftar geofences 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 **koleksi Geofence** dari panel navigasi kiri.
1. Di bawah **Koleksi geofence saya**, pilih tautan nama koleksi geofence target.
1. **Lihat geofences dalam koleksi geofence di bawah Geofences**
------
#### [ API ]
Gunakan `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut adalah permintaan API untuk mendapatkan daftar geofences yang disimpan dalam koleksi geofence. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/list-geofences
```
Berikut ini adalah contoh respons untuk`ListGeofences`:
```
{
"Entries": [
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "geofence-1",
"Geometry": {
"Polygon": [
[-5.716667, -15.933333,
[-14.416667, -7.933333],
[-12.316667, -37.066667],
[-5.716667, -15.933333]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
],
"NextToken": "1234-5678-9012"
}
```
------
#### [ CLI ]
Gunakan perintah `[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan daftar geofences yang disimpan dalam koleksi geofence. *ExampleCollection*
```
aws location list-geofences \
--collection-name "ExampleCollection"
```
------
## Dapatkan detail geofence
Anda bisa mendapatkan detail geofence tertentu, seperti waktu pembuatan, waktu pembaruan, geometri, dan status, dari koleksi geofence menggunakan konsol Lokasi Amazon, AWS CLI atau Lokasi Amazon. APIs
------
#### [ Console ]
**Untuk melihat status geofence 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 **koleksi Geofence** dari panel navigasi kiri.
1. Di bawah **Koleksi geofence saya**, pilih tautan nama koleksi geofence target.
1. Di bawah **Geofences**, Anda akan dapat melihat status geofences Anda.
------
#### [ API ]
Gunakan `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut adalah permintaan API untuk mendapatkan detail geofence dari koleksi geofence. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1
```
Berikut ini adalah contoh respons untuk`GetGeofence`:
```
{
"CreateTime": 2020-09-30T22:59:34.142Z,
"GeofenceId": "ExampleGeofence1",
"Geometry": {
"Polygon": [
[-1,-1],
[1,-1],
[0,1],
[-1,-1]
]
},
"Status": "ACTIVE",
"UpdateTime": 2020-09-30T23:59:34.142Z
}
```
------
#### [ CLI ]
Gunakan perintah `[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)`.
Contoh berikut adalah AWS CLI untuk mendapatkan detail koleksi geofence untuk. *ExampleCollection*
```
aws location get-geofence \
--collection-name "ExampleCollection" \
--geofence-id "ExampleGeofence1"
```
------
## Hapus geofences
Anda dapat menghapus geofences dari koleksi geofence menggunakan konsol Lokasi Amazon, lokasi, AWS CLI atau Amazon Location. APIs
------
#### [ Console ]
**Untuk menghapus geofence menggunakan konsol Lokasi Amazon**
**Awas**
Operasi ini menghapus sumber daya secara permanen.
1. Buka konsol Lokasi Amazon di [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Pilih **koleksi Geofence** dari panel navigasi kiri.
1. Di bawah **Koleksi geofence saya**, pilih tautan nama koleksi geofence target.
1. Di bawah **Geofences**, pilih geofence target.
1. Pilih **Hapus geofence**.
------
#### [ API ]
Gunakan `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` operasi dari Amazon Location Geofences APIs.
Contoh berikut adalah permintaan API untuk menghapus geofences dari koleksi geofence. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json
{
"GeofenceIds": [ "ExampleGeofence11" ]
}
```
Berikut ini adalah contoh respon sukses untuk`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`.
```
HTTP/1.1 200
```
------
#### [ CLI ]
Gunakan perintah `[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)`.
Contoh berikut adalah AWS CLI perintah untuk menghapus geofences dari koleksi geofence. *ExampleCollection*
```
aws location batch-delete-geofence \
--collection-name "ExampleCollection" \
--geofence-ids "ExampleGeofence11"
```
------
# Mengelola biaya dan penggunaan
Saat Anda terus belajar tentang Amazon Location Geofences, 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 Geofences](geofence-price.md)
+ [Kuota dan penggunaan geofences](geofence-quotas.md)
# Harga Geofences
Untuk informasi harga untuk tracking dan geofencing APIs, lihat halaman [harga Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Evaluasi Posisi**
Anda dapat menggunakan `BatchEvaluateGeofences` untuk mengevaluasi posisi perangkat terhadap geometri geofence dari koleksi geofence tertentu. Satu permintaan akan mengevaluasi hingga sepuluh posisi perangkat terhadap semua geofences dalam satu koleksi geofence. Harga didasarkan pada jumlah posisi perangkat dalam permintaan API Anda. Harga satuan per posisi perangkat yang dievaluasi 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 Evaluasi Posisi dengan mengonfigurasi frekuensi pembaruan posisi perangkat (juga dikenal sebagai ping rate) dari perangkat pelacak, dan memanfaatkan fitur pemfilteran pada Pelacak untuk hanya mengevaluasi pembaruan posisi yang relevan.
**Manajemen dan Penyimpanan Geofence**
Anda dapat menggunakan`GetGeofence`,, `PutGeofence``BatchPutGeofence`, dan `BatchDeleteGeofence` untuk mengelola geofences Anda dalam koleksi geofence. Harga untuk ini APIs didasarkan pada jumlah geofences dalam permintaan API Anda.
Penyimpanan untuk geofences akan dikenakan biaya bulanan (hanya untuk geofences yang Anda simpan selama lebih dari satu bulan). Anda juga dapat mengelola Koleksi Geofence Anda menggunakan yang berikut APIs:`CreateGeofenceCollection`,,,`DeleteGeofenceCollection`, `DescribeGeofenceCollection` `ListGeofenceCollections``UpdateGeofenceCollection`, dan. `ListGeofences` Harga untuk ini APIs didasarkan pada jumlah permintaan API.
**Forecast Event Geofence**
Anda dapat menggunakan `ForecastGeofenceEvents` untuk meramalkan peristiwa geofence masa depan yang mungkin terjadi dalam cakrawala waktu tertentu jika perangkat terus bergerak dengan kecepatan saat ini. Harga didasarkan pada jumlah permintaan API.
# Kuota dan penggunaan geofences
Topik ini memberikan ringkasan batas tarif dan kuota untuk Amazon Location Service Geofences.
**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 pengumpulan per akun | 1500 | 3000 Jika Anda membutuhkan lebih dari ini, [minta kenaikan kuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) atau hubungi tim dukungan. |
| Geofences per koleksi | 50000 | 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 |
| --- | --- | --- |
| [CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html) | 10 | 20 |
| [DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html) | 10 | 20 |
| [DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html) | 10 | 20 |
| [ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html) | 10 | 20 |
| [UpdateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_UpdateGeofenceCollection.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 |
| --- | --- | --- |
| [BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html) | 50 | 100 |
| [PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html) | 50 | 100 |
| [BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html) | 50 | 100 |
| [ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html) | 50 | 100 |
| [GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html) | 50 | 100 |
| [BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html) | 50 | 100 |
## Batas penggunaan lainnya