No Kerry Studio, o mapa nos resultados desenha a geometria que veio na grade, ao lado da tabela. Sem isso, um POLYGON ou um POINT em WKT fica só como texto na célula. O botão Mapa abre o recorte. O fundo usa OpenStreetMap.

Como utilizar

É preciso um workspace aberto, uma aba SQL conectada e um resultado com geometria. Sem coluna espacial e sem geometria nas células, o botão Mapa não aparece. Uma coluna de texto com WKT, EWKT ou GeoJSON já basta para o mapa. Uma coluna nativa (geometry, SDO_GEOMETRY, POINT e as demais) pede o suporte espacial do motor, descrito em Extensões por motor.

Execute um SELECT que devolva uma coluna espacial, WKT, EWKT ou GeoJSON.
No painel de resultados, clique em Mapa.
A grade e o mapa ficam juntos. Arraste o divisor se quiser mais espaço para o mapa. O ícone de expandir abre o mapa numa janela sobreposta. Fechar mapa devolve o espaço inteiro à grade.
Na célula da geometria, o botão Ver no mapa abre um mapa só daquele valor, como o botão de JSON. Esse mapa tem aproximar, afastar e ajustar visualização. Um clique no pino não fecha o mapa.
Ao lado de Aproximar e Afastar, Ajustar visualização enquadra todas as geometrias do resultado. Na primeira vez que o mapa abre no recorte, na janela sobreposta ou no mapa da célula, esse enquadramento já vem aplicado. Na janela sobreposta, a legenda fica maior.

A paleta (⌘K / CtrlK) → Alternar mapa dos resultados faz o mesmo. O recorte não abre sozinho. Se você deixar aberto, a aba lembra. Trocar de aba não leva o zoom junto.

Texto

A aba Texto mostra o WKT do que está selecionado no mapa: uma geometria do resultado ou um desenho. Sem seleção, ela pede para clicar. Um item sai só o WKT, pronto para colar. Um grupo juntado sai um WKT só da união. Vários itens saem em blocos com o nome da coluna ou Laço 1, Retângulo 1, Elipse 1. Shift, Ctrl ou ⌘ no ponteiro somam ou tiram um item, sem abrir o cartão e sem mover o mapa. Num MULTIPOLYGON, o clique pega só a ilha clicada e mostra um POLYGON. Clique no fundo do mapa limpa a seleção. Dá para selecionar o texto com o mouse ou com Shift e as setas. Dá para copiar, ou usar o botão de copiar. ⌘A ou CtrlA seleciona só esse WKT. O restante do mapa esmaece para o que você escolheu ficar visível. Se todos os itens estão escolhidos, nada esmaece. O pino escolhido ganha um contorno branco. Com mais de um item, o centro inferior do mapa mostra a quantidade.

Inverter lon/lat só muda o desenho. O valor na grade permanece o que o banco devolveu. O interruptor Rótulos na barra do mapa mostra o nome da coluna em cada geometria. Num grupo juntado, as áreas da mesma coluna mostram o nome uma vez na união. Os pinos continuam um a um. Ele começa desligado. No pino, o nome fica colado ao lado e não troca de lugar quando você aproxima. Na área, o nome fica colado por fora da linha, não por dentro. As cores acompanham o tema em uso. Se dois nomes ocupariam o mesmo lugar, o mapa mostra só o que cabe. Aproxime para ver o restante.

Desenho e SQL

Selecionar é a ferramenta padrão: clique no desenho ou na geometria para escolher, arraste o desenho para mover. O arraste não desloca o mapa. Clique e arraste no fundo do mapa para selecionar o desenho que o retângulo cruzar, não o espaço vazio ao redor. Shift, Ctrl ou ⌘ somam à seleção. ⌘A ou CtrlA seleciona todas as geometrias e os desenhos. Clique num desenho já fechado escolhe aquele item mesmo com laço, retângulo ou elipse ligados. Mão desloca o mapa. Depois de clicar no mapa, V, H, L, R e E escolhem Selecionar, Mão, Laço, Retângulo e Elipse. Esses atalhos não valem no editor SQL. Trocar de ferramenta no meio do traço cancela o traço atual e passa a desenhar na forma nova. Laço deixa você desenhar vários contornos livres. Retângulo e Elipse desenham ao arrastar. Shift no retângulo ou na elipse mantém os lados iguais. Cada soltar o mouse fecha um polígono e você pode desenhar o próximo. Apagar desenho tira os desenhos selecionados. Esc cancela o traço atual, depois a seleção, depois volta ao ponteiro, e só então fecha a janela sobreposta. Fechar essa janela ou o mapa sai do desenho e volta ao ponteiro. Os desenhos já fechados permanecem até uma consulta nova. Trocar de aba não apaga esses desenhos nem os modos da barra, como Medidas.

Colar polígono no SQL insere, no cursor do editor, o polígono selecionado, ou todos os desenhos se nenhum estiver selecionado. Um polígono vira POLYGON. Vários viram a união espacial do dialeto da aba. Um grupo juntado cola a união pintada no mapa, consulta e desenho juntos. Se essa união ficou em peças, o SQL traz essas peças. Medidas mostra o número de cada uma. Pino não entra nesse SQL. No PostgreSQL e no MySQL o Kerry cola ST_GeomFromText. No Oracle cola SDO_GEOMETRY. No SQLite cola GeomFromText. Esse SQL pede as funções espaciais do motor, as mesmas de Extensões por motor. O operador ST_Intersects continua sendo SQL do motor da aba. Esse botão cola só o polígono, sem a medida. Copiar polígono coloca na área de transferência o mesmo SQL. Sem polígono, os dois botões ficam inativos.

Juntar une a seleção em um grupo, pinta a união em verde e esvazia o preenchimento original. Medidas não precisa estar ligada. Cada desenho novo entra na seleção atual. Dá para juntar uma geometria da consulta com um desenho. Assim dá para desenhar dois e juntar sem mudar de ferramenta. Cada junção permanece até você escolher Separar. Dá para juntar dois itens, depois outros dois, sem desfazer o que já estava unido. Um clique num membro escolhe o grupo inteiro. Arrastar um membro move o grupo inteiro. Se a seleção for exatamente um grupo, o botão vira Separar. Se você selecionar dois grupos e juntar, eles viram um só. G junta. ShiftG separa. Sem dois ou mais itens escolhidos, o botão não junta nada. Se as áreas não se encontram, a união continua em peças separadas. ⌘Z ou CtrlZ desfaz criar, mover, apagar e juntar ou separar. ⌘ShiftZ ou CtrlShiftZ refaz. A barra também tem Desfazer e Refazer. Sem o que desfazer ou refazer, esses botões ficam inativos.

Medidas

Medidas na barra do mapa mostra o tamanho de cada polígono, na unidade escolhida: m², ha ou km². O número na legenda, no chip da seleção e no rótulo do polígono traz essa unidade. Num MULTIPOLYGON, cada ilha ganha o próprio número no mapa. A conta usa as coordenadas da célula, ou o lon/lat do desenho. Liga também o total da coluna. Cópias iguais do mesmo polígono, como as que um JOIN empilha, entram uma vez só nesse total. Com um grupo juntado, o rótulo verde da união e a linha Junções da legenda mostram o mesmo total. O chip da seleção também mostra só a união. Sem o Juntar, dois itens selecionados mostram o total e a sobreposição. Se o sistema de coordenadas não permitir essa conta, o polígono continua no mapa e o número não aparece. Ponto e linha ficam de fora. Uma consulta nova zera os desenhos e a medida deles some junto. A unidade escolhida permanece enquanto o mapa está aberto. Trocar de aba não desliga Medidas.

Colunas no mapa

Cada coluna de geometria no resultado ganha uma cor. Ponto e área usam paletas diferentes. O ponto usa o pino de mapa da interface. A legenda usa o nome da coluna, ou o alias se o SELECT tiver um. Se o SELECT tiver i.localizacao AS moradia e z.geom AS inundacao, a legenda mostra moradia e inundacao. O JOIN continua no SQL. O mapa só pinta o que já veio no resultado. Um clique no pino abre um cartão com o nome dessa coluna no título e os outros valores da linha (texto, número, data). A geometria não entra no cartão. Se o resultado só tem áreas, o clique na área abre o cartão. Com pinos e áreas juntos, a área não abre o cartão, para não misturar linhas do mesmo JOIN.

Camadas, imagem e impressão

O fundo padrão é OpenStreetMap. O seletor de fundo só aparece quando você acrescenta outra camada em Configurações, em Camadas de mapa, com um endereço HTTPS de tiles {z}/{x}/{y}. Se o fundo falhar, os polígonos continuam no fundo neutro.

O menu Exportar mapa abre PNG, SVG, WebP e GeoJSON. PNG, SVG e WebP gravam o mapa das geometrias do resultado, com o fundo de ruas, no tamanho do conteúdo. O recorte na tela não define o arquivo. O interruptor Rótulos vem ligado e escreve o nome da coluna (ou o alias do SELECT) no mesmo lugar que o mapa: por fora da linha de cada área e ao lado de cada pino. O mesmo menu tem Tema da Imagem, com Escuro e Claro. As cores dos nomes e da legenda acompanham esse tema. O mesmo menu traz Medidas, o seletor de unidade (m², ha ou km²) e Junções. Eles valem só para o arquivo. Dá para exportar com os números sem ligar Medidas na barra. Com Medidas ligado nesse menu, o arquivo traz os números de área, a sobreposição pintada e os totais na legenda. Com Junções ligado, as uniões que você já fez no mapa entram no arquivo como agrupadas. Se a união for de áreas da mesma coluna, o arquivo mostra um só nome na união. Os pinos continuam um a um. Junções no arquivo não exige Medidas nesse menu. Se houver desenho no mapa, o interruptor Desenhos também vem ligado e desenha esses polígonos no arquivo. Dá para desligar se quiser só as geometrias da consulta. GeoJSON grava as geometrias do mapa, sem o fundo de ruas. A consulta entra sempre. Desenhos e junções entram se os interruptores estiverem ligados. Com Medidas ligado, cada geometria traz a área. Com Rótulos ligado, entra o nome da coluna. Se uma junção ficou em peças, o arquivo traz essas peças. Imprimir usa os mesmos interruptores e o tema da imagem. Os créditos do fundo de ruas ficam como no mapa. PNG e WebP são raster em alta resolução. SVG coloca o fundo de ruas em alta resolução e as geometrias em vetor. Imprimir abre o diálogo de impressão desse mapa com o fundo.

Extensões por motor

Os tipos nativos no criar tabela e no alterar tabela, e o SQL colado com ST_GeomFromText, SDO_GEOMETRY ou GeomFromText, pedem o suporte espacial do motor. O Kerry não instala essa extensão por você. O mapa continua desenhando WKT, EWKT e GeoJSON que já vieram na célula.

PostgreSQL. Pede a extensão PostGIS. Sem ela, GEOMETRY e GEOGRAPHY aparecem no criar tabela e no alterar tabela, e o Kerry avisa que o tipo pede PostGIS. No próprio PostgreSQL, CREATE EXTENSION postgis instala o PostGIS no banco.

MySQL e MariaDB. Os tipos espaciais são nativos (GEOMETRY, POINT, POLYGON e os demais). Não há extensão extra.

Oracle. Pede Locator ou Spatial. Sem o tipo SDO_GEOMETRY no banco, o Kerry avisa no criar tabela e no alterar tabela. Com o suporte, a coluna é SDO_GEOMETRY.

SQLite. Pede SpatiaLite. Na conexão SQLite, em Extensões, acrescente o arquivo da extensão e ligue Carregar ao conectar. Enquanto o SpatiaLite não carregar, os tipos espaciais não entram na lista. Com ele carregado, aparecem GEOMETRY, POINT, POLYGON e os demais tipos do SpatiaLite.

Detalhes

O mapa não é um terceiro modo de ver o resultado. Ele divide o painel com a grade.
O desenho segue o WKT da célula. Um POLYGON de quatro cantos aparece como retângulo, porque é isso que o valor descreve. Um MULTIPOLYGON com muitos vértices aparece com o contorno irregular desses vértices.
O tipo no tooltip da coluna é o tipo do catálogo. Um ponto PostGIS aparece como geometry(Point,4326), não só geometry. O ícone espacial vale para qualquer um desses tipos.
Funciona nos quatro motores da aba: PostgreSQL, MySQL/MariaDB, Oracle e SQLite.
Uma consulta com @projeto.tabela de outro projeto materializa as linhas na conexão da aba. Se esse destino tiver GIS, a temporária usa o tipo espacial nativo. Se não tiver, a geometria vai como texto EWKT.