Vista de mapa
funcionalColoca respuestas GEO de Redis, columnas de longitud/latitud y formas WKT o WKB en un mapa de calles de OpenStreetMap donde puedas desplazarte, hacer zoom y hacer clic para ir a la fila.
Cuando un resultado tiene ubicaciones, un Redis GEOSEARCH respuesta, una tabla con columnas de longitud y latitud, o una columna de formas espaciales: SQLly puede dibujarlas en un mapa callejero que puedes desplazar y ampliar. Pasa el cursor sobre un punto para ver qué fila es, haz clic en él para saltar a esa fila en la cuadrícula, y cambia a un mapa de calor
cuando hay demasiados puntos para leer uno por uno.


Abrir un mapa
- Desde la cuadrícula de resultados. Haz clic derecho en cualquier celda y elige Herramientas › Mostrar en el mapa…. Todo el conjunto de resultados se abre en su propia ventana de mapa, para que puedas tenerlo al lado de la cuadrícula mientras trabajas.
- Automáticamente. A
-- sqlly map:línea conopen=auto, o-- sqlly view: mapcomo primera línea de la consulta, abre el mapa cada vez que la consulta termina. - A partir de un solo valor de geometría. Haz clic derecho en una celda con una forma y elige Ver geometría… (o selecciónala con el panel Panel de detalles de celda abierto). La barra de herramientas del visor tiene un Boceto / Mapa / En bruto interruptor; Mapa coloca esa única forma sobre el mapa de calles.
Qué se puede mapear
Respuestas GEO de Redis
GEOSEARCH, GEORADIUS, GEORADIUSBYMEMBER, y
GEOPOS regresan como una cuadrícula con member, dist,
lon, y lat columnas cuando pides coordenadas. Añade
WITHCOORD para que la respuesta las incluya:
GEOSEARCH stores FROMLONLAT -0.1278 51.5074 BYRADIUS 50 km WITHCOORD WITHDIST ASC
Cada miembro se convierte en un punto, etiquetado con su nombre. Los campos geoshape de las respuestas de búsqueda de Redis (FT.SEARCH sobre una GEOSHAPE campo) llegan como texto bien conocido y se mapean como cualquier otra columna de geometría.


Columnas de longitud y latitud
Cualquier resultado con una columna de longitud y una columna de latitud se puede mapear. SQLly las encuentra por nombre, sin distinguir entre mayúsculas y minúsculas, buscando las palabras en el nombre de la columna:
- Longitud - una palabra
lon,lng,long, olongitude:lon,LNG,pickup_lon,StartLongitude. - Latitud - una palabra
latolatitude:lat,dropoff_lat,EndLatitude.
Las palabras se dividen por guiones bajos, espacios, puntos, guiones y mayúsculas, así que
latency, plate, o longest nunca se confunden con coordenadas. Los valores pueden ser números o texto numérico. Las filas a las que les falta un valor, o con una longitud fuera de -180 a 180 o una latitud fuera de -90 a 90, se dejan fuera del mapa y se cuentan en la barra de herramientas como filas sin ubicación.
Cuando hay más de un par - digamos pickup_lon/pickup_lat
y dropoff_lon/dropoff_lat - las columnas que comparten el resto de su nombre se emparejan, y el mapa se abre con su Opciones mostrando, donde el Ubicaciones cambia entre ellos (o escribe lat= y
lon= en un directiva de mapa). Si nada se empareja por nombre, se ofrecen todas las combinaciones de longitud/latitud.
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
Columnas de geometría (WKT y WKB)
También se mapea una columna cuyos valores son formas espaciales: puntos, líneas, polígonos (incluidos agujeros), sus formas múltiples y colecciones de geometría. SQLly lee:
- Texto bien conocido - opcionalmente con un prefijo SRID:
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - Binario bien conocido - como bytes o como texto hexadecimal, que es como PostGIS devuelve una
geometrycolumna por defecto - incluida la forma extendida que lleva un SRID, y el formato de valor espacial propio de MySQL.
Una columna se considera geometría cuando su tipo es espacial (geometry,
geography, point, y así sucesivamente) y al menos uno de sus primeros 20 valores no NULL se analiza correctamente, o cuando todos sus primeros 20 valores no NULL se analizan correctamente sin importar el tipo. Una forma de múltiples partes se dibuja como sus partes, todas etiquetadas con la misma fila. Los nativos de SQL Server geometry/geography no son un binario bien conocido, así que selecciona shape.STAsText() o shape.STAsBinary() en lugar de la columna sin formato.
SELECT name, boundary.STAsText() AS boundary FROM dbo.DeliveryZones;


SRID=27700 - todavía se dibujan, se pueden desplazar y hacer zoom, pero como un boceto sin el mapa de calles, con una nota que indique el SRID. SQLly no las reproyecta; transfórmalas en la consulta (por ejemplo ST_Transform(geom, 4326) en PostGIS) para verlas en el mapa.Mosaicos del mapa de calles de OpenStreetMap
El mapa de calles está hecho de mosaicos de imágenes del proyecto OpenStreetMap, descargados desde
tile.openstreetmap.org. SQLly no contacta con el servidor de mosaicos hasta que lo pides.
- Se te pregunta una sola vez. La primera vez que abres un mapa, un aviso explica qué se descargaría. Cargar mosaicos del mapa activa los mosaicos; Ahora no, usar un boceto los mantiene desactivados. Cualquiera de las dos respuestas se recuerda.
- Solo se obtienen imágenes del mapa. Las solicitudes piden solo los mosaicos que cubren el área visible, nada más. Tus resultados de consulta, nombres de columnas y coordenadas nunca se envían a ningún lugar.
- Descarga cortés. Como máximo se descargan dos mosaicos a la vez, y solo de la zona del mapa que estás viendo (no se pide nada por adelantado); las peticiones se identifican como SQLly con su versión, como pide la política de uso de mosaicos de OpenStreetMap.
- Atribución. Mientras se muestran las teselas, © colaboradores de OpenStreetMap se encuentra en la esquina inferior derecha del mapa; haz clic en él para abrir la página de derechos de autor y licencia de OpenStreetMap.
- Activar o desactivar los mosaicos más adelante. Usar Ajustes › Resultados › General › Mapas › Cargar mosaicos de mapas callejeros de OpenStreetMap, o en la configuración Activar los mosaicos del mapa botón en la barra de notas del mapa después de rechazarlo.


La caché de teselas
Cada tesela se guarda en tu computadora y se reutiliza durante 14 días antes de descargarse otra vez, así que revisitar una zona no cuesta nada y el servidor de teselas no recibe la petición dos veces. Las teselas viven en un
map-tiles carpeta dentro de la carpeta de datos de SQLly:
| Plataforma | Carpeta |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/map-tiles |
| Windows | %APPDATA%\SQLLY\map-tiles |
| Linux | ~/.local/share/SQLLY/map-tiles |
Puedes eliminar la carpeta en cualquier momento; las teselas se vuelven a descargar cuando hacen falta.
Sin teselas: el boceto
Si rechazas los mosaicos, no tienes conexión o usas SQLly en el navegador, el mapa sigue funcionando: los mismos puntos, líneas y polígonos se dibujan sobre un fondo sencillo con una cuadrícula ligera de meridianos y paralelos cada 30°, y desplazar, hacer zoom, ajustar, pasar el ratón, hacer clic y el mapa de calor funcionan igual. Una nota bajo la barra de herramientas explica por qué no hay mapa de calles. Si una descarga falla porque no se puede acceder al servidor de mosaicos, SQLly deja de intentarlo, usa los mosaicos que ya tenga en caché y ofrece Reintentar.


El panel de Opciones
Haz clic Opciones a la derecha de la barra de herramientas del mapa para abrir un panel con todos los ajustes que tiene. Cada cambio redibuja el mapa al instante.
- Datos - Ubicaciones (Auto, o uno de los pares de longitud/latitud detectados y las columnas de geometría), Etiqueta (el título al pasar el cursor), Columnas de las descripciones emergentes (líneas adicionales en el tooltip al pasar el cursor), Colorear por (una paleta para el texto, un degradado para los números, con una leyenda debajo), y Tamaño por (marcadores más grandes para números más grandes).
- Capas - Mostrar puntos, un mapa de calor, o ambos; Agrupar marcadores agrupa marcadores que se amontonan unos sobre otros en un círculo (pasa el cursor para ver la cantidad, haz clic para acercar); y, para el mapa de calor, peso, radio, desenfoque, intensidad, opacidad y paleta.
- Mapa - Mapa de calles activado o desactivado para este resultado, qué hacer clic lo que hace una característica, si el mapa se abre al ejecutar, el la mayoría de las características para dibujar, y el vista inicial (adaptada a los datos, o que recuerde la vista que estás viendo ahora).
- Directiva - la
-- sqlly map:línea que estas configuraciones generan. Copiar lo copia al portapapeles; Escribir en la consulta lo escribe en el bloque de bloqueo de la consulta, así que el mapa vuelve igual en cada ejecución, para cualquiera que abra el archivo.


Desplazarse
| A | Haz esto |
|---|---|
| Desplazarse | Arrastra el mapa. Da la vuelta al globo en horizontal, así que puedes seguir arrastrando más allá de la línea de cambio de fecha. |
| Zoom | Gira la rueda del ratón o pellizca en el trackpad - el punto bajo el puntero se queda fijo - o usa el − y + botones, que hacen zoom un nivel alrededor del centro. Los mapas de calles van desde todo el mundo (nivel 0) hasta el nivel de calles (nivel 19). |
| Ver todo | Ajustar hace zoom para que cada elemento representado esté a la vista. El mapa se abre ya ajustado. Los datos a ambos lados de la línea internacional de cambio de fecha se enmarcan por el camino más corto. |
| Identificar una característica | Pasa el cursor sobre ella. La información sobre herramientas muestra el nombre de la fila: un Redis member, o una columna llamada key, name, label, title, o id, de lo contrario, la primera columna de texto; si esto falla, el número de fila. |
| Encontrar su fila | Haz clic en ella. La característica se resalta y la fila se selecciona y se desplaza hasta quedar a la vista en la cuadrícula de donde salió el mapa (desactívalo con Haz clic en una característica en el panel de Opciones, o click=none). |
| Abrir un clúster | Con Agrupar marcadores activado, los marcadores agrupados se convierten en un solo círculo; pasa el cursor por encima para ver cuántas ubicaciones agrupa y haz clic para hacer zoom hasta que se separe. |
Hacer clic selecciona filas de la cuadrícula en los resultados abiertos con Mostrar en el Mapa; un mapa abierto desde la pestaña de Tabla Dinámica o desde un valor suelto en el visor no tiene filas que seleccionar. En un resultado muy grande cuyas filas se cargan por páginas desde el disco, un clic solo selecciona la fila mientras esa parte del resultado esté cargada en la cuadrícula.
Resultados muy grandes
Un mapa dibuja como máximo 50.000 características (menos si configuras Máximo de elementos en el panel de Opciones, o limit=). Pasado ese límite, se dibujan los primeros 50.000 y la barra de herramientas dice Mostrando 50.000 de N elementos, así que siempre sabes cuándo falta parte de los datos. Cada parte de una forma multiparte cuenta como un elemento. El mapa lee las filas que la cuadrícula tiene en memoria; si el resultado es demasiado grande para cargar, filtra o toma una muestra en la consulta, o agrégalo, cuando necesites la visión completa.
Directiva Map
A -- sqlly map: un comentario en la consulta establece cómo se mapea su resultado, de la misma manera grid: establece la cuadrícula. Es lo que escribe el botón del panel de Opciones Escribir en la consulta botón escribe, y cada ajuste de abajo también se puede cambiar desde el panel.
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
Los ajustes son key=value, separadas por ;, en cualquier orden. Sin un número, la línea se aplica a cada conjunto de resultados de la ejecución; map 2: se aplica solo al segundo, contando desde 1. Cuando varias líneas se aplican, los ajustes posteriores anulan a los anteriores. Los nombres de columna coinciden sin distinguir mayúsculas de minúsculas, y se escriben entre comillas dobles cuando contienen un espacio o cualquiera de , ; : = " | (comilla doble dentro de una).
| Ajuste | Significado | Ejemplo |
|---|---|---|
lat=col; lon=col | Las columnas de latitud y longitud. Anula la detección por nombre; se necesitan ambas. | lat=y; lon=x |
geom=col | Una columna de geometría en formato well-known text o binario. Tiene prioridad sobre la detección automática. | geom=boundary |
srid=n | El sistema de coordenadas de los datos. Cualquier valor distinto de 4326 se dibuja como un boceto sin el mapa de calles. | srid=27700 |
label=col | El título flotante. Por defecto: member, key, name, label, title, id, o la primera columna de texto. | label=store_name |
tooltip=a, b | Extra column: value líneas en la información sobre herramientas al pasar el cursor. | tooltip=city, revenue |
mode=points|heatmap|both | Marcadores, un mapa de calor, o el mapa de calor con marcadores encima. Las líneas y los polígonos siempre se dibujan. | mode=both |
color=col | Colorear marcadores y formas según una columna: hasta 12 colores para valores de texto (el resto comparten uno), un degradado para números. | color=region |
size=col | Escalar el tamaño del marcador según una columna numérica, desde el valor más pequeño hasta el más grande. | size=revenue |
weight=col | Pondera el calor de cada ubicación según una columna numérica (NULL y los negativos cuentan como 0). | weight=orders |
radius=px | Qué tan lejos se dispersa el calor de cada ubicación, de 6 a 120 píxeles de pantalla (24 de forma predeterminada). | radius=30 |
blur=px | Suavizado adicional del mapa de calor, de 0 a 200 píxeles (predeterminado: 0). | blur=12 |
intensity=n | Realza el calor tenue hacia el extremo caliente, de 0 a 10 (predeterminado 1). | intensity=2 |
opacity=n | Opacidad máxima de la capa del mapa de calor, de 0 a 1 (predeterminado 0,8). | opacity=0.6 |
palette=name | Colores del calor: heat (azul a rojo, predeterminado), fire, viridis (apto para daltónicos), ocean, o accent (color de acento de tu tema). | palette=viridis |
cluster=on|off | Agrupa los marcadores amontonados en círculos con recuento. | cluster=on |
basemap=osm|none | El mapa de calles de OpenStreetMap, o ninguno para este resultado. osm nunca descarga teselas que no hayas aceptado. | basemap=none |
center=lat,lon; zoom=n | La vista inicial; zoom 0 (mundo) a 19 (calle). | center=51.5,-0.12; zoom=10 |
fit=data | Empieza encuadrando todos los elementos (predeterminado; anula el centro y el zoom). | fit=data |
limit=n | Máximo de elementos que se dibujan; cualquier valor superior a 50.000 cuenta como 50.000. | limit=5000 |
click=select|none | Si al hacer clic en un elemento se selecciona su fila en la cuadrícula (predeterminado select). | click=none |
open=auto|manual | Abrir el mapa automáticamente cada vez que la consulta termina, o solo desde Mostrar en el mapa… (predeterminado). | open=auto |
-- sqlly view: map como primera línea de la consulta es un atajo para
open=auto en el primer resultado: la cuadrícula se abre como siempre y la ventana del mapa se abre a su lado. Si ya hay un mapa abierto para ese resultado, volver a ejecutar actualiza esa ventana en lugar de abrir otra.
Un ajuste mal escrito o con un valor incorrecto se subraya en el editor con el motivo (por ejemplo Directiva Map: ajuste desconocido “colour”); los demás ajustes de la línea siguen aplicándose y la consulta se ejecuta con normalidad. Una columna que no esté en el resultado se omite, y la ventana del mapa indica cuáles se omitieron.
Ejemplos
Se almacena como puntos, etiquetados, con la ciudad en la información sobre herramientas:
-- sqlly map: lat=latitude; lon=longitude; label=store_name; tooltip=city
SELECT store_name, city, latitude, longitude FROM stores;
Un mapa de calor de pedidos, ponderado por el 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 con color, tamaño y agrupación para el segundo resultado, que se abre en cada ejecución:
-- sqlly map 2: color=region; size=revenue; cluster=on; open=auto
SELECT COUNT(*) FROM branches;
SELECT branch, region, revenue, lat, lon FROM branches;
Un Redis GEOSEARCH, abierto automáticamente en el 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 proyectadas, dibujadas como un boceto:
-- sqlly map: geom=boundary; srid=27700; basemap=none
SELECT name, ST_AsText(boundary) AS boundary FROM parishes;
En el navegador
La versión para navegador de SQLly nunca descarga teselas de mapas. Mostrar en el mapa y el modo mapa del visor abren el boceto directamente, sin aviso, con una nota de que las teselas no están disponibles en el navegador.