Visualização de mapa
funcionalColoque respostas GEO do Redis, colunas de longitude/latitude, e formas WKT ou WKB em um mapa de ruas do OpenStreetMap que você pode mover, ampliar e clicar até a linha correspondente.
Quando um resultado tem localizações, um Redis GEOSEARCH resposta, uma tabela com colunas de longitude e latitude ou uma coluna de formas espaciais - o SQLly pode desenhá-los em um mapa de ruas que você pode arrastar e ampliar. Passe o mouse sobre um ponto para ver a qual linha ele corresponde, clique nele para ir até essa linha na grade e alterne para um mapa de calor
quando houver pontos demais para ler um por um.


Abrindo um mapa
- A partir da grade de resultados. Clique com o botão direito em qualquer célula e escolha Ferramentas › Mostrar no Mapa…. Todo o conjunto de resultados abre em sua própria janela de mapa, para que você possa mantê-lo ao lado da grade enquanto trabalha.
- Automaticamente. A
-- sqlly map:linha comopen=auto, ou-- sqlly view: mapcomo a primeira linha da consulta, abre o mapa toda vez que a consulta termina. - A partir de um único valor de geometria. Clique com o botão direito em uma célula que contém uma forma e escolha Visualizar Geometria… (ou selecione-a com o painel Painel Detalhes da célula aberto). A barra de ferramentas do visualizador tem um Esboço / Mapa / Bruto seletor; Mapa coloca essa forma única no mapa de ruas.
O que pode ser mapeado
Respostas GEO do Redis
GEOSEARCH, GEORADIUS, GEORADIUSBYMEMBER, e
GEOPOS retornam como uma grade com member, dist,
lon, e lat colunas quando você solicita coordenadas. Adicione
WITHCOORD para que a resposta as contenha:
GEOSEARCH stores FROMLONLAT -0.1278 51.5074 BYRADIUS 50 km WITHCOORD WITHDIST ASC
Cada membro se torna um ponto, rotulado com seu nome. Campos geo-shape das respostas de busca do Redis (FT.SEARCH sobre uma GEOSHAPE campo) chegam como well-known text e são mapeados como qualquer outra coluna de geometria.


Colunas de longitude e latitude
Qualquer resultado com uma coluna de longitude e uma coluna de latitude pode ser mapeado. O SQLly as encontra pelo nome, ignorando maiúsculas e minúsculas, observando as palavras no nome da coluna:
- Longitude - uma palavra
lon,lng,long, oulongitude:lon,LNG,pickup_lon,StartLongitude. - Latitude - uma palavra
latoulatitude:lat,dropoff_lat,EndLatitude.
As palavras são divididas em underscores, espaços, pontos, hífens e letras maiúsculas, então
latency, plate, ou longest nunca são confundidas com coordenadas. Os valores podem ser números ou texto numérico. Linhas com valor ausente, ou uma longitude fora de -180 a 180 ou latitude fora de -90 a 90, são deixadas de fora do mapa e contadas na barra de ferramentas como linhas sem localização.
Quando há mais de um par - digamos pickup_lon/pickup_lat
e dropoff_lon/dropoff_lat - colunas que compartilham o restante de seu nome são emparelhadas, e o mapa abre com seu Opções painel mostrando, onde o Localizações seletor alterna entre eles (ou escreva lat= e
lon= em um diretiva de mapa). Se nada for emparelhado pelo nome, toda combinação de longitude/latitude é oferecida.
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
Colunas de geometria (WKT e WKB)
Uma coluna cujos valores são formas espaciais também é mapeada: pontos, linhas, polígonos (com buracos), as formas multi- correspondentes e coleções de geometria. O SQLly lê:
- Texto bem conhecido - opcionalmente com um prefixo SRID:
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - Binário bem conhecido - como bytes ou como texto hexadecimal, que é como o PostGIS retorna uma
geometrycoluna por padrão - incluindo a forma estendida que carrega um SRID, e o próprio formato de valor espacial do MySQL.
Uma coluna conta como geometria quando seu tipo é espacial (geometry,
geography, point, e assim por diante) e quando pelo menos um dos primeiros 20 valores não NULL dela é interpretado, ou quando todos os primeiros 20 valores não NULL dela são interpretados, seja qual for o tipo. Uma forma multiparte é desenhada como suas partes, todas rotuladas com a mesma linha. Os bytes nativos do SQL Server geometry/geography não são binários conhecidos, então selecione shape.STAsText() ou shape.STAsBinary() em vez da coluna bruta.
SELECT name, boundary.STAsText() AS boundary FROM dbo.DeliveryZones;


SRID=27700 - continuam desenhadas, dá para arrastar e dar zoom, mas como um esboço sem o mapa de ruas, com uma nota indicando o SRID. O SQLly não as reprojeta; transforme-as na consulta (por exemplo ST_Transform(geom, 4326) no PostGIS) para vê-las no mapa.Tiles do mapa de ruas do OpenStreetMap
O mapa de ruas é composto de tiles de imagem do projeto OpenStreetMap, baixados de
tile.openstreetmap.org. O SQLly não contata o servidor de tiles até você autorizar.
- A pergunta é feita uma só vez. Na primeira vez que um mapa é aberto, um aviso explica o que será baixado. Carregar tiles do mapa liga os blocos de mapa; Agora não, usar um esboço mantém-nos desativados. Qualquer uma das respostas é memorizada.
- Apenas imagens do mapa são baixadas. As solicitações pedem apenas os tiles do mapa que cobrem a área visível na tela, nada mais. Seus resultados de consulta, nomes de colunas e coordenadas nunca são enviados para lugar algum.
- Download educado. No máximo dois mosaicos são baixados por vez, e apenas da parte do mapa que você está vendo (nada é buscado à sua frente), e as solicitações se identificam como SQLly com a versão do app, como pede a política de uso de mosaicos do OpenStreetMap.
- Atribuição. Enquanto os tiles do mapa estão sendo exibidos, © Colaboradores do OpenStreetMap fica no canto inferior direito do mapa; clique nele para abrir a página de direitos autorais e licença do OpenStreetMap.
- Ativar ou desativar os tiles do mapa mais tarde. Use Configurações › Resultados › Geral › Mapas › Carregar tiles do mapa de ruas do OpenStreetMap, ou a Ativar tiles do mapa botão na barra de notas do mapa após recusar.


O cache de tiles
Cada tile do mapa é salvo no seu computador e reutilizado por 14 dias antes de ser baixado de novo, então revisitar uma área não custa nada e o servidor de tiles não é consultado duas vezes. Os tiles ficam em uma
map-tiles pasta na pasta de dados do SQLly:
| Plataforma | Pasta |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/map-tiles |
| Janelas | %APPDATA%\SQLLY\map-tiles |
| Linux | ~/.local/share/SQLLY/map-tiles |
É seguro excluir a pasta a qualquer momento; os tiles são buscados de novo conforme você precisar.
Sem tiles: o esboço
Se você recusar os tiles, estiver offline ou estiver usando o SQLly no navegador, o mapa ainda funciona: os mesmos pontos, linhas e polígonos são desenhados em um fundo simples, com uma grade leve de 30° de meridianos e paralelos, e pan, zoom, ajuste, hover, clique e o mapa de calor se comportam da mesma forma. Uma nota abaixo da barra de ferramentas explica por que não há mapa de ruas. Quando um download falha porque o servidor de tiles não pode ser alcançado, o SQLly para de pedir, usa os tiles que já tem em cache e oferece Tentar novamente.


O painel de Opções
Clique Opções à direita da barra de ferramentas do mapa para abrir um painel com todas as configurações que o mapa possui. Cada alteração redesenha o mapa imediatamente.
- Dados - Localizações (Auto, ou um dos pares de longitude/latitude detectados e colunas de geometria), Rótulo (o título ao passar o mouse), Colunas de tooltip (linhas extras na dica de ferramenta ao passar o mouse), Cor por (uma paleta para texto, um gradiente para números, com uma legenda embaixo), e Tamanho por (marcadores maiores para números maiores).
- Camadas - Mostrar pontos, um mapa de calor, ou ambos; Agrupamento de marcadores agrupa marcadores que se aglomeram em um círculo (passe o mouse para ver a contagem, clique para ampliar); e, para o mapa de calor, peso, raio, desfoque, intensidade, opacidade e paleta.
- Mapa - Mapa de ruas ligado ou desligado para este resultado, o que clicando em um recurso faz, se o mapa abre ao executar, o máximo de elementos para desenhar, e o visualização inicial (ajustar aos dados, ou lembrar a visualização que você está vendo agora).
- Diretiva - o
-- sqlly map:linha que essas configurações fazem. Copiar coloca na área de transferência; Gravar na Consulta escreve isso no bloco de locks da consulta, para que o mapa volte da mesma forma em cada execução, para qualquer pessoa que abrir o arquivo.


Movendo-se pelo mapa
| Para | Faça o seguinte |
|---|---|
| Mover (Pan) | Arraste o mapa. Ele contorna o globo na horizontal, então você pode continuar arrastando para além da linha de data. |
| Zoom | Role a roda do mouse ou faça um gesto de pinça em um trackpad - o ponto sob o ponteiro permanece no lugar - ou use os − e + botões, que dão zoom em um nível ao redor do centro. Mapas de ruas vão do mundo inteiro (nível 0) ao nível de rua (nível 19). |
| Ver tudo | Ajustar dá zoom para que cada elemento plotado fique visível. Um mapa é aberto ajustado. Dados de ambos os lados da linha de data são enquadrados da forma mais curta através dela. |
| Identificar um recurso | Passe o cursor sobre ele. A dica de ferramenta mostra o nome da linha: um Redis member, ou uma coluna chamada key, name, label, title, ou id, senão a primeira coluna de texto; caso contrário, o número da linha. |
| Localize a linha correspondente | Clique nela. O elemento é destacado e a linha é selecionada e rolada para a visualização na grade de onde o mapa veio (desative isso com Clique em um elemento no painel de Opções, ou click=none). |
| Abrir um cluster | Com Agrupamento de marcadores ligado, marcadores agrupados se tornam um círculo; passe o mouse sobre ele para ver quantos locais ele contém, clique nele para ampliar até que se separe. |
Clicar seleciona linhas da grade para resultados abertos com Mostrar no Mapa; um mapa aberto pela aba Pivot ou a partir de um único valor no visualizador não tem linhas para selecionar. Para um resultado muito grande cujas linhas são paginadas do disco, um clique seleciona a linha apenas enquanto aquela parte do resultado estiver carregada na grade.
Resultados muito grandes
Um mapa desenha no máximo 50.000 recursos (menos se você definir Máximo de elementos no painel de Opções, ou limit=). Passado isso, os primeiros 50.000 são desenhados e a barra de ferramentas avisa Exibindo 50.000 de N feições, então você sempre sabe quando falta parte dos dados. Cada parte de uma forma multiparte conta como um elemento. O mapa lê as linhas que a grade tem na memória, então, para um resultado grande demais para segurar, filtre ou amostre na consulta, ou agregue, quando precisar do quadro completo.
Diretiva de mapa
A -- sqlly map: comentário na consulta define como seu resultado é mapeado, da mesma forma grid: define a grade. É o que o botão do painel de Opções Gravar na Consulta grava, e cada configuração abaixo também pode ser alterada a partir do painel.
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
As configurações são key=value, separadas por ;, em qualquer ordem. Sem um número, a linha se aplica a todos os conjuntos de resultados da execução; map 2: aplica-se apenas ao segundo, contando a partir de 1. Quando várias linhas se aplicam, as configurações posteriores substituem as anteriores. Os nomes das colunas correspondem sem diferenciar maiúsculas de minúsculas, e são escritos entre aspas duplas quando contêm um espaço ou qualquer um dos , ; : = " | (duplique a aspa dentro dela).
| Configuração | Significado | Exemplo |
|---|---|---|
lat=col; lon=col | As colunas de latitude e longitude. Substitui a detecção pelo nome; ambas são necessárias. | lat=y; lon=x |
geom=col | Uma coluna de geometria em well-known text ou binário. Substitui a detecção. | geom=boundary |
srid=n | O sistema de coordenadas dos dados. Qualquer valor diferente de 4326 é desenhado como um esboço sem o mapa de ruas. | srid=27700 |
label=col | O título ao passar o mouse. Padrão: member, key, name, label, title, id, ou a primeira coluna de texto. | label=store_name |
tooltip=a, b | Extra column: value linhas na dica de ferramenta ao passar o mouse. | tooltip=city, revenue |
mode=points|heatmap|both | Marcadores, um mapa de calor, ou o mapa de calor com marcadores por cima. Linhas e polígonos são sempre desenhados. | mode=both |
color=col | Colorir marcadores e formas por uma coluna: até 12 cores para valores de texto (o restante compartilha uma), um gradiente para números. | color=region |
size=col | Dimensionar o tamanho do marcador por uma coluna numérica, do menor para o maior valor. | size=revenue |
weight=col | Ponderar o calor de cada local por uma coluna numérica (NULL e valores negativos contam como 0). | weight=orders |
radius=px | Até onde o calor de cada local se espalha: de 6 a 120 pixels de tela (padrão 24). | radius=30 |
blur=px | Suavização extra do calor, de 0 a 200 pixels (padrão 0). | blur=12 |
intensity=n | Reforça o calor fraco em direção ao lado quente, de 0 a 10 (padrão 1). | intensity=2 |
opacity=n | Opacidade máxima da camada de calor, de 0 a 1 (padrão 0,8). | opacity=0.6 |
palette=name | Cores do calor: heat (azul a vermelho, padrão), fire, viridis (compatível com daltonismo), ocean, ou accent (a cor de destaque do seu tema). | palette=viridis |
cluster=on|off | Agrupar marcadores muito próximos em círculos com contagem. | cluster=on |
basemap=osm|none | O mapa de ruas do OpenStreetMap, ou nenhum para este resultado. osm nunca baixa tiles que você não autorizou. | basemap=none |
center=lat,lon; zoom=n | A visualização inicial; zoom de 0 (mundo) a 19 (rua). | center=51.5,-0.12; zoom=10 |
fit=data | Começar enquadrado em cada feição (o padrão; substitui o centro e o zoom). | fit=data |
limit=n | Máximo de elementos a desenhar; qualquer valor acima de 50.000 conta como 50.000. | limit=5000 |
click=select|none | Se clicar em um recurso seleciona sua linha na grade (padrão select). | click=none |
open=auto|manual | Abrir o mapa automaticamente toda vez que a consulta terminar, ou apenas a partir Mostrar no Mapa… (padrão). | open=auto |
-- sqlly view: map como a primeira linha da consulta é um atalho para
open=auto no primeiro resultado: a grade abre normalmente e a janela do mapa abre ao lado. Quando um mapa para o resultado já está aberto, uma nova execução atualiza essa janela em vez de abrir outra.
Uma configuração com o nome errado ou um valor inválido é sublinhada no editor com o motivo (por exemplo Diretiva de mapa: configuração desconhecida «colour»); as outras configurações da linha continuam valendo e a consulta roda normalmente. Uma coluna que o resultado não tem é pulada, e a janela do mapa diz quais foram puladas.
Exemplos
Armazena como pontos, rotulados, com a cidade no tooltip:
-- sqlly map: lat=latitude; lon=longitude; label=store_name; tooltip=city
SELECT store_name, city, latitude, longitude FROM stores;
Um mapa de calor de pedidos, ponderado pelo número de pedidos:
-- sqlly map: mode=heatmap; weight=orders; radius=30; palette=fire
SELECT postcode_lat AS lat, postcode_lon AS lon, COUNT(*) AS orders
FROM orders GROUP BY postcode_lat, postcode_lon;
Marcadores coloridos, dimensionados e agrupados para o segundo resultado, abertos a cada execução:
-- sqlly map 2: color=region; size=revenue; cluster=on; open=auto
SELECT COUNT(*) FROM branches;
SELECT branch, region, revenue, lat, lon FROM branches;
Um Redis GEOSEARCH, aberto automaticamente no mapa:
-- sqlly view: map
-- sqlly map: tooltip=dist; zoom=8; center=51.5074,-0.1278
GEOSEARCH stores FROMLONLAT -0.1278 51.5074 BYRADIUS 50 km WITHCOORD WITHDIST ASC
Formas projetadas, desenhadas como um esboço:
-- sqlly map: geom=boundary; srid=27700; basemap=none
SELECT name, ST_AsText(boundary) AS boundary FROM parishes;
No navegador
O versão do navegador do SQLly nunca baixa tiles de mapa. Mostrar no Mapa e o modo Mapa do visualizador abrem o esboço diretamente, sem prompt, com uma nota de que os tiles não estão disponíveis no navegador.