Criar um conjunto de estados do recurso

Os conjuntos de estados de recurso definem propriedades e valores dinâmicos em recursos específicos compatíveis. Este artigo explica como criar um conjunto de estados que define valores e estilos correspondentes para uma propriedade e alterar o estado de uma propriedade.

Pré-requisitos

• A conclusão bem-sucedida de Consultar conjuntos de dados com a API do WFS.
• A datasetId obtida na seção Verificar o status de criação do conjunto de dados do tutorial Usar o criador para criar mapas do interior.

Importante

• Este artigo usa a URL geográfica us.atlas.microsoft.com. Se seu serviço Criador não tiver sido criado no Estados Unidos, use uma URL geográfica diferente. Para saber mais, confira Acesso aos serviços do Criador.
• Nos exemplos de URL neste artigo, você precisará substituir:
  • {Azure-Maps-Subscription-key} por sua chave de assinatura do Azure Mapas.
  • {datasetId} pela datasetId obtida na seção Verificar o status de criação do conjunto de dados do tutorial Usar o criador para criar mapas internos

Criar o conjunto de estados de recursos

Para criar um conjuntos de estados:

Crie uma nova Solicitação HTTP POST que use a API de Conjunto de Estados. A solicitação deve ser semelhante à seguinte URL:

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

Em seguida, defina o Content-Type como application/json no Cabeçalho da solicitação.

Se estiver usando uma ferramenta como o Postman, ele deverá ter esta aparência:

Finalmente, no Corpo da solicitação HTTP, inclua as informações de estilo no formato JSON bruto, que aplica cores diferentes à propriedade occupied dependendo de seu valor:

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

Depois que a resposta for retornada com sucesso, copie statesetId do corpo dela. Na próxima seção, usaremos statesetId para alterar o estado da propriedade occupancy da unidade com o recurso id "UNIT26". Se usar o Postman, ele aparece da seguinte maneira:

Atualizar o estado de um recurso

Esta seção demonstra como atualizar o estado occupied da unidade com o recurso "UNIT26" id. Para atualizar o estado occupied, crie uma nova Solicitação HTTP PUT chamando a API de Conjuntos de Estados de Recursos. A solicitação deve ser semelhante à seguinte URL (substitua {statesetId}} pelo statesetId obtido em Criar um conjunto de estados de recursos):

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

Em seguida, defina o Content-Type como application/json no Cabeçalho da solicitação.

Se estiver usando uma ferramenta como o Postman, ele deverá ter esta aparência:

Finalmente, no Corpo da solicitação HTTP, inclua as informações de estilo no formato JSON bruto, que aplica cores diferentes à propriedade occupied dependendo de seu valor:

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

Observação

A atualização só será salva se o carimbo de data/hora postado for posterior ao carimbo de data/hora da solicitação anterior.

Uma vez que a solicitação HTTP é enviada e a atualização é concluída, você recebe um código de status HTTP 200 OK. Ao implementar o estilo dinâmico para um mapa interno, a atualização é exibida no mapa renderizado no carimbo de data/hora especificado.

Informações adicionais

• Para obter informações sobre como recuperar o estado de um recurso usando sua ID de recurso, consulte Estado do recurso - Listar estados.

• Para obter informações de como excluir o conjunto de estados e os respectivos recursos, confira Estado do recurso: excluir conjunto de estados.

• Para obter informações de como usar o serviço Estado do recurso do Criador do Azure Mapas para aplicar estilos baseados nas propriedades dinâmicas dos recursos de dados de mapa do interior, confira o artigo Implementar o estilo dinâmico para os mapas do interior do Criador.

• Para obter mais informações sobre os diferentes serviços do Criador do Azure Mapas discutidos neste artigo, confira Mapas do interior do Criador.

Próximas etapas

Saiba como implementar estilo dinâmico para os mapas do interior do Criador.

estilo dinâmico