View a markdown version of this page

Tambahkan geofences dengan Lokasi Amazon - Amazon Location Service
Membuat kumpulan pagar virtualGambar geofencesTambahkan geofences poligonTambahkan geofences melingkar

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

Tambahkan geofences dengan Lokasi Amazon

Geofences berisi titik dan simpul yang membentuk batas tertutup, yang mendefinisikan area yang menarik. Koleksi Geofence menyimpan dan mengelola satu atau beberapa geofences.

Koleksi geofence Lokasi Amazon menyimpan geofences yang ditentukan dengan menggunakan format data geospasial standar yang disebut GeoJSON (RFC 7946). Anda dapat menggunakan alat, seperti geojson.io, tanpa biaya untuk menggambar geofences Anda secara grafis dan menyimpan file GeoJSON output.

catatan

Lokasi Amazon tidak mendukung poligon searah jarum jam (gunakan urutan belitan berlawanan arah jarum jam seperti yang dipersyaratkan oleh RFC 7946 §3.1.6) dan geofences yang melintasi antimeridian (garis bujur 180°).

Membuat kumpulan pagar virtual

Buat koleksi geofence untuk menyimpan dan mengelola geofences menggunakan konsol Lokasi Amazon, API Lokasi Amazon, AWS CLI atau Amazon Location.

Console
Untuk membuat koleksi geofence menggunakan konsol Lokasi Amazon

  1. Buka konsol Amazon Location Service di https://console.aws.amazon.com/location/.

  2. Di panel navigasi kiri, pilih koleksi Geofence.

  3. Pilih Buat koleksi geofence.

  4. Isi kotak-kotak berikut:

    • Nama — Masukkan nama unik. Misalnya, ExampleGeofenceCollection. Maksimum 100 karakter. Entri yang valid termasuk karakter alfanumerik, tanda hubung, titik, dan garis bawah.

    • Deskripsi — Masukkan deskripsi opsional untuk membedakan sumber daya Anda.

  5. Di bawah EventBridge aturan dengan CloudWatch sebagai target, Anda dapat membuat EventBridge aturan opsional untuk mulai bereaksi terhadap peristiwa geofence. Ini memungkinkan Lokasi Amazon untuk mempublikasikan peristiwa ke Amazon CloudWatch Logs.

  6. (Opsional) Di bawah Tag, masukkan tag Kunci dan Nilai. Ini menambahkan tag ke koleksi geofence baru Anda. Untuk informasi selengkapnya, lihat Mengelola sumber daya dengan Tag.

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

  8. Pilih Buat koleksi geofence.

API
Untuk membuat koleksi geofence menggunakan Amazon Location API

Gunakan CreateGeofenceCollection operasi dari Amazon Location Geofences API.

Contoh berikut menggunakan permintaan API untuk membuat koleksi geofence yang disebut. ExampleGeofenceCollection Pengumpulan geofence dikaitkan dengan AWS KMS kunci yang dikelola pelanggan untuk mengenkripsi data pelanggan.

POST /geofencing/v0/collections
Content-type: application/json

{
   "CollectionName": "ExampleGeofenceCollection",
   "Description": "Geofence collection 1 for shopping center",
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "Tags": {
      "Tag1" : "Value1"
   }
}
AWS CLI
Untuk membuat koleksi geofence menggunakan perintah AWS CLI

Gunakan perintah create-geofence-collection.

Contoh berikut menggunakan AWS CLI untuk membuat koleksi geofence disebut. ExampleGeofenceCollection Pengumpulan geofence dikaitkan dengan AWS KMS kunci yang dikelola pelanggan untuk mengenkripsi data pelanggan.

aws location \
  create-geofence-collection \
  --collection-name "ExampleGeofenceCollection" \
  --description "Shopping center geofence collection" \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
  --tags Tag1=Value1
catatan

Penagihan tergantung pada penggunaan Anda. Anda mungkin dikenakan biaya untuk penggunaan AWS layanan lain. Untuk informasi selengkapnya, lihat harga Amazon Location Service.

Gambar geofences

Sekarang setelah Anda membuat koleksi geofence Anda, Anda dapat menentukan geofences Anda. Geofences didefinisikan sebagai poligon atau sebagai lingkaran. Untuk menggambar geofence poligon Anda dapat menggunakan alat pengeditan GeoJSON, seperti geojson.io.

Untuk membuat geofensi melingkar, tentukan titik pusat menggunakan garis lintang dan bujur lokasi dan atur radius dalam meter. Untuk informasi selengkapnya, lihat Tambahkan geofences melingkar.

Menggunakan Amazon Location Service API, Anda juga dapat menambahkan metadata ke geofence Anda dalam bentuk pasangan nilai kunci. Ini dapat berguna untuk menyimpan informasi tentang geofence, seperti jenisnya, atau informasi lain yang spesifik untuk aplikasi Anda. Anda dapat menggunakan metadata ini kapan. Bereaksi terhadap peristiwa Amazon Location Service dengan Amazon EventBridge

Tambahkan geofences poligon

Geofences poligon menggunakan array koordinat GeoJSON untuk menentukan suatu area. Gunakan format ini saat Anda perlu melacak entri ke atau keluar dari batas geografis yang tidak beraturan.

Gambar geofences menggunakan alat GeoJSON

Untuk membuat file GeoJSON

  1. Buka alat pengeditan GeoJSON, seperti geojson.io.

  2. Pilih ikon Draw a polygon dan gambar area minat Anda.

  3. Pilih Simpan, lalu pilih GeoJSON dari menu tarik-turun.

Letakkan geofences GeoJSON dalam koleksi geofence

Anda dapat menggunakan file GeoJSON yang dihasilkan untuk mengunggah geofences menggunakan konsol Amazon Location Service, AWS CLI the, atau Amazon Location API.

Console
Untuk menambahkan geofence ke koleksi geofence menggunakan konsol Amazon Location Service

  1. Buka konsol Amazon Location Service di https://console.aws.amazon.com/location/.

  2. Di panel navigasi kiri, pilih koleksi Geofence.

  3. Dari daftar koleksi Geofence, pilih tautan nama untuk koleksi geofence target.

  4. Di bawah Geofences, pilih Buat geofences.

  5. Di jendela Add geofences, seret dan lepas GeoJSON Anda ke jendela.

  6. Pilih Tambahkan geofences.

API
Untuk menambahkan geofences menggunakan Amazon Location API

Gunakan PutGeofence operasi dari Amazon Location Geofences API.

Contoh berikut menggunakan permintaan API untuk menambahkan geofence dengan ID GEOFENCE-EXAMPLE1 ke koleksi geofence yang disebut. ExampleGeofenceCollection Ini juga menentukan properti metadata geofence dengan kunci dan nilai. Type loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/GEOFENCE-EXAMPLE1
Content-type: application/json

{
   "GeofenceProperties": {
      "Type" : "loadingArea"
   },
   "Geometry": {
      "Polygon": [
        [
            [-5.716667, -15.933333],
            [-14.416667, -7.933333],
            [-12.316667, -37.066667],
            [-5.716667, -15.933333]
        ]
      ]
   }
}

Atau, Anda dapat menambahkan lebih dari satu geofence menggunakan operasi. BatchPutGeofence

POST /geofencing/v0/collections/ExampleGeofenceCollection/put-geofences
Content-type: application/json

{
   "Entries": [
      {
         "GeofenceProperties": {
            "Type" : "loadingArea"
         },
         "GeofenceId": "GEOFENCE-EXAMPLE1",
         "Geometry": {
            "Polygon": [
               [
                  [-5.716667, -15.933333],
                  [-14.416667, -7.933333],
                  [-12.316667, -37.066667],
                  [-5.716667, -15.933333]
               ]
            ]
         }
      }
   ]
}
AWS CLI
Untuk menambahkan geofence ke koleksi geofence menggunakan perintah AWS CLI

Gunakan perintah put-geofence.

Contoh berikut menggunakan AWS CLI untuk menambahkan geofence ke koleksi geofence yang disebut. ExampleGeofenceCollection

aws location \
    put-geofence \
        --collection-name ExampleGeofenceCollection \
        --geofence-id ExampleGeofenceTriangle \
        --geofence-properties '{"Type": "loadingArea"}' \
        --geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'

Tambahkan geofences melingkar

Untuk membuat geofence melingkar, Anda harus mengetahui garis lintang dan bujur titik pusat dan radius dalam meter. Gunakan geofences melingkar saat Anda perlu memicu peristiwa berdasarkan kedekatan dengan titik tertentu, seperti toko, gudang, atau tengara. Anda dapat membuat geofences melingkar dengan konsol Lokasi Amazon, API Lokasi Amazon, atau. AWS CLI

Console
Untuk menambahkan geofence melingkar ke koleksi geofence menggunakan konsol Amazon Location Service

  1. Buka konsol Amazon Location Service di https://console.aws.amazon.com/location/.

  2. Di panel navigasi kiri, pilih koleksi Geofence.

  3. Dari daftar koleksi Geofence, pilih tautan nama untuk koleksi geofence target.

  4. Di bawah Geofences, pilih Buat geofences.

  5. Di jendela Add geofences, pilih Circle, lalu masukkan pusat Latitude, Longitude, dan Radius dalam meter.

  6. Pilih Tambahkan geofences.

API
Untuk menambahkan geofences melingkar menggunakan Amazon Location API

Gunakan PutGeofence operasi dari Amazon Location Geofences API.

Contoh berikut menggunakan permintaan API untuk menambahkan geofence dengan ID GEOFENCE-EXAMPLE2 ke koleksi geofence yang disebut. ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/GEOFENCE-EXAMPLE2
Content-type: application/json

{
   "Geometry": {
      "Circle": {
        "Center": [-5.716667, -15.933333],
        "Radius": 50
      }
   }
}
AWS CLI
Untuk menambahkan geofence melingkar ke koleksi geofence menggunakan perintah AWS CLI

Gunakan perintah put-geofence.

Contoh berikut menggunakan AWS CLI untuk menambahkan geofence melingkar ke koleksi geofence yang disebut. ExampleGeofenceCollection

aws location \
    put-geofence \
        --collection-name ExampleGeofenceCollection \
        --geofence-id ExampleGeofenceCircle \
        --geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
catatan

Anda juga dapat menempatkan JSON untuk geometri kompleks ke dalam file sendiri, seperti pada contoh berikut.

aws location \
    put-geofence \
        --collection-name ExampleGeofenceCollection \
        --geofence-id ExampleGeofenceCircle \
        --geometry file://circle.json

Dimana circle.json berisi geometri lingkaran.

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}