Criar um conjunto de estados do recurso

  • Artigo

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

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:

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:

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 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:

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 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:

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 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

Próximas etapas

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

estilo dinâmico