Guía de referencia del esquema de StylesObject para Azure Maps dinámico

Artículo
07/27/2023

StylesObject es una matriz de objetos StyleObject que representa los estilos del conjunto de estados. Use la característica Servicio de estado de Azure Maps Creator para aplicar los estilos del conjunto de estados a las características de los datos de mapas de interiores. Una vez que haya creado los estilos del conjunto de estados y los haya asociado con las características del mapa de interiores, puede usarlos para crear mapas de interiores dinámicos. Para más información sobre la creación de mapas de interiores dinámicos, consulte Implementación de estilos dinámicos para mapas de interiores de Creator.

StyleObject

StyleObject es una de las siguientes reglas de estilo:

BooleanTypeStyleRule
NumericTypeStyleRule
StringTypeStyleRule

El siguiente JSON muestra ejemplos de uso de cada uno de los tres tipos de estilo. BooleanTypeStyleRule se utiliza para determinar el estilo dinámico de las características cuya propiedad occupied es true y false. NumericTypeStyleRule se utiliza para determinar el estilo de las características cuya propiedad temperature se encuentra dentro de un intervalo determinado. Por último, StringTypeStyleRule se usa para hacer coincidir estilos específicos con 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 elemento NumericTypeStyleRule es un objeto StyleObject y consta de las siguientes propiedades:

Propiedad	Tipo	Descripción	Obligatorio
`keyName`	string	Estado o nombre de la propiedad dinámica. `keyName` debe ser único dentro de una matriz de elementos `StyleObject`.	Sí
`type`	string	El valor es `numeric`.	Sí
`rules`	`NumberRuleObject`	Matriz de intervalos de estilos numéricos con colores asociados. Cada intervalo define un color que se va a utilizar cuando el valor de estado está en el intervalo.	Sí

NumberRuleObject

Un elemento NumberRuleObject consta de un objeto RangeObject y una propiedad color. Si el valor de estado entra dentro del rango, su color para la visualización es el color especificado en la color propiedad.

Si define varios intervalos superpuestos, el color elegido será el color que se define en el primer intervalo que se cumple.

En la siguiente muestra JSON, ambos rangos se mantienen cuando el valor del estado está entre 50-60. Sin embargo, el color que se utiliza es porque es #343deb el primer rango de la lista que se ha cumplido.


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

Propiedad	Tipo	Descripción	Obligatorio
`range`	RangeObject	El elemento RangeObject define un conjunto de condiciones de intervalo lógico, que, si es `true`, cambia el color de presentación de estado al color especificado en la propiedad `color`. Si `range` no se especifica, siempre se utiliza el color definido en la propiedad `color` .	No
`color`	string	Color que se va a usar cuando el valor de estado está en el intervalo. La propiedad `color` es una cadena JSON en cualquiera de los formatos siguientes: Valores hexadecimales de estilo 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)") Nombres de colores HTML predefinidos, como yellow (amarillo) y blue (azul).	Sí

RangeObject

RangeObject define un valor de intervalo numérico de un objeto NumberRuleObject. Para que el valor de estado entre en el intervalo, todas las condiciones definidas deben ser verdaderas.

Propiedad	Tipo	Descripción	Obligatorio
`minimum`	double	Todo número x en el que x ≥ `minimum`.	No
`maximum`	double	Todo número x en el que x ≤ `maximum`.	No
`exclusiveMinimum`	double	Todo número x en el que x >`exclusiveMinimum`.	No
`exclusiveMaximum`	double	Todo número x en el que x <`exclusiveMaximum`.	No

Ejemplo de NumericTypeStyleRule

El siguiente código JSON muestra un estado de tipo NumericTypeStyleRule llamado temperature. En este ejemplo, NumberRuleObject contiene dos intervalos de temperatura definidos y sus estilos de color asociados. Si el intervalo de temperatura está entre 50 y 69, la representación debe utilizar el color #343deb. Si el intervalo de temperatura está entre 31 y 70, la representación debe utilizar el color #eba834.

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

StringTypeStyleRule

Un elemento StringTypeStyleRule es un objeto StyleObject y consta de las siguientes propiedades:

Propiedad	Tipo	Descripción	Obligatorio
`keyName`	string	Estado o nombre de la propiedad dinámica. `keyName` debe ser único dentro de una matriz de elementos `StyleObject`.	Sí
`type`	string	El valor es `string`.	Sí
`rules`	`StringRuleObject`	Matriz de N número de valores de estado.	Sí

StringRuleObject

StringRuleObject consta de hasta N números de valores de estado que son los posibles valores de cadena de la propiedad de una característica. Si el valor de propiedad de la característica no coincide con ninguno de los valores de estado definidos, esa característica no tendrá un estilo dinámico. Si se proporcionan valores de estado duplicados, el primero tiene prioridad.

La coincidencia de valores de cadena distingue entre mayúsculas y minúsculas.

Propiedad	Tipo	Descripción	Obligatorio
`stateValue1`	string	El color cuando la cadena de valor es stateValue1.	No
`stateValue2`	string	El color cuando la cadena de valor es stateValue.	No
`stateValueN`	string	El color cuando la cadena de valor es stateValueN.	No

Ejemplo de StringTypeStyleRule

El siguiente JSON muestra una regla StringTypeStyleRule que define los estilos asociados a tipos de reuniones concretos.

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

BooleanTypeStyleRule

Un elemento BooleanTypeStyleRule es un objeto StyleObject y consta de las siguientes propiedades:

Propiedad	Tipo	Descripción	Obligatorio
`keyName`	string	Estado o nombre de la propiedad dinámica. `keyName` debe ser único dentro de una matriz de elementos `StyleObject`.	Sí
`type`	string	El valor es `boolean`.	Sí
`rules`	`BooleanRuleObject`	Un par booleano con colores para los valores de estado`true` y `false`.	Sí

BooleanRuleObject

Un elemento BooleanRuleObject define los colores para los valores true y false.

Propiedad	Tipo	Descripción	Obligatorio
`true`	string	Color que se va a usar cuando el valor de estado sea `true`. La propiedad `color` es una cadena JSON en cualquiera de los formatos siguientes: Valores hexadecimales de estilo 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)") Nombres de colores HTML predefinidos, como yellow (amarillo) y blue (azul).	Sí
`false`	string	Color que se va a usar cuando el valor de estado sea `false`.	Sí

Ejemplo de BooleanTypeStyleRule

El siguiente código JSON muestra un estado de tipo BooleanTypeStyleRule llamado occupied. Un elemento BooleanRuleObject define los colores para los valores true y false.

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

Pasos siguientes

Para más información sobre Creator para mapas interiores, lea lo siguiente:

¿Qué es Azure Maps Creator?

Uso de Creator para planos interiores