Tambahkan geofences - Amazon Location Service
Buat koleksi geofenceMenggambar geofencesMenambahkan geofences poligonMenambahkan geofences melingkar

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

Tambahkan geofences

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 dengan lubang, multipoligon, poligon searah jarum jam, dan geofences yang melintasi antimeridian.

Buat koleksi geofence

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. Maksimal 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 koleksi geofence baru Anda. Untuk informasi selengkapnya, lihat Menandai sumber daya Amazon Location Service.

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

Menggambar geofences

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

Untuk membuat geofence sebagai lingkaran, Anda harus menentukan titik tengah lingkaran, dan jari-jarinya. Misalnya, jika Anda ingin membuat geofence untuk diberi tahu setiap kali perangkat berada dalam jarak 50 meter dari lokasi tertentu, Anda akan menggunakan garis lintang dan bujur lokasi itu dan menentukan radius sebagai 50 meter.

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

Menambahkan geofences poligon

Bagian ini menjelaskan pembuatan geofences poligon

Menggambar geofences menggunakan alat GeoJSON

Sekarang setelah Anda membuat koleksi geofence, Anda dapat menentukan geofences Anda dengan menggunakan alat pengeditan GeoJSON, seperti geojson.io.

Untuk membuat file GeoJSON

  1. Buka alat pengeditan GeoJSON. Misalnya, 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 AWS CLI Amazon Location Service,, 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 jatuhkan 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 yang diberikan ID GEOFENCE-EXAMPLE1 ke koleksi geofence yang disebut. ExampleGeofenceCollection Ini juga menentukan properti metadata geofence tunggal dengan kunci dan nilai. Type loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/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]]]'
    {
        "CreateTime": "2020-11-11T00:16:14.487000+00:00",
        "GeofenceId": "ExampleGeofenceTriangle",
        "UpdateTime": "2020-11-11T00:19:59.894000+00:00"
    }

Menambahkan geofences melingkar

Bagian ini menjelaskan pembuatan geofences melingkar. Anda harus mengetahui garis lintang dan bujur titik yang Anda inginkan menjadi pusat lingkaran, dan jari-jari dalam meter lingkaran. Anda dapat membuat geofences melingkar dengan Amazon Location API atau. AWS CLI

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 yang diberikan ID GEOFENCE-EXAMPLE2 ke koleksi geofence yang disebut: ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/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 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

Dalam contoh, file circle.json menyertakan JSON untuk geometri lingkaran.

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