KMZ, formatos geo e links de mapa

Comando: CAPCAD_GEO_EXPORT, CAPCAD_GEO_LINK_MAPS, CAPCAD_GEO_LINK_STREETVIEW, CAPCAD_GEO_LINK_EARTH, CAPCAD_GEO_LINK_MAPS_URL, CAPCAD_GEO_LINK_WEBMAP, CAPCAD_GEO_STREETVIEW_IMAGE, CAPCAD_GEO_IMAGERY_PICK, CAPCAD_GEO_IMAGERY_VIEW, CAPCAD_GEO_IMAGERY_ALIGNMENT, CAPCAD_GEO_HELP Atualizado 2026-09-03
Comandos CAPCAD_GEO_EXPORT (formulário); e os comandos de linha CAPCAD_GEO_LINK_MAPS, CAPCAD_GEO_LINK_STREETVIEW, CAPCAD_GEO_LINK_EARTH, CAPCAD_GEO_LINK_MAPS_URL, CAPCAD_GEO_LINK_WEBMAP, CAPCAD_GEO_STREETVIEW_IMAGE, CAPCAD_GEO_IMAGERY_PICK, CAPCAD_GEO_IMAGERY_VIEW, CAPCAD_GEO_IMAGERY_ALIGNMENT e CAPCAD_GEO_HELP
Atalho nenhum
Ribbon aba CapCad › painel Gerenciar › botão dividido OutputConversor KMZ; painel GIS › botão dividido ToolsEntity To/From Text; painel GIS › botão dividido IdentifyGoogle Street View: Web, Point to Google Maps, GeoImage GMaps Click, Google Earth Point, Url from Google Maps/Street view to Point; painel GIS › botão dividido DataQuick WebMap [Esri Leaflet]
Categoria GeoData
Formulário EntityGeoFormatsForm, título "Entidade para formato geo", três abas (não modal). Os demais comandos não têm formulário
CADs CAPCAD_GEO_EXPORT, os links de mapa e CAPCAD_GEO_IMAGERY_PICK: AutoCAD, BricsCAD, GstarCAD, ZWCAD, ARES Commander. CAPCAD_GEO_STREETVIEW_IMAGE, CAPCAD_GEO_IMAGERY_VIEW e CAPCAD_GEO_IMAGERY_ALIGNMENT: só AutoCAD

O projeto sai do CAD e entra no Google Earth; o mundo entra no CAD. Uma via desenhada vale muito mais quando o cliente pode abri-la no celular, e um trecho é muito mais fácil de projetar com a imagem de satélite embaixo.

  • KMZ da sinalização vertical com a imagem de cada placa. Cada placa vira um alfinete com o desenho dela no balão, agrupado por implantar, manter e remover.
  • Seis formatos de saída. KML, GPX, GeoJSON, EsriJSON, CapJSON e script de CAD, direto da seleção.
  • E de volta. Cole um GeoJSON e ele vira polylines, com o nome de um campo virando o nome do layer.
  • O ponto clicado no navegador. Google Maps, Street View e Google Earth abrem exatamente no ponto que você clicou no desenho.
  • O caminho inverso também. Copie um link do Google Maps e o comando desenha aquele ponto no seu desenho, no fuso certo.
  • Imagem de satélite georreferenciada dentro do desenho. Numa posição, no centro da tela, ou enfileirada ao longo de todo o eixo.

O que faz

Esta página reúne o que sai do desenho para o mundo e o que entra do mundo para o desenho. Todos estes comandos precisam saber o sistema de coordenadas do desenho — ver Coordenadas e sistema de coordenadas.

CAPCAD_GEO_EXPORT abre um formulário não modal de três abas:

  • KML, GPX, JSON, CAD — entidades para texto em seis formatos, e texto para entidades em cinco.
  • KMZ Vertical — o KMZ da sinalização vertical: cada placa selecionada vira um placemark com ícone e/ou balão, e a imagem da placa vai junto dentro do arquivo.
  • KMZ Horizontal — a sinalização horizontal selecionada, convertida em traços com a cadência aplicada e exportada como KML.

Os comandos de link trabalham com um ou dois cliques e não têm formulário:

Comando O que faz
CAPCAD_GEO_LINK_MAPS Um clique → abre google.com/maps no ponto e copia o link. O zoom do link é deduzido do zoom atual do CAD.
CAPCAD_GEO_LINK_STREETVIEW Em laço: cada clique desenha um POINT no layer CAPCAD_GIS_STREETVIEW (cor 150), abre o Street View no ponto e copia o link. Esc encerra.
CAPCAD_GEO_LINK_EARTH Um clique → grava temp.kml na pasta de exportações do projeto e o abre; o Google Earth precisa ser o aplicativo padrão para .kml.
CAPCAD_GEO_LINK_MAPS_URL Lê um link do Google Maps ou do Street View da área de transferência, projeta a coordenada para o sistema do desenho e desenha um POINT: CAPCAD_GIS_STREETVIEW (cor 150) para um link de Street View, CAPCAD_GIS_GMAPS (cor 30) para um link de mapa.
CAPCAD_GEO_LINK_WEBMAP Pergunta "Eixo ativo ou selecionar geometrias?", converte a geometria para WGS-84, transforma cada arco em 10 cordas, grava leaflet.html na pasta Exports do CapCad e o abre no navegador.
CAPCAD_GEO_STREETVIEW_IMAGE Dois cliques (bordo esquerdo → bordo direito) definem o azimute da visada; devolve o link da imagem estática do Street View naquele ponto e naquela direção. Na primeira vez pergunta se deve abrir no navegador ou só copiar, e lembra a resposta.
CAPCAD_GEO_IMAGERY_PICK Pergunta o tipo de mapa (Satellite, Roadmap, Terrain, Hybrid) e depois, em laço, insere a cada clique uma imagem de satélite georreferenciada. Esc encerra.
CAPCAD_GEO_IMAGERY_VIEW O mesmo, uma única imagem de satélite, no centro da vista atual, sem perguntar o tipo.
CAPCAD_GEO_IMAGERY_ALIGNMENT Enfileira imagens de satélite ao longo do eixo (ou de uma polyline escolhida), amostrado a cada 40 m; você informa a faixa de amostras a cobrir (1-250, por exemplo) e uma barra de progresso acompanha.
CAPCAD_GEO_HELP Só mostra um texto explicando as duas abordagens de imagem de fundo — a do Google Maps (a imagem é salva na pasta do projeto) e a do Bing Maps/AutoCAD (comando nativo, a usar apenas localmente e refazendo a cada mudança de tela).

Todas as imagens inseridas são baixadas para a pasta de exportações do projeto, anexadas como raster no layer CAPCAD_GEOIMAGE, centradas no ponto, dimensionadas pela escala do zoom 18 e enviadas para o fundo da ordem de exibição. O comando também zera a variável IMAGEFRAME, para a moldura da imagem não aparecer.

Fluxo de trabalho

Exportar a sinalização vertical para o Google Earth

  1. Rode CAPCAD_GEO_EXPORT. O formulário abre já na aba KMZ Vertical, com o nome do projeto na caixa 19.
  2. Marque as situações que devem entrar (20, 21, 22). Sem nenhuma marcada, o quadro Situação fica vermelho e uma mensagem pede que você escolha.
  3. Escolha como a placa aparece (23 a 25) e a escala do ícone (26).
  4. Decida o que fazer com placas sem imagem na biblioteca (27, 31 ou 32).
  5. Clique Gerar KMZ (33) e selecione as placas no desenho. Ao terminar, o caminho do arquivo aparece na caixa 38 e, se 36 estiver marcada, o KMZ abre.
  6. Se alguma placa não pôde ser exportada, um relatório de texto lista o handle, o nome e o motivo de cada uma.

Converter entidades em texto

  1. Aba KML, GPX, JSON, CAD. Deixe Entidades para texto (1) marcado e escolha o formato (3 a 8).
  2. Clique o botão de ação (12) e selecione no desenho. O formulário se esconde durante a seleção e volta com o texto na caixa 13.
  3. Trocar o formato depois disso reconverte a mesma seleção na hora.
  4. Salvar como… (17) grava em arquivo; Copiar para a área de transferência (18) copia.

Trazer texto para o desenho

  1. Marque Texto para entidades (2) e escolha o formato.
  2. Cole o texto na caixa 13 — ou clique um dos três exemplos (14, 15, 16), que já deixam tudo ajustado.
  3. Se quiser que um campo do GeoJSON vire nome de layer, escreva o nome dele na caixa 11.
  4. Marque Converter (9) se o texto está em latitude-longitude e precisa ser projetado; deixe desmarcado se as coordenadas já estão no sistema do desenho.
  5. Clique o botão de ação (12). O formulário continua aberto depois de desenhar.

O formulário

Os números são únicos nesta página: 1 a 18 na aba 1, 19 a 41 na aba 2, 42 na aba 3.

Aba 1: KML, GPX, JSON, CAD

Entidade para formato geo — KML, GPX, JSON, CAD

Aba 1 sem seleção: a caixa de conteúdo mostra "(no geometry selected)".

À esquerda, sob a lista de formatos, o formulário traz a nota verde "Nota: ao colar scripts no CAD, a entrada dinâmica deve estar desligada (DYNMODE=0)".

# Controle O que faz
1 Entidades para texto Sentido de exportação. A caixa 13 fica somente leitura e o botão 12 passa a pedir a seleção. Padrão.
2 Texto para entidades Sentido de importação. A caixa 13 fica editável e o botão 12 passa a interpretar o que estiver nela.
3 KML Exporta as polylines como LineString em WGS-84. Na importação, extrai as linhas do KML; pontos soltos não são importados aqui — o formulário informa quantos foram ignorados e aponta o conversor de arquivos GPS.
4 GPX Exporta como trilha. Na importação, o mesmo tratamento de pontos soltos.
5 GeoJSON Exporta como GeoJSON; com Converter marcado, as coordenadas saem em graus. Na importação, cada feição vira um elemento, e o campo nomeado em 11 vira o nome do layer.
6 EsriJSON O formato JSON dos serviços ArcGIS, nos dois sentidos.
7 CapJSON O formato próprio do CapCad, que preserva bulges e propriedades. Marcado por padrão.
8 Script CAD Só exporta: gera o texto de um script que redesenha a geometria. Importar não é possível — scripts se executam, não se interpretam; o formulário diz isso.
9 Converter Marcado, exportar converte do sistema da caixa 10 para graus, e importar converte de graus para o sistema do desenho. Desmarcado, as coordenadas passam como estão. Marcado por padrão.
10 sist. coord. Um item em branco e UTM-18 a UTM-25. É preenchido na abertura com o sistema do projeto/eixo e, na falta dele, com o último usado na sessão. Em branco, a importação detecta o fuso a partir das próprias coordenadas; a exportação, porém, cai num padrão fixo — ver Notas.
11 Propriedade GeoJSON para layer O nome do campo do GeoJSON cujo valor entra no nome do layer de cada feição (GIS_LINE_<campo>_<valor>, GIS_POLYGON_…, GIS_POINTS_…). Em branco, tudo vai para CAPCAD_GEO_IMPORT.
12 Botão de ação Executa o sentido escolhido em 1/2. Exportando, esconde o formulário, pede uma seleção sem filtro de tipo e volta com o texto. Importando, interpreta a caixa 13, converte se for o caso, desenha e mantém o formulário aberto.
13 Caixa de conteúdo O texto gerado ou a colar. Somente leitura no sentido de exportação. Sem seleção, mostra (no geometry selected).
14 Exemplo geojson pontos Marca Texto para entidades, desmarca Converter, escolhe GeoJSON, cola um exemplo de pontos e põe NOME na caixa 11.
15 Exemplo geojson polígonos O mesmo com um polígono, deixando a caixa 11 vazia.
16 Exemplo geojson linhas O mesmo com uma linha e NOME_LOGRAD na caixa 11.
17 Salvar como… Grava o conteúdo da caixa 13 em arquivo.
18 Copiar para a área de transferência Copia o conteúdo da caixa 13.

Na importação com Converter marcado, o fuso é decidido assim: um único fuso possível e nada escolhido em 10 → ele é adotado; um único fuso possível mas outro escolhido → a sua escolha vence; vários fusos possíveis e nada escolhido → o comando avisa e não importa. Junto com a geometria, entra a caixa envolvente do conjunto, no layer CAPCAD_GIS_OSM_OUTPUT_EXTENTS.

Aba 2: KMZ Vertical

Entidade para formato geo — KMZ Vertical

Aba 2, com os padrões: implantar, ícone + popup, escala 1.5, imagem genérica.

# Controle O que faz
19 Nome do arquivo O nome do KMZ, sem extensão. Vem preenchido com o nome do projeto. Caracteres inválidos de nome de arquivo são removidos; vazio, o comando recusa.
20 Implantar Inclui as placas a implantar. Marcada por padrão.
21 Manter Inclui as placas a manter.
22 Remover Inclui as placas a remover.
23 Ícone + popup Cada placemark recebe o ícone da placa e o balão com a imagem (largura fixa 300). Padrão.
24 Só ícone Só o ícone.
25 Só popup Só o balão.
26 Escala do ícone O multiplicador de tamanho do ícone no Google Earth. Padrão 1.5; a vírgula é aceita e trocada por ponto.
27 Plotar um do dwg da placa Placas sem imagem na biblioteca deveriam ter a imagem gerada a partir do dwg da placa. Ver Notas: hoje isto se comporta como Usar a imagem genérica.
28 ? (ao lado de 27) Mostra o aviso "Devido a limitações técnicas, placa terá uma tarja branca".
29 manter na biblioteca de placas (definitivo) Só é habilitada com 27 marcado: a imagem gerada ficaria guardada para reuso.
30 ? (ao lado de 29) Mostra "Salvo no mesmo caminho e com o mesmo nome do dwg da placa, e poderá ser reusado".
31 Usar a imagem genérica Placas sem imagem recebem generic.jpg. Padrão.
32 Pular a placa e listá-la no relatório Placas sem imagem não entram no KMZ e aparecem no relatório final.
33 Gerar KMZ Pede a seleção das placas (Select the signs to export), monta o KMZ e o grava na pasta Exports do CapCad. Sem nenhuma situação marcada (20-22), o quadro Situação fica vermelho e o comando não roda; sem projeto ativo, também não roda — e sem aviso.
34 Criar imagens de placa faltantes Ainda não disponível: mostra a mensagem de que a plotagem da imagem a partir do dwg da placa não foi implementada.
35 Abrir a pasta de placas propostas Abre no Explorer a pasta de placas propostas do projeto, quando ela está configurada.
36 Abrir o KMZ ao terminar Abre o arquivo gerado no aplicativo padrão. Marcada por padrão.
37 Mostrar na pasta Abre o Explorer com o arquivo selecionado.
38 Caminho do resultado Preenchida ao final com o caminho completo do KMZ (ou do KML, na aba 3). Somente informativa.
39 Mostrar Abre no Explorer o caminho da caixa 38.
40 Tutorial Abre o vídeo do CapCad sobre o KMZ.
41 Projeto de exemplo Pergunta antes, baixa o desenho e o eixo de exemplo do servidor CapCad, abre o desenho e aponta o projeto para a pasta de exportações.

O que o KMZ contém: uma pasta por situação (implantar / manter / remover), cada uma com um estilo próprio; um placemark por placa, com o nome da placa; a imagem de cada placa dentro do arquivo, na subpasta signs; e a altitude 10 para placas que pertencem a um conjunto, 1 para as demais. O arquivo é montado na pasta Exports\KML do CapCad, compactado e renomeado para .kmz. Essa pasta é apagada e recriada a cada geração — não guarde nada dentro dela.

Aba 3: KMZ Horizontal

Entidade para formato geo — KMZ Horizontal

Aba 3: um botão, e o texto que explica o fluxo.

# Controle O que faz
42 Gerar KML Esconde o formulário, pede a seleção das faixas, gera os traços com a cadência aplicada (o mesmo motor de transformação geométrica usado na sinalização horizontal), converte para WGS-84, grava <nome>-horizontal.kml na pasta de exportações e abre o arquivo. O nome vem da caixa 19 da aba 2; vazia, o arquivo se chama horizontal-horizontal.kml.

Repare: a saída desta aba é um KML, não um KMZ — nada de imagens para empacotar.

Como as opções se combinam

O link do Google Maps herda o zoom da vista do CAD, por degraus fixos sobre a altura da vista (variável VIEWSIZE):

Altura da vista (unidades de desenho) Zoom do link
menos de 33 20
33 a 75 19
75 a 100 18
100 a 250 17
250 a 1 500 16
1 500 a 3 000 15
3 000 a 6 000 14
6 000 a 12 000 13
12 000 a 24 000 12
24 000 a 48 000 11
48 000 a 64 000 9
64 000 a 128 000 8
128 000 a 256 000 7
256 000 a 512 000 6
512 000 a 1 024 000 5
1 024 000 a 2 048 000 4
2 048 000 a 4 096 000 3
4 096 000 ou mais 1

O zoom 10 nunca sai desta escada: os degraus se sobrepõem de tal forma que a faixa que o produziria é sempre reescrita por um degrau seguinte. É o comportamento herdado, e a diferença é imperceptível na prática.

As imagens de satélite, em contraste, usam sempre o zoom 18: 1 000 × 1 000 pixels, escala 0,345436287 unidades de desenho por pixel — ou seja, um quadrado de cerca de 345 m de lado, centrado no ponto. Isso vale para os três comandos de imagem.

Comando Destino O que fica no desenho
CAPCAD_GEO_LINK_MAPS google.com/maps/@<lat>,<lon>,<zoom>z nada
CAPCAD_GEO_LINK_STREETVIEW maps.google.com/maps?q=&layer=c&cbll=<lat>,<lon> POINT em CAPCAD_GIS_STREETVIEW
CAPCAD_GEO_STREETVIEW_IMAGE a imagem estática do Street View, com o azimute dos dois cliques nada
CAPCAD_GEO_LINK_EARTH Exports\temp.kml, aberto no aplicativo padrão nada
CAPCAD_GEO_LINK_MAPS_URL — (lê da área de transferência) POINT em CAPCAD_GIS_GMAPS ou CAPCAD_GIS_STREETVIEW
CAPCAD_GEO_LINK_WEBMAP Exports\leaflet.html, aberto no navegador nada
CAPCAD_GEO_IMAGERY_PICK / _VIEW / _ALIGNMENT raster em CAPCAD_GEOIMAGE, ao fundo

Todos os que abrem um endereço também copiam o link para a área de transferência.

Lembrado entre sessões

O formulário CAPCAD_GEO_EXPORT guarda quase tudo: os rádios de formato e de sentido, a caixa Converter, o sistema de coordenadas, a propriedade de layer e todas as opções da aba KMZ Vertical. Não são guardados o conteúdo da caixa de texto, o nome do KMZ e o caminho do resultado. Ao fechar, o sistema de coordenadas escolhido também vira o "último usado" da sessão, que os demais comandos GIS aproveitam.

CAPCAD_GEO_STREETVIEW_IMAGE guarda a resposta de "abrir no navegador ou só copiar" e não pergunta de novo. Os outros comandos de link não guardam nada.

Notas

  • Plotar um do dwg da placa ainda não gera imagem. A cadeia de plotagem da placa a partir do dwg não foi implementada, então a opção se comporta como Usar a imagem genérica, e o botão Criar imagens de placa faltantes apenas informa isso. O próprio formulário traz essa observação no rodapé da aba, em inglês.
  • O formulário abre na aba KMZ Vertical, não na primeira. É deliberado.
  • Nem tudo cai na mesma pasta. O KMZ Vertical e o leaflet.html do web map vão para a pasta Exports do CapCad (ao lado do arquivo de configuração); o KML Horizontal, o temp.kml do Google Earth e as imagens de satélite vão para a pasta de exportações do projeto, ou para a pasta temporária do Windows quando não há projeto. A caixa 38 sempre mostra o caminho completo do último resultado.
  • Vários textos da aba 1 e da aba 2 estão em inglês no formulário em português: o rótulo do botão de ação (Entities to text / Text to entities), o conteúdo inicial da caixa 13 ((no geometry selected)), o título do quadro When a sign has no image in the library e a nota do rodapé da aba KMZ Vertical. As mensagens de importação (Import, Could not parse input, No geometry parsed from the text) também.
  • Deixar a caixa sist. coord. em branco tem efeitos diferentes nos dois sentidos. Na importação, é o que arma a detecção automática do fuso. Na exportação, o vazio não é detectado: o formulário usa UTM-22 como recurso final, o que produz coordenadas erradas fora daquele fuso. Escolha o fuso antes de exportar.
  • A seleção acontece no clique do botão, não ao rodar o comando. Rodar CAPCAD_GEO_EXPORT de novo com o formulário aberto apenas o traz para a frente — não pede nova seleção. Isso vale hoje para o AutoCAD; nos outros quatro CADs o comando ainda pede a seleção logo no início, com filtro de tipo (polylines, linhas, arcos e círculos) e a opção de teclar Enter para só importar.
  • A aba KMZ Vertical só funciona no AutoCAD. Nos outros quatro CADs ela é desenhada, mas os botões não fazem nada: a exportação depende do inventário de placas, que hoje é do AutoCAD.
  • KML e GPX importam apenas linhas. Pontos soltos são contados e ignorados, com uma mensagem apontando o conversor de arquivos GPS (CAPCAD_GEO_CONVERT_DATA), que é quem importa pontos.
  • CAPCAD_GEO_LINK_MAPS_URL lê a área de transferência, não pede nada. Copie o link no navegador antes de rodar o comando; se o texto copiado não for um link do Google Maps ou do Street View, o comando mostra o que encontrou e encerra.
  • CAPCAD_GEO_LINK_WEBMAP não aceita pontos, só curvas: o mapa web de um ponto isolado não desenharia nada.
  • As imagens de satélite dependem da API do Google e de rede. Cada imagem é baixada como PNG para a pasta de exportações, com a latitude e a longitude no nome do arquivo; uma falha de download é informada na linha de comando e o laço continua.
  • CAPCAD_GEO_IMAGERY_ALIGNMENT amostra a cada 40 m e pergunta a faixa de amostras (inicial-final). Uma resposta sem hífen encerra o comando sem fazer nada. Como cada imagem cobre cerca de 345 m, a faixa completa de um eixo longo insere muitas imagens sobrepostas — informe uma faixa curta e repita.
  • CAPCAD_GEO_HELP está só em português — o texto não tem versão em outros idiomas, em nenhum perfil.
  • CAPCAD_GEO_STREETVIEW_IMAGE, CAPCAD_GEO_IMAGERY_VIEW e CAPCAD_GEO_IMAGERY_ALIGNMENT existem só no AutoCAD.