Membuat himpunan status fitur

Himpunan status fitur menentukan properti dan nilai dinamis pada fitur tertentu yang mendukungnya. Artikel ini menjelaskan cara membuat stateset yang menentukan nilai dan gaya terkait untuk properti dan mengubah status properti.

Prasyarat

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.
  • Dalam contoh URL dalam artikel ini, Anda harus mengganti:
    • {Azure-Maps-Subscription-key}dengan kunci langganan Azure Peta 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:

Buat Permintaan HTTP POST baru yang menggunakan STATESET API. Permintaan harus terlihat seperti URL berikut:

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

Selanjutnya, atur ke Content-Typeapplication/json di Header permintaan.

Jika menggunakan alat seperti Postman, akan terlihat seperti ini:

A screenshot of Postman showing the Header tab of the POST request that shows the Content Type Key with a value of application forward slash json.

Terakhir, dalam Isi permintaan HTTP, sertakan informasi gaya dalam format JSON mentah, yang menerapkan warna yang berbeda ke occupied properti tergantung pada nilainya:

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

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". Jika menggunakan Postman, maka akan muncul sebagai berikut:

A screenshot of Postman showing the resource Stateset ID value in the responses body.

Memperbarui status fitur

Bagian ini menunjukkan cara memperbarui occupied status unit dengan fitur id "UNIT26". Untuk memperbarui occupied status, buat Permintaan HTTP PUT baru yang memanggil API Statesets Fitur. Permintaan akan terlihat seperti URL berikut (ganti {statesetId} dengan yang statesetId diperoleh di Membuat stateset fitur):

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

Selanjutnya, atur ke Content-Typeapplication/json di Header permintaan.

Jika menggunakan alat seperti Postman, akan terlihat seperti ini:

A screenshot of the header tab information for stateset creation.

Terakhir, dalam Isi permintaan HTTP, sertakan informasi gaya dalam format JSON mentah, yang menerapkan warna yang berbeda ke occupied properti tergantung pada nilainya:

{
    "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.

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

Informasi tambahan

Langkah berikutnya

Pelajari cara menerapkan gaya dinamis untuk peta dalam ruangan.