Share via


StylesObject-Schemareferenzhandbuch für dynamische Karten

Das StylesObject ist ein StyleObject-Array, das Zustandsset-Formatvorlagen darstellt. Verwenden Sie den Featurezustandsdienst von Azure Maps-Ersteller, um Ihre Zustandsset-Formatvorlagen auf die Features von Gebäudeplandaten anzuwenden. Nachdem Sie Ihre Zustandsset-Formatvorlagen erstellt und den Features von Gebäudeplänen zugeordnet haben, können Sie sie zum Erstellen dynamischer Gebäudepläne verwenden. Weiter Informationen zum Erstellen dynamischer Gebäudepläne finden Sie unter Implementieren dynamischer Formatvorlagen für Gebäudepläne von Ersteller.

StyleObject

Ein StyleObject ist eine der folgenden Formatvorlagenregeln:

Der folgende JSON-Code zeigt ein Beispiel für die Verwendung aller drei Formatvorlagentypen. Mit der BooleanTypeStyleRule wird die dynamische Formatvorlage für Features festgelegt, deren occupied-Eigenschaft den Wert TRUE bzw. FALSE aufweist. Mit der NumericTypeStyleRule wird die Formatvorlage für Features festgelegt, deren temperature-Eigenschaft in einem bestimmten Bereich liegt. Mit der StringTypeStyleRule werden schließlich die festgelegten Formatvorlagen mit dem meetingType abgeglichen.

 "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

Eine NumericTypeStyleRule ist ein StyleObject und besteht aus folgenden Eigenschaften:

Eigenschaft Typ Beschreibung Erforderlich
keyName Zeichenfolge Der Zustand oder der dynamische Eigenschaftsname. Ein keyName sollte im StyleObject-Array eindeutig sein. Ja
type Zeichenfolge Der Wert lautet numeric. Ja
rules NumberRuleObject Ein Array aus numerischen Formatvorlagenbereichen mit zugeordneten Farben. Jeder Bereich definiert eine Farbe, die verwendet werden soll, wenn der Wert von state den Bereich erfüllt. Ja

NumberRuleObject

Ein NumberRuleObject besteht aus einem RangeObject und einer color-Eigenschaft. Wenn der Wert von Zustand in den Bereich fällt, wird seine Farbe für die Anzeige die in der color-Eigenschaft angegebene Farbe.

Wenn Sie mehrere überlappende Bereiche definieren, ist die ausgewählte Farbe die Farbe, die im ersten Bereich definiert ist, der erfüllt wird.

Im folgenden JSON-Beispiel sind beide Bereiche „true“, wenn der Wert von Zustand zwischen 50 und 60 liegt. Die verwendete Farbe ist jedoch #343deb, da dies der erste Bereich in der Liste ist, der erfüllt wurde.


    {
        "rules":[
            {
                "range": {
                "minimum": 50,
                "exclusiveMaximum": 70
                },
                "color": "#343deb"
            },
            {
                "range": {
                "minimum": 50,
                "maximum": 60
                },
                "color": "#eba834"
            }
        ]
    }
]
Eigenschaft Typ Beschreibung Erforderlich
range RangeObject Das RangeObject definiert einen Satz logischer Bereichsbedingungen, die, wenn sie true sind, die Anzeigefarbe von Zustand in die in der Eigenschaft color angegebene Farbe ändern. Wenn range nicht angegeben ist, wird immer die in der Eigenschaft color definierte Farbe verwendet. Nein
color Zeichenfolge Die zu verwendende Farbe, wenn der Wert von „Zustand“ in den Bereich fällt. Die color-Eigenschaft ist eine JSON-Zeichenfolge in einem der folgenden Formate:
  • Hexadezimalwerte im HTML-Format
  • RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)")
  • RGBA ("rgba(255, 255, 0, 1)")
  • HSL("hsl(100, 50%, 50%)")
  • HSLA("hsla(100, 50%, 50%, 1)")
  • Vordefinierte HTML-Farbnamen wie Gelb oder Blau.
Ja

RangeObject

Das RangeObject definiert einen numerischen Bereichswert eines NumberRuleObject. Damit der Wert von Zustand in den Bereich fällt, müssen alle definierten Bedingungen „true“ sein.

Eigenschaft Typ Beschreibung Erforderlich
minimum double Alle Zahlen x, die x ≥ minimum. Nein
maximum double Alle Zahlen x, die x ≤  maximum. Nein
exclusiveMinimum double Alle Werte x, die x >exclusiveMinimum sind. Nein
exclusiveMaximum double Alle Werte x, die x <exclusiveMaximum sind. Nein

Beispiel für NumericTypeStyleRule

Der folgende JSON-Code veranschaulicht einen NumericTypeStyleRuleZustand namens temperature. In diesem Beispiel enthält das NumberRuleObject zwei definierte Temperaturbereiche und die diesen zugeordneten Farbformatvorlagen. Wenn der Temperaturbereich 50–69 ist, sollte die Anzeige die Farbe #343deb verwenden. Ist der Temperaturbereich 31–70, sollte die Anzeige die Farbe #eba834 verwenden.

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

StringTypeStyleRule

Eine StringTypeStyleRule ist ein StyleObject und besteht aus folgenden Eigenschaften:

Eigenschaft Typ Beschreibung Erforderlich
keyName Zeichenfolge Der Zustand oder der dynamische Eigenschaftsname. Ein keyName sollte im StyleObject-Array eindeutig sein. Ja
type Zeichenfolge Der Wert lautet string. Ja
rules StringRuleObject Ein Array von N state-Werten. Ja

StringRuleObject

Ein StringRuleObject besteht aus bis zu N Zustandswerten („state“), die die möglichen Zeichenfolgenwerte für die Eigenschaft eines Features sind. Wenn der Eigenschaftswert des Features mit keinem der definierten Zustandswerte übereinstimmt, hat dieses Feature keinen dynamischen Stil. Wenn Zustandswerte mehrfach angegeben werden, hat der erste Vorrang.

Beim Vergleich von Zeichenfolgenwerten wird die Groß-/Kleinschreibung beachtet.

Eigenschaft Typ Beschreibung Erforderlich
stateValue1 Zeichenfolge Die Farbe, wenn die Zeichenfolge im Wert „stateValue1“ lautet. Nein
stateValue2 Zeichenfolge Die Farbe, wenn die Zeichenfolge im Wert „stateValue2“ lautet. Nein
stateValueN Zeichenfolge Die Farbe, wenn die Zeichenfolge im Wert „stateValueN“ lautet. Nein

Beispiel für StringTypeStyleRule

Der folgende JSON-Code veranschaulicht eine StringTypeStyleRule, die die bestimmten Besprechungstypen zugeordneten Formatvorlagen definiert.

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

BooleanTypeStyleRule

Eine BooleanTypeStyleRule ist ein StyleObject und besteht aus folgenden Eigenschaften:

Eigenschaft Typ Beschreibung Erforderlich
keyName Zeichenfolge Der Zustand oder der dynamische Eigenschaftsname. Ein keyName sollte im StyleObject-Array eindeutig sein. Ja
type Zeichenfolge Der Wert lautet boolean. Ja
rules BooleanRuleObject Ein boolesches Paar mit Farben für true- und false-Werte von Zustand. Ja

BooleanRuleObject

Ein BooleanRuleObject definiert Farben für true- und false-Werte.

Eigenschaft Typ Beschreibung Erforderlich
true Zeichenfolge Die zu verwendende Farbe, wenn der Wert von Zustandtrue ist. Die color-Eigenschaft ist eine JSON-Zeichenfolge in einem der folgenden Formate:
  • Hexadezimalwerte im HTML-Format
  • RGB ("#ff0", "#ffff00", "rgb(255, 255, 0)")
  • RGBA ("rgba(255, 255, 0, 1)")
  • HSL("hsl(100, 50%, 50%)")
  • HSLA("hsla(100, 50%, 50%, 1)")
  • Vordefinierte HTML-Farbnamen wie Gelb oder Blau.
Ja
false Zeichenfolge Die zu verwendende Farbe, wenn der Wert von Zustandfalse ist. Ja

Beispiel für BooleanTypeStyleRule

Der folgende JSON-Code veranschaulicht einen BooleanTypeStyleRuleZustand namens occupied. Das BooleanRuleObject definiert Farben für true- und false-Werte.

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

Nächste Schritte

Weitere Informationen zu Creator für Gebäudepläne finden Sie hier: