Como configurar um ícone para uma camada

Esta seção fornece orientações sobre como configurar um ícone para uma camada.

Cada ícone contém um conjunto de duas imagens, que podem ser o mesmo arquivo ou não: o ícone para representar a camada em si na janela Camadas e o ícone para representar os objetos contidos na camada. Para camadas exibindo mapas, apenas o ícone representando a camada será utilizado, e quaisquer outras informações fornecidas serão desconsideradas. Enquanto ícones representam a camada em si e também os objetos individuais no mapa, um ícone agregador (cluster icon) pode ser usado no mapa para indicar quando há mais de um objeto no mesmo local.

Também é possível configurar os ícones dos objetos a serem alterados dinamicamente baseado nos valores de certas propriedades de objetos. Para configurar esse recurso, os nomes das imagens a serem utilizadas devem conter os valores possíveis de cada propriedade, indicando qual imagem será utilizada para cada valor. Por exemplo, se o ícone estiver sendo configurado para mudar de acordo com a situação de um objeto, cujos valores possíveis são 1, 2 e 3, os nomes das imagens poderiam ser "icone_1", "icone_2" e "icone_3". No arquivo XML, a variável da propriedade Situação pode ser inserida no caminho da imagem, entre colchetes duplos (por exemplo, icone_{{StatusEnum}}.png). Ao utilizar o mapa, essa variável será substituída pelo valor da propriedade (1, 2 ou 3). Se configurado corretamente, o resultado dessa substituição corresponderá ao nome da imagem a ser utilizada. Observe que caracteres especiais não podem ser utilizados no nome da imagem e que o primeiro caractere não pode ser um número. Para mais informações sobre as propriedades que podem ser utilizadas como variáveis, entre em contato com a equipe de suporte.

Nota: o sistema não valida caminhos de ícones que contêm variáveis. Isso significa que, se você importar o arquivo XML manualmente através da seção Exportar/Importar Camadas, não será exibida uma notificação caso o caminho do arquivo seja inválido.

Todos os ícones são cadastrados dentro do grupo Icons e cada ícone é configurado em um nó Icon, conforme o exemplo abaixo.

<Icons>

<Icon id="ambulancia">

      <layerUrl>/Conteudo/img/mapa-icones/unidadesServico/icone_0_ambulancia.png</layerUrl>

      <url>/Conteudo/img/mapa-icones/unidadesServico/icone_{{StatusEnum}}_ambulancia.png</url>

      <retinaUrl>/Conteudo/img/mapa-icones/unidadesServico/icone_{{StatusEnum}}_ambulancia-2x.png</retinaUrl>

      <clusterUrl>/Conteudo/img/mapa-icones/unidadesServico/icone_ambulancia_cluster.png</clusterUrl>

      <clusterRetinaUrl>/Conteudo/img/mapa-icones/unidadesServico/icone_ambulancia_cluster-2x.png</clusterRetinaUrl>

      <size>[26,38]</size>

      <clusterSize>[40,40]</clusterSize>

      <anchor>[4,37]</anchor>

      <popupAnchor>[14,-52]</popupAnchor>

</Icon>

      …

</Icons>

Na estrutura XML do ícone, os seguintes elementos podem ser configurados:

Observe que ícones de eventos agendados são realçados no mapa quando a opção para visualizar rotas ou atividades associadas for habilitada. Isso tamém ocorrerá para atividades caso a funcionalidade para visualizar rotas associadas esteja habilitada. Para tal, deve-se configurar outra imagem para indicar que o objeto está selecionado. As configurações abaixo são fornecidas por padrão para esses ícones no arquivo "\App_Data\MapQueriesConfig.xml".

<Icon id="event">

…

<selectedUrl>/Content/img/pins-

selecionados/icone_evento_selecionado.png</selectedUrl>

<selectedRetinaUrl>/Content/img/pins-

selecionados/icone_evento_selecionado-2x.png</selectedRetinaUrl>

…

</Icon>

Além disso, os ícones de ativos do tipo Câmera também são realçados por padrão quando a opção de localização da câmera for habilitada na janela que reproduz a gravação. As configurações abaixo também são fornecidas por padrão para cada ícone de câmera no arquivo XML.

<Icon id="camera">

…

<selectedUrl>/Content/img/pins-

selecteds/icon_camera_selected.png</selectedUrl>

<selectedRetinaUrl>/Content/img/pins-

selecteds/icon_camera_selected-2x.png</selectedRetinaUrl>

…

</Icon>

Também é importante observar que o ícone agregador pode ser habilitado e desabilitado. Para desabilitar esse ícone, insira o valor -1 no elemento EnableClustering no arquivo web.config. Quaisquer outros valores inseridos para esse elemento irão habilitar esse ícone. O nível de zoom no ícone agregador pode ser definido no elemento SearchZoom, que aceita valores de 1 a 16. Por padrão, o zoom vem configurado com o maior valor.

IMPORANTE! Caso a versão do sistema seja atualizada, o arquivo XML deverá ser atualizado com as configurações acima para que os ícones de eventos agendados, atividades e câmeras sejam realçados.

A tabela abaixo fornece orientações sobre esses parâmetros.

Nota: os parâmetros abaixo também podem ser inseridos nesses ícones.