Creación de un conjunto de estados de características

Los conjuntos de estados de características definen propiedades dinámicas y valores en características específicas que los admiten. En este artículo se explica cómo crear un conjunto de estados que defina los valores y los estilos correspondientes para una propiedad y cambie el estado de una propiedad.

Prerrequisitos

• Finalización correcta de la Consulta de conjuntos de datos con la API de WFS.
• El datasetId obtenido en la sección Comprobación del estado de creación del conjunto de datos de Tutorial: Uso de Creator para crear planos interiores.

Importante

• En este artículo, se usa la dirección URL geográfica us.atlas.microsoft.com. Si el servicio Creator no se creó en la Estados Unidos, debe usar una dirección URL geográfica diferente. Para más información, consulte Acceso a los servicios de Creator.
• En los ejemplos de direcciones URL de este artículo deberá reemplazar:
  • {Azure-Maps-Subscription-key} con su clave de suscripción de Azure Maps.
  • {datasetId} por el valor de datasetId obtenido en la sección Comprobación del estado de creación del conjunto de datos del tutorial Uso de Creator para crear mapas de interiores.

Creación el conjunto de estados de características

Para crear un conjunto de estados:

Cree una nueva solicitud HTTP POST que use la Stateset API. La solicitud debe tener un aspecto similar a la siguiente dirección URL:

https://us.atlas.microsoft.com/featurestatesets?api-version=2.0&datasetId={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}

A continuación, establezca en Content-Type en application/json el encabezado de la solicitud.

Si usa una herramienta como Postman, debería tener este aspecto:

Por último, en el cuerpo de la solicitud HTTP, incluya la información de estilo en formato JSON sin formato, que aplica colores diferentes a la propiedad occupied en función de su valor:

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

Una vez que la respuesta se devuelva correctamente, copie statesetId desde el cuerpo de la respuesta. En la sección siguiente, usará statesetId para cambiar el estado de propiedad occupancy de la unidad con la característica id "UNIT26". Si usa Postman, aparece de la siguiente manera:

Actualización del estado de característica

Esta sección muestra cómo actualizar el estado occupied de la unidad con la característica id "UNIT26". Para actualizar el estado occupied, cree una nueva solicitud HTTP PUT llamando a la API Feature Statesets. La solicitud debería ser como la siguiente URL (sustituya {statesetId} por la statesetId obtenida en Crear un conjunto de estados de características):

https://us.atlas.microsoft.com/featurestatesets/{statesetId}/featureStates/UNIT26?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}

A continuación, establezca en Content-Type en application/json el encabezado de la solicitud.

Si usa una herramienta como Postman, debería tener este aspecto:

Por último, en el cuerpo de la solicitud HTTP, incluya la información de estilo en formato JSON sin formato, que aplica colores diferentes a la propiedad occupied en función de su valor:

{
    "states": [
        {
            "keyName": "occupied",
            "value": true,
            "eventTimestamp": "2020-11-14T17:10:20"
        }
    ]
}

Nota

La actualización solo se guardará si la marca de tiempo registrada es posterior a la marca de tiempo de la solicitud anterior.

Después de enviar la solicitud HTTP y completar la actualización, recibirá un código de estado HTTP 200 OK. Si ha implementado un estilo dinámico en un mapa de interiores, la actualización se muestra en la marca de tiempo especificada en el mapa representado.

Información adicional

• Para obtener información sobre cómo recuperar el estado de una característica mediante su id. de característica, consulte Estado de la característica: estados de lista.

• Para obtener información sobre cómo eliminar el estado de una característica y sus recursos, consulte Feature State - Delete Stateset.

• Para obtener información sobre el uso del servicio de estado de característica de Azure Maps Creator para aplicar estilos basados en las propiedades dinámicas de las características de datos de planos interiores, consulte el artículo Implementación de estilos dinámicos para planos interiores de Creator.

• Para más información sobre los distintos servicios de Azure Maps Creator que se deban tratar en este artículo, consulte Uso de Creator para planos interiores.

Pasos siguientes

Aprenda a implementar estilos dinámicos para planos interiores.

estilos dinámicos