Guide de référence du schéma StylesObject pour les cartes dynamiques

Article
07/26/2023

StylesObject est un tableau de StyleObject représentant des styles de stateset. Utilisez le service État de la fonctionnalité d’Azure Maps Creator pour appliquer vos styles de stateset à des caractéristiques de données de cartes d’intérieur. Une fois que vous avez créé vos styles de stateset et que vous les avez associés à des caractéristiques de cartes d’intérieur, vous pouvez les utiliser pour créer des cartes d’intérieur dynamiques. Pour plus d’informations sur la création de cartes d’intérieur dynamiques, consultez Implémenter des styles dynamiques pour les cartes d’intérieur du Créateur.

StyleObject

Un StyleObject est l’une des règles de style suivantes :

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

Le code JSON suivant montre un exemple d’utilisation de chacun des trois types de style. La règle BooleanTypeStyleRule est utilisée pour déterminer le style dynamique des fonctionnalités dont la propriété occupied a la valeur true et false. La NumericTypeStyleRule est utilisée pour déterminer le style des fonctionnalités dont la propriété temperature se situe dans une certaine plage. Enfin, la StringTypeStyleRule est utilisé pour faire correspondre des styles spécifiques à 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"
        }
      ]
    }
]

NumericTypeStyleRule

Un NumericTypeStyleRule est un StyleObject qui est constitué des propriétés suivantes :

Propriété	Type	Description	Obligatoire
`keyName`	string	État ou nom de propriété dynamique. Un `keyName` doit être unique au sein du tableau `StyleObject`.	Oui
`type`	string	La valeur est `numeric`.	Oui
`rules`	`NumberRuleObject`	Tableau de plages de style numériques avec les couleurs associées. Chaque plage définit une couleur à utiliser quand la valeur de l’état correspond à la plage.	Oui

NumberRuleObject

Un NumberRuleObject se compose d’un RangeObject et d’une propriété color. Si la valeur d’état est comprise dans la plage, sa couleur d’affichage est celle spécifiée dans la propriété color.

Si vous définissez plusieurs plages qui se chevauchent, la couleur choisie est celle qui est définie dans la première plage satisfaite.

Dans l’exemple JSON suivant, les deux plages sont satisfaites quand la valeur d’état est comprise entre 50 et 60. Toutefois, la couleur utilisée est #343deb, car il s’agit de la première plage de la liste qui a été satisfaite.


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

Propriété	Type	Description	Obligatoire
`range`	RangeObject	RangeObject définit un ensemble de conditions de plage logique qui, si `true`, modifient la couleur d’affichage de l’état en lui affectant celle spécifiée dans la propriété `color`. Si `range` n’est pas spécifié, la couleur définie dans la propriété `color` est toujours utilisée.	Non
`color`	string	Couleur à utiliser quand la valeur d’état est comprise dans la plage. La propriété `color` est une chaîne JSON ayant l’un des formats suivants : Valeurs hexadécimales de style 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) ») Des noms de couleurs HTML prédéfinis, tels que le jaune et le bleu.	Oui

RangeObject

RangeObject définit une valeur de plage numérique d’un NumberRuleObject. Pour que la valeur d’état soit comprise dans la plage, toutes les conditions définies doivent être remplies.

Propriété	Type	Description	Obligatoire
`minimum`	double	Tout nombre x où x ≥ `minimum`.	Non
`maximum`	double	Tout nombre x où x ≤ `maximum`.	Non
`exclusiveMinimum`	double	Tout nombre x où x >`exclusiveMinimum`.	Non
`exclusiveMaximum`	double	Tout nombre x où x <`exclusiveMaximum`.	Non

Exemple de NumericTypeStyleRule

Le code JSON suivant illustre un étatNumericTypeStyleRule nommé temperature. Dans cet exemple, le NumberRuleObject contient deux plages de température définies et les styles de couleur qui leur sont associés. Si la plage de températures est 50-69, l’affichage doit utiliser la couleur #343deb. Si la plage de températures est 31-70, l’affichage doit utiliser la couleur #eba834.

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

StringTypeStyleRule

Un StringTypeStyleRule est un StyleObject et est constitué des propriétés suivantes :

Propriété	Type	Description	Obligatoire
`keyName`	string	État ou nom de propriété dynamique. Un `keyName` doit être unique au sein du tableau `StyleObject`.	Oui
`type`	string	La valeur est `string`.	Oui
`rules`	`StringRuleObject`	Tableau d’un nombre N de valeurs d’état.	Oui

StringRuleObject

Un StringRuleObject est constitué d’un nombre maximum de N valeurs d’état qui sont les valeurs de chaîne possibles de la propriété d’une fonctionnalité. Si la valeur de propriété de la fonctionnalité ne correspond à aucune des valeurs d’état définies, cette fonctionnalité n’aura pas de style dynamique. Si des valeurs d’état dupliquées sont fournies, la première est prioritaire.

La correspondance des valeurs des chaînes respecte la casse.

Propriété	Type	Description	Obligatoire
`stateValue1`	string	Couleur lorsque la chaîne de valeur est stateValue1.	Non
`stateValue2`	string	Couleur lorsque la chaîne de valeur est stateValue.	Non
`stateValueN`	string	Couleur lorsque la chaîne de valeur est stateValueN.	Non

Exemple de StringTypeStyleRule

Le code JSON suivant illustre une StringTypeStyleRule qui définit des styles associés à des types de réunion spécifiques.

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

BooleanTypeStyleRule

Un BooleanTypeStyleRule est un StyleObject et est constitué des propriétés suivantes :

Propriété	Type	Description	Obligatoire
`keyName`	string	État ou nom de propriété dynamique. Un `keyName` doit être unique au sein du tableau `StyleObject`.	Oui
`type`	string	La valeur est `boolean`.	Oui
`rules`	`BooleanRuleObject`	Paire booléenne avec des couleurs pour les valeurs d’état`true` et `false`.	Oui

BooleanRuleObject

Un BooleanRuleObject définit des couleurs pour les valeurs true et false.

Propriété	Type	Description	Obligatoire
`true`	string	Couleur à utiliser quand la valeur d’état est `true`. La propriété `color` est une chaîne JSON ayant l’un des formats suivants : Valeurs hexadécimales de style 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) ») Des noms de couleurs HTML prédéfinis, tels que le jaune et le bleu.	Oui
`false`	string	Couleur à utiliser quand la valeur d’état est `false`.	Oui

Exemple de BooleanTypeStyleRule

Le code JSON suivant illustre un étatBooleanTypeStyleRule nommé occupied. Le BooleanRuleObject définit des couleurs pour les valeurs true et false.

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

Étapes suivantes

Si vous voulez en savoir plus sur Creator pour les cartes d’intérieur, consultez :

Présentation d’Azure Maps Creator

Créateur pour cartes d’intérieur