StyleObject Schema reference guide for dynamic Mapy (Przewodnik dokumentacji schematu obiektu StylesObject dla Mapy dynamicznych)

Artykuł
01/04/2024

Jest StylesObject to tablica StyleObject reprezentująca style zestawu stanów. Użyj usługi Azure Mapy Creator Feature State, aby zastosować style zestawu stanów do funkcji danych mapy wewnętrznej. Po utworzeniu stylów zestawu stanów i skojarzeniu ich z funkcjami mapy wewnętrznej można ich użyć do tworzenia dynamicznych map wnętrz. Aby uzyskać więcej informacji na temat tworzenia dynamicznych map wnętrz, zobacz Implementowanie dynamicznej stylów dla map wnętrz twórcy.

StyleObject

A StyleObject jest jedną z następujących reguł stylu:

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

Poniższy kod JSON przedstawia przykładowe użycie każdego z trzech typów stylów. Służy BooleanTypeStyleRule do określania stylu dynamicznego dla funkcji, których occupied właściwość ma wartość true i false. Element NumericTypeStyleRule służy do określania stylu funkcji, których temperature właściwość mieści się w określonym zakresie. StringTypeStyleRule Na koniec element jest używany do dopasowywania określonych stylów do meetingTypeelementu .

 "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"
        }
      ]
    }
]

NumericTypeStyleRule

Element NumericTypeStyleRule jest elementem StyleObject i składa się z następujących właściwości:

Właściwość	Type	Opis	Wymagania
`keyName`	string	Nazwa stanu lub właściwości dynamicznej. Element `keyName` powinien być unikatowy wewnątrz tablicy `StyleObject` .	Tak
`type`	string	Wartość to `numeric`.	Tak
`rules`	`NumberRuleObject`	Tablica zakresów stylów liczbowych ze skojarzonymi kolorami. Każdy zakres definiuje kolor, który ma być używany, gdy wartość stanu spełnia zakres.	Tak

NumberRuleObject

Obiekt NumberRuleObject składa się z RangeObject właściwości i color . Jeśli wartość stanu mieści się w zakresie, jego kolor wyświetlania jest kolorem określonym we color właściwości.

Jeśli zdefiniujesz wiele nakładających się zakresów, wybrany kolor będzie kolorem zdefiniowanym w pierwszym zakresie, który jest spełniony.

W poniższym przykładzie JSON oba zakresy przechowują wartość true, gdy wartość stanu wynosi od 50 do 60. Jednak używany kolor jest #343deb spowodowany tym, że jest to pierwszy zakres na liście, który został spełniony.


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

Właściwość	Type	Opis	Wymagania
`range`	RangeObject	Obiekt RangeObject definiuje zestaw warunków zakresu logicznego, który, jeśli `true`, zmień kolor wyświetlania stanu na kolor określony we `color` właściwości. Jeśli `range` jest nieokreślony, kolor zdefiniowany we `color` właściwości jest zawsze używany.	Nie.
`color`	string	Kolor, który ma być używany, gdy wartość stanu mieści się w zakresie. Właściwość `color` jest ciągiem JSON w dowolnym z następujących formatów: Wartości szesnastkowy w stylu 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)") Wstępnie zdefiniowane nazwy kolorów HTML, takie jak żółte i niebieskie.	Tak

RangeObject

Element RangeObject definiuje wartość zakresu liczbowego typu NumberRuleObject. Aby wartość stanu mieściła się w zakresie, wszystkie zdefiniowane warunki muszą mieć wartość true.

Właściwość	Type	Opis	Wymagania
`minimum`	double	Wszystkie liczby x x ≥ `minimum`.	Nie.
`maximum`	double	Wszystkie liczby x x x ≤ `maximum`.	Nie.
`exclusiveMinimum`	double	Wszystkie liczby x x >`exclusiveMinimum`.	Nie.
`exclusiveMaximum`	double	Wszystkie liczby x x <`exclusiveMaximum`.	Nie.

Przykład metody NumericTypeStyleRule

Poniższy kod JSON ilustruje NumericTypeStyleRulestan o nazwie temperature. W tym przykładzie element NumberRuleObject zawiera dwa zdefiniowane zakresy temperatury i skojarzone ze nimi style kolorów. Jeśli zakres temperatury wynosi 50–69, na ekranie powinien być używany kolor #343deb. Jeśli zakres temperatur wynosi 31–70, na ekranie powinien być używany kolor #eba834.

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

StringTypeStyleRule

Element StringTypeStyleRule jest elementem StyleObject i składa się z następujących właściwości:

Właściwość	Type	Opis	Wymagania
`keyName`	string	Nazwa stanu lub właściwości dynamicznej. Element `keyName` powinien być unikatowy wewnątrz tablicy `StyleObject` .	Tak
`type`	string	Wartość to `string`.	Tak
`rules`	`StringRuleObject`	Tablica N wartości stanu .	Tak

StringRuleObject

Element StringRuleObject składa się z maksymalnie N wartości stanu, które są możliwymi wartościami ciągów właściwości funkcji. Jeśli wartość właściwości funkcji nie jest zgodna z żadnymi zdefiniowanymi wartościami stanu, ta funkcja nie będzie mieć stylu dynamicznego. Jeśli podano zduplikowane wartości stanu, pierwszy z nich ma pierwszeństwo.

Dopasowanie wartości ciągu jest uwzględniane w wielkości liter.

Właściwość	Type	Opis	Wymagania
`stateValue1`	string	Kolor, gdy ciąg wartości to stateValue1.	Nie.
`stateValue2`	string	Kolor, gdy ciąg wartości to stateValue.	Nie.
`stateValueN`	string	Kolor, gdy ciąg wartości to stateValueN.	Nie.

Przykład metody StringTypeStyleRule

Poniższy kod JSON ilustruje StringTypeStyleRule , który definiuje style skojarzone z określonymi typami spotkań.

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

Wartość logiczna TypuStyleRule

Element BooleanTypeStyleRule jest elementem StyleObject i składa się z następujących właściwości:

Właściwość	Type	Opis	Wymagania
`keyName`	string	Nazwa stanu lub właściwości dynamicznej. Element `keyName` powinien być unikatowy wewnątrz tablicy `StyleObject` .	Tak
`type`	string	Wartość to `boolean`.	Tak
`rules`	`BooleanRuleObject`	Para logiczna z kolorami i `truefalse`wartościami stanu.	Tak

Wartość logicznaRuleObject

Element BooleanRuleObject definiuje kolory dla true wartości i false .

Właściwość	Type	Opis	Wymagania
`true`	string	Kolor, który ma być używany, gdy wartość stanu to `true`. Właściwość `color` jest ciągiem JSON w dowolnym z następujących formatów: Wartości szesnastkowy w stylu 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)") Wstępnie zdefiniowane nazwy kolorów HTML, takie jak żółte i niebieskie.	Tak
`false`	string	Kolor, który ma być używany, gdy wartość stanu to `false`.	Tak

Przykład metody BooleanTypeStyleRule

Poniższy kod JSON ilustruje BooleanTypeStyleRulestan o nazwie occupied. Definiuje BooleanRuleObject kolory dla true wartości i false .

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

Następne kroki

Dowiedz się więcej o twórcy map w pomieszczeniach, czytając:

Co to jest usługa Azure Mapy Creator?

Twórca map wnętrz