Tutorial: Membuat fitur set status

  • Artikel
  • 2 menit untuk membaca

Himpunan status fitur menentukan properti dan nilai dinamis pada fitur tertentu yang mendukungnya. Dalam Tutorial ini, Anda akan:

  • Membuat set status yang mendefinisikan nilai boolean dan gaya yang sesuai untuk properti occupancy.
  • Ubah status properti occupancy dari unit yang diinginkan.

Prasyarat

Tutorial ini menggunakan aplikasi Postman, tetapi Anda dapat menggunakan lingkungan pengembangan API berbeda.

Penting

  • Artikel ini menggunakan URL geografis us.atlas.microsoft.com. Jika layanan Pembuat tidak dibuat di Amerika Serikat, Anda harus menggunakan URL geografis yang berbeda. Untuk informasi selengkapnya, lihat Mengakses ke Layanan Pembuat.
  • Pada contoh URL dalam artikel ini, Anda harus mengganti:
    • {Azure-Maps-Primary-Subscription-key} dengan kunci langganan utama Anda.
    • {datasetId} dengan datasetId yang diperoleh di bagian Periksa status pembuatan himpunan data dari tutorial Menggunakan Pembuat untuk membuat peta dalam ruangan

Membuat himpunan status fitur

Untuk membuat himpunan status:

  1. Di aplikasi Postman, buat Permintaan HTTP baru dan simpan sebagai POST Create Stateset.

  2. Pilih metode HTTP POST.

  3. Masukkan URL berikut ke API Himpunan Status. Permintaan akan terlihat seperti URL berikut:

    https://us.atlas.microsoft.com/featurestatesets?api-version=2.0&datasetId={datasetId}&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  4. Pilih tab Header.

  5. Di bidang KEY, pilih Content-Type.

  6. Di bidang VALUE, pilih application/json.

    Cuplikan layar Postman yang menampilkan tab Header permintaan POST yang menampilkan Kunci Jenis Konten dengan nilai json garis miring aplikasi.

  7. Pilih tab Isi.

  8. Pilih mentah dan JSON.

  9. Salin gaya JSON berikut, lalu tempel di jendela Isi:

    {
   "styles":[
      {
         "keyname":"occupied",
         "type":"boolean",
         "rules":[
            {
               "true":"#FF0000",
               "false":"#00FF00"
            }
         ]
      }
   ]
}

  10. Pilih Kirim.

  11. Setelah tanggapan berhasil kembali, salin statesetId dari isi tanggapan. Di bagian berikutnya, Anda akan menggunakan statesetId untuk mengubah status properti occupancy unit dengan fitur id "UNIT26".

    Cuplikan layar Postman yang menampilkan nilai ID Himpunan Status sumber daya dalam badan respons.

Memperbarui status fitur

Untuk memperbarui status occupied unit dengan fitur id "UNIT26":

  1. Di aplikasi Postman, buat Permintaan HTTP baru dan simpan sebagai PUT Set Stateset.

  2. Pilih metode HTTP PUT.

  3. Masukkan URL berikut ke API Himpunan Status Fitur. Permintaan tersebut akan terlihat seperti URL berikut (ganti {statesetId} dengan statesetId yang diperoleh di Buat himpunan status fitur):

    https://us.atlas.microsoft.com/featurestatesets/{statesetId}/featureStates/UNIT26?api-version=2.0&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  4. Pilih tab Header.

  5. Di bidang KEY, pilih Content-Type.

  6. Di bidang VALUE, pilih application/json.

    Informasi tab header untuk pembuatan stateset.

  7. Pilih tab Isi.

  8. Pilih mentah dan JSON.

  9. Salin gaya JSON berikut, lalu tempel di jendela Isi:

    {
    "states": [
        {
            "keyName": "occupied",
            "value": true,
            "eventTimestamp": "2020-11-14T17:10:20"
        }
    ]
}

    Catatan

    Pembaruan hanya akan disimpan jika tanda waktu yang diposting adalah setelah tanda waktu dari permintaan sebelumnya.

  10. Pilih Kirim.

  11. Setelah pembaruan selesai, Anda akan menerima kode status HTTP 200 OK. Jika Anda mengimplementasikan gaya dinamis untuk peta dalam ruangan, pembaruan akan ditampilkan di tanda waktu yang ditentukan di peta yang dirender.

Informasi Tambahan