Ir para o conteúdo principal

Mapa

Um formulário do tipo "Mapa" vinculado à uma variável do tipo "Mapa" serve para disponibilizar ao usuário no no portal visualizar um local marcado no mapa do Google Maps. A funcionalidade é uma integração com a ferramenta do Google.

** Na versão 17.7.0.612 foi liberado algumas melhorias no formulário do tipo "Mapa", e abaixo iremos criar um exemplo para explicar melhor esse recurso. 

Ponto único

Permite apenas um ponto destacado no mapa.

  • Acesse o DOX Estúdio.
  • Crie um processo BPM com uma atividade e um formulário do tipo "Mapa".

Aqui é importante ressaltar o detalhe que, caso o formulário do tipo "Mapa" NÃO contenha variável ou a variável vinculada NÃO possua um valor, o sistema irá buscar a localização do navegador e mostrar no Portal. 

Na criação do formulário, vamos falar sobre a variável do tipo "Mapa": 

    image-1674653384706.png

    Ao editar/criar a variável, no campo "Modo", existem duas opções:

    • Ponto(s): Permitirá informar latitude, longitude de 1 ou mais pontos, ficando no formato de exemplo: 
    [{ latitude: 0.0, longitude: 0.0 }, { latitude: 0.0, longitude: 0.0 }]
    • Área(s): Permitirá informar latitude, longitude e raio* (*em metros) das áreas circulares, ficando no formato de exemplo: 
    [{ latitude: 0.0, longitude: 0.0, raio: 0.0 }, { latitude: 0.0, longitude: 0.0, raio: 0.0 }]

    Como queremos um ponto único no mapa, vamos incluir apenas um endereço, por exemplo: 

    [{"latitude":-28.656144273930494, "longitude":-49.34853512882069}]

    Na aba "Propriedades" do formulário, coloque o campo "Tipo Localização" como "Ponto único". O formato padrão é meramente uma configuração visual do mapa, escolha de acordo com o seu desejo.

    image-1674654490395.png

      Salve o processo e teste no portal. 

      image-1674654662425.png

      Multipontos 

      Permite mais de um ponto destacado no mapa. Crie um evento de "Definir valor variável" para a variável do tipo "Mapa" vinculado no formulário Mapa, com o valor abaixo: 

      [{
  "latitude":-28.71825493151401, 
  "longitude":-49.369759
 },
 {
  "latitude":-8.758722281909304, 
  "longitude":-63.87884181349305
 }, 
 {
  "latitude":-15.587467148108567, 
  "longitude":-56.083471763220025
 }, 
 {
  "latitude":-29.161201181842994, 
  "longitude":-51.184928457671305
 }]

      ** Importante verificar se a variável está com o modo "Ponto(s)".

      Edite o formulário e no campo "Tipo localização" coloque como "Multiponto".

      image-1674655569831.png

      Salve o processo e verifique no portal. 

      image-1674652209663.png

      Área: 

      Permite destacar em formato circular certas áreas do mapa. 

      image-1674655960037.png

      Como vamos apenas destacar um local, pode-se utilizar o valor padrão da variável da área, porém também é possível adicionar mais de um endereço por um evento de definir valor variável, como falamos lá em multipontos. 

      [{"latitude":-28.656144273930494, "longitude":-49.34853512882069, "raio":1500}]

      ** Foi utilizado um tamanho grande no raio (em metros) pois os pontos anteriores do mapa eram muito distantes, porém pode ser utilizado um valor menor (ex: 300) como exemplo. 

      image-1674656075618.png

      Observações: 

      • A variável principal "Armazenar em" do Mapa precisa ser do tipo Mapa e do modo "Ponto(s)", já a variável "Áreas" precisa ser precisa ser do tipo Mapa e do modo "Área(s)".
      • Se não houver nenhum ponto, vai manter o padrão de trazer a localização atual.
      • É possível atualizar o valor do mapa via PEX/JEX, porém apenas de ponto/multiponto e não áreas. 

      Obs: A utilização deste recurso em dispositivos móveis será permitida apenas em servidores com certificado SSL/HTTPS. Para adicionar um certificado SSL/HTTPS a aplicação, clique aqui

      Voltar ao topo