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.

• Anda dapat membuat permintaan langsung ke sumber daya pengumpulan geofence untuk mengevaluasi satu atau lebih posisi, menggunakan. BatchEvaluateGeofencesAPI

Selain itu, Anda dapat memperkirakan peristiwa geofence yang masuk untuk perangkat yang masuk, keluar, atau tetap menganggur dalam geofence. Gunakan ForecastGeofenceEventsAPIuntuk meramalkan peristiwa.

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 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

Contoh berikut menggunakan AWS CLI, atau Lokasi AmazonAPIs.

API

Untuk mengevaluasi posisi perangkat terhadap posisi geofences menggunakan Lokasi Amazon APIs

Gunakan BatchEvaluateGeofences operasi dari Amazon Location GeofencesAPIs.

Contoh berikut menggunakan API permintaan 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.

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"}}]'

Mengevaluasi posisi perangkat terhadap geofences menghasilkan peristiwa. Secara tradisional Anda dapat bereaksi terhadap peristiwa dengan menggunakan Amazon EventBridge, tetapi proses ini hanya memungkinkan Anda bereaksi terhadap peristiwa setelah itu terjadi. Jika Anda perlu mengantisipasi kapan perangkat masuk atau keluar dari geofence, misalnya jika perangkat melintasi perbatasan dan akan tunduk pada peraturan yang berbeda sebagai konsekuensinya, maka Anda dapat menggunakan untuk ForecastGeofenceEventsAPImemprediksi peristiwa geofence masa depan.

ForecastGeofenceEventsAPIMenggunakan kriteria seperti perangkat time-to-breach, kedekatan, kecepatan, dan posisi untuk memprediksi peristiwa. APIAkan ada pengembalian a ForecastedBreachTime, yang menandakan perkiraan waktu peristiwa geofence akan terjadi.

Contoh berikut menggunakan Lokasi AmazonAPIs.

API

Untuk memperkirakan peristiwa geofence menggunakan Lokasi Amazon APIs

Gunakan ForecastGeofenceEvents operasi dari Amazon Location GeofencesAPIs.

Contoh berikut menggunakan API permintaan untuk memperkirakan peristiwa geofence untuk ExampleDevice relatif terhadap sebuah ExampleGeofence. Ganti nilai-nilai ini dengan geofence dan perangkat Anda sendiri. IDs

POST /geofencing/v0/collections/CollectionName/forecast-geofence-events HTTP/1.1
Content-type: application/json

{
   "DeviceState": { 
      "Position": [ number ],
      "Speed": number
   },
   "DistanceUnit": "string",
   "MaxResults": number,
   "NextToken": "string",
   "SpeedUnit": "string",
   "TimeHorizonMinutes": number
}