Criar um conjunto de estados de recursos

Os conjuntos de estados de recursos definem propriedades e valores dinâmicos em recursos específicos que os suportam. 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

Importante

  • Este artigo usa o us.atlas.microsoft.com URL geográfico. Se o serviço Creator não tiver sido criado nos Estados Unidos, você deverá usar um URL geográfico diferente. Para obter mais informações, consulte Acesso aos Serviços de Criação.
  • Nos exemplos de URL neste artigo, você precisará substituir:
    • {Azure-Maps-Subscription-key} com a sua chave de subscrição do Azure Maps.
    • {datasetId}com o obtido na seção Verificar o status de criação do conjunto de dados do tutorial Usar o datasetId criador para criar mapas internos

Criar o conjunto de estados do recurso

Para criar um conjunto de estados:

Crie uma nova solicitação HTTP POST que use a API Stateset. A solicitação deve se parecer com a 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, deve ter esta aparência:

A screenshot of Postman showing the Header tab of the POST request that shows the Content Type Key with a value of application forward slash json.

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

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

Depois que a resposta retornar com êxito, copie o statesetId do corpo da resposta. Na próxima seção, você usará o para alterar o estado da propriedade da unidade com o statesetIdoccupancy recurso id "UNIT26". Se estiver usando Postman, ele aparece da seguinte forma:

A screenshot of Postman showing the resource Stateset ID value in the responses body.

Atualizar o estado de um recurso

Esta seção demonstra como atualizar o occupied estado da unidade com o recurso id "UNIT26". Para atualizar o occupied estado, crie uma nova Solicitação HTTP PUT chamando a API Feature Statesets. A solicitação deve se parecer com a seguinte URL (substitua {statesetId} pela statesetId obtida em Criar um conjunto de estados de recurso):

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, deve ter esta aparência:

A screenshot of the header tab information for stateset creation.

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

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

Nota

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

Depois que a solicitação HTTP for enviada e a atualização for concluída, você receberá um código de 200 OK status HTTP. Se você implementou o estilo dinâmico para um mapa interno, a atualização será exibida no carimbo de data/hora especificado no mapa renderizado.

Informações adicionais

Próximos passos

Saiba como implementar estilos dinâmicos para mapas internos.