Panduan referensi StylesObject Schema untuk Maps yang dinamis

Artikel
01/04/2024

StylesObject adalah array StyleObject yang mewakili gaya stateset. Gunakan layanan Status Fitur Azure Maps Creator untuk menerapkan gaya stateset Anda ke fitur data peta dalam ruangan. Setelah Anda membuat gaya stateset dan mengaitkannya dengan fitur peta dalam ruangan, Anda dapat menggunakannya untuk membuat peta dalam ruangan yang dinamis. Untuk informasi selengkapnya tentang membuat peta dalam ruangan yang dinamis, lihat Menerapkan gaya dinamis untuk peta dalam ruangan Pembuat.

StyleObject

StyleObject adalah salah satu aturan gaya berikut:

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

JSON berikut menunjukkan contoh penggunaan masing-masing dari tiga jenis gaya. BooleanTypeStyleRule digunakan untuk menentukan gaya dinamis untuk fitur yang properti occupied-nya true dan false. NumericTypeStyleRule digunakan untuk menentukan gaya untuk fitur yang properti temperature-nya berada dalam kisaran tertentu. Akhirnya, StringTypeStyleRule digunakan untuk mencocokkan gaya tertentu dengan meetingType.

 "styles": [
     {
        "keyname": "occupied",
        "type": "boolean",
        "rules": [
            {
                "true": "#FF0000",
                "false": "#00FF00"
            }
        ]
    },
    {
        "keyname": "temperature",
        "type": "number",
        "rules": [
             {
                "range": {
                "minimum": 50,
                "exclusiveMaximum": 70
                },
                "color": "#343deb"
            },
            {
                "range": {
                "maximum": 70,
                "exclusiveMinimum": 30
              },
              "color": "#eba834"
            }
        ]
    },
    {
      "keyname": "meetingType",
      "type": "string",
      "rules": [
        {
          "private": "#FF0000",
          "confidential": "#FF00AA",
          "allHands": "#00FF00",
          "brownBag": "#964B00"
        }
      ]
    }
]

NumerikTypeStyleRule

NumericTypeStyleRule adalah StyleObject dan terdiri dari properti berikut:

Properti	Tipe	Deskripsi	Wajib diisi
`keyName`	string	Nama properti status atau dinamis. `keyName` harus unik di dalam array `StyleObject`.	Ya
`type`	string	Nilainya adalah `numeric`.	Ya
`rules`	`NumberRuleObject`	Array rentang gaya numerik dengan warna terkait. Setiap rentang menentukan warna yang akan digunakan saat nilai status memenuhi rentang.	Ya

NumberRuleObject

NumberRuleObject terdiri dari RangeObject dan properti color. Jika nilai status termasuk dalam rentang, warnanya untuk tampilan adalah warna yang ditentukan dalam color properti .

Jika Anda menentukan beberapa rentang yang tumpang tindih, warna yang dipilih akan menjadi warna yang ditentukan dalam rentang pertama yang terpenuhi.

Dalam sampel JSON berikut, kedua rentang menyimpan true saat nilai status antara 50-60. Namun, warna yang digunakan adalah karena ini adalah #343deb rentang pertama dalam daftar yang telah terpenuhi.


    {
        "rules":[
            {
                "range": {
                "minimum": 50,
                "exclusiveMaximum": 70
                },
                "color": "#343deb"
            },
            {
                "range": {
                "minimum": 50,
                "maximum": 60
                },
                "color": "#eba834"
            }
        ]
    }
]

Properti	Tipe	Deskripsi	Wajib diisi
`range`	RangeObject	RangeObject menentukan sekumpulan kondisi rentang logika, yang, jika `true`, mengubah warna tampilan status menjadi warna yang ditentukan dalam properti `color`. Jika `range` tidak ditentukan, maka warna yang ditentukan dalam `color` properti selalu digunakan.	No
`color`	string	Warna yang digunakan saat nilai status masuk ke dalam rentang. Properti `color` adalah string JSON dalam salah satu format berikut: Nilai heksa gaya HTML RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL("hsl(100, 50%, 50%)") HSLA("hsla(100, 50%, 50%, 1)") Nama warna HTML yang sudah ditentukan sebelumnya, seperti kuning, dan biru.	Ya

RangeObject

RangeObject Menentukan nilai rentang numerik dari NumberRuleObject. Agar nilai status masuk ke dalam rentang, semua kondisi yang ditentukan harus berlaku.

Properti	Tipe	Deskripsi	Wajib diisi
`minimum`	ganda	Semua angka x yang x ≥ `minimum`.	No
`maximum`	ganda	Semua angka x yang x `maximum` ≥.	No
`exclusiveMinimum`	ganda	Semua bilangan x itu x >`exclusiveMinimum`.	No
`exclusiveMaximum`	ganda	Semua bilangan x itu x <`exclusiveMaximum`.	No

Contoh NumericTypeStyleRule

JSON berikut menggambarkan NumericTypeStyleRulestatus bernama temperature. Dalam contoh ini, NumberRuleObject berisi dua rentang suhu yang ditentukan dan gaya warna terkait. Jika rentang suhu adalah 50-69, layar harus menggunakan warna #343deb. Jika rentang suhu adalah 31-70, layar harus menggunakan warna #eba834.

{
    "keyname": "temperature",
    "type": "number",
    "rules":[
        {
            "range": {
            "minimum": 50,
            "exclusiveMaximum": 70
            },
            "color": "#343deb"
        },
        {
            "range": {
            "maximum": 70,
            "exclusiveMinimum": 30
            },
            "color": "#eba834"
        }
    ]
}

StringTypeStyleRule

StringTypeStyleRule adalah StyleObject dan terdiri dari properti berikut:

Properti	Tipe	Deskripsi	Wajib diisi
`keyName`	string	Nama properti status atau dinamis. `keyName` harus unik di dalam array `StyleObject`.	Ya
`type`	string	Nilainya adalah `string`.	Ya
`rules`	`StringRuleObject`	Array N jumlah nilai status.	Ya

StringRuleObject

StringRuleObject terdiri dari hingga N jumlah nilai status yang merupakan nilai string yang mungkin dari properti fitur. Jika nilai properti fitur tidak cocok dengan nilai status yang ditentukan, fitur tersebut tidak akan memiliki gaya dinamis. Jika nilai status duplikat diberikan, yang pertama lebih diutamakan.

Pencocokan nilai string peka huruf besar/kecil.

Properti	Tipe	Deskripsi	Wajib diisi
`stateValue1`	string	Warna saat string nilai adalah stateValue1.	No
`stateValue2`	string	Warna saat string nilai adalah stateValue.	No
`stateValueN`	string	Warna saat string nilai adalah stateValueN.	No

Contoh StringTypeStyleRule

JSON berikut ini menggambarkan StringTypeStyleRule yang menentukan gaya yang terkait dengan jenis rapat tertentu.

    {
      "keyname": "meetingType",
      "type": "string",
      "rules": [
        {
          "private": "#FF0000",
          "confidential": "#FF00AA",
          "allHands": "#00FF00",
          "brownBag": "#964B00"
        }
      ]
    }

BooleanTypeStyleRule

BooleanTypeStyleRule adalah StyleObject dan terdiri dari properti berikut:

Properti	Tipe	Deskripsi	Wajib diisi
`keyName`	string	Nama properti status atau dinamis. `keyName` harus unik di dalam array `StyleObject`.	Ya
`type`	string	Nilainya adalah `boolean`.	Ya
`rules`	`BooleanRuleObject`	Pasangan boolean dengan warna untuk nilai `true` dan `false`status.	Ya

BooleanRuleObject

BooleanRuleObject menentukan warna untuk true dan nilai false.

Properti	Tipe	Deskripsi	Wajib diisi
`true`	string	Warna yang digunakan saat nilai status adalah `true`. Properti `color` adalah string JSON dalam salah satu format berikut: Nilai heksa gaya HTML RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)") RGBA ("rgba(255, 255, 0, 1)") HSL("hsl(100, 50%, 50%)") HSLA("hsla(100, 50%, 50%, 1)") Nama warna HTML yang sudah ditentukan sebelumnya, seperti kuning, dan biru.	Ya
`false`	string	Warna yang digunakan saat nilai status adalah `false`.	Ya

Contoh BooleanTypeStyleRule

JSON berikut menggambarkan BooleanTypeStyleRulestatus bernama occupied. BooleanRuleObject menentukan warna untuk nilai true dan false.

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

Langkah berikutnya

Pelajari selengkapnya tentang Pembuat untuk peta dalam ruangan dengan membaca:

Apa itu Azure Peta Creator?

Pembuat peta dalam ruangan