Passar para o conteúdo principal

Como adicionar um mapa de geolocalização ao PDF Personalizado?

Aprenda a adicionar um mapa com a localização registrada nos seus formulários ao PDF Personalizado da DataScope.

Escrito por Jessica Franco

Você pode adicionar um mapa de geolocalização ao PDF Personalizado do seu formulário usando as coordenadas de latitude e longitude registradas durante a resposta.

Para configurá-lo, você precisa usar um componente do tipo Image dentro do Editor de PDF.

📍 Passo 1: Abra o Editor de PDF

  1. Acesse Formulários.

  2. Selecione o formulário que deseja configurar.

  3. Vá para Configurar > Configurar PDF > PDF Personalizado.

  4. Selecione Abrir Editor PDF.

📌 Passo 2: Identifique os campos de latitude e longitude

Antes de adicionar a imagem, você precisa identificar os campos de latitude e longitude correspondentes à pergunta do seu formulário que registra a localização.

Para obtê-los:

  1. No Editor PDF, selecione Insert Data Field.

  2. Procure a pergunta que contém os dados de geolocalização.

  3. Selecione os campos correspondentes a latitude e longitude.

  4. Anote ou copie esses nomes de campo, já que você vai precisar deles no próximo passo.

Por exemplo, para uma pergunta chamada "Cliente", os campos podem ficar assim:

{k_Cliente_1::latitude} {k_Cliente_1::longitude}

📌 Importante: esses valores são apenas um exemplo. Os nomes dos campos dependem da estrutura de cada formulário.

🖼️ Passo 3: Adicione uma imagem e configure a URL do mapa

Dentro do Editor PDF:

  1. Selecione um componente Image.

  2. Nas propriedades do componente, procure o campo Value.

  3. Nesse campo, adicione a URL do mapa, substituindo as coordenadas pelos campos de latitude e longitude que você identificou no passo anterior.

Por exemplo, a URL completa que você deve inserir no campo Value fica assim:

https://maps.googleapis.com/maps/api/staticmap?size=700x70&maptype=roadmap&markers=icon:https://www.mydatascope.com/assets/favicon.ico%7Csize:mid%7Clabel:1%7C{k_Cliente_1::latitude},%20{k_Cliente_1::longitude}&visible={k_Cliente_1::latitude},%20{k_Cliente_1::longitude}&zoom=15&key=AIzaSyB39JUuV_2N_2i-bh6tzAfPcEWxeUh777c

📌 Importante: não copie essa URL diretamente. Substitua {k_Cliente_1::latitude} e {k_Cliente_1::longitude} pelos campos correspondentes ao seu próprio formulário, obtidos no passo anterior.

🗺️ Passo 4: Personalize o mapa

A URL do mapa permite configurar diferentes parâmetros, como o tamanho, o tipo de mapa e o nível de aproximação.

Por exemplo:

  • size=700x70 → Tamanho da imagem em pixels.

  • maptype=roadmad → Exibe a vista de satélite em vez do mapa normal.

  • markers=icon:URL_ICONO|size:mid|label:1|lat,long → Coloca um marcador personalizado nas coordenadas.

  • zoom=15 → Define o nível de aproximação do mapa.

Tipos de mapa

Valor

Descrição

Exemplo

roadmap

Mapa padrão com ruas e estradas (modo padrão).

satellite

Vista de imagens de satélite sem rótulos.🌍

hybrid

Vista de satélite com rótulos de ruas e nomes de lugares. 🏙️

terrain

Mapa com informações topográficas, elevações e relevo. ⛰️

👀 Passo 5: Confira a prévia

Depois de configurar a URL:

  1. Selecione Preview.

  2. Verifique se o mapa aparece corretamente.

  3. Confirme se o marcador corresponde à localização registrada.

  4. Se tudo estiver correto, selecione Salvar.

A partir desse momento, o mapa vai aparecer no PDF Personalizado gerado para as respostas do formulário.

⚠️ O mapa não aparece?

Se o mapa não aparecer corretamente, verifique:

  • Se os campos de latitude e longitude correspondem ao seu formulário.

  • Se você usou os campos a partir de Insert Data Field.

  • Se a resposta tem dados de geolocalização registrados.

  • Se a URL do mapa está configurada corretamente.

  • Se você salvou as alterações no Editor PDF.

💡 Importante: se a resposta não contiver dados de geolocalização, não será possível exibir corretamente o mapa correspondente a essa resposta.

📌 Lembre-se

O mapa usa as coordenadas de latitude e longitude registradas em cada resposta. Por isso, a localização exibida no PDF depende dos dados de geolocalização disponíveis nessa resposta.

👉 Quer personalizar ainda mais seu PDF? Consulte: Como personalizar o PDF gerado na DataScope?

Respondeu à sua pergunta?