Vista de mapa

funcional

Coloca 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.

SQLly
La ventana del mapa sobre un resultado con columnas de longitud y latitud: mosaicos de OpenStreetMap, un marcador por fila, una etiqueta al pasar el cursor, y los controles de Puntos/Mapa de calor/Ambos, zoom, Ajustar y Opciones en la barra de herramientas.La ventana del mapa sobre un resultado con columnas de longitud y latitud: mosaicos de OpenStreetMap, un marcador por fila, una etiqueta al pasar el cursor, y los controles de Puntos/Mapa de calor/Ambos, zoom, Ajustar y Opciones en la barra de herramientas.
La ventana del mapa sobre un resultado con columnas de longitud y latitud: mosaicos de OpenStreetMap, un marcador por fila, una etiqueta al pasar el cursor, y los controles de Puntos/Mapa de calor/Ambos, zoom, Ajustar y Opciones en la barra de herramientas.

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 con open=auto, o -- sqlly view: map como 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.

SQLly
Una respuesta Redis GEOSEARCH WITHCOORD en el mapa: cada miembro, una tienda, aparece como un punto en el mapa de calles.Una respuesta Redis GEOSEARCH WITHCOORD en el mapa: cada miembro, una tienda, aparece como un punto en el mapa de calles.
Una respuesta Redis GEOSEARCH WITHCOORD en el mapa: cada miembro, una tienda, aparece como un punto en el mapa de calles.

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, o longitude: lon, LNG, pickup_lon, StartLongitude.
  • Latitud - una palabra lat o latitude: 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 geometry columna 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;
SQLly
Polígonos y una línea a partir de una columna well-known-text, dibujados sobre el mapa de calles, con las tiendas como puntos.Polígonos y una línea a partir de una columna well-known-text, dibujados sobre el mapa de calles, con las tiendas como puntos.
Polígonos y una línea a partir de una columna well-known-text, dibujados sobre el mapa de calles, con las tiendas como puntos.
Sistemas de coordenadas. El mapa de calles está en longitud/latitud (WGS 84, SRID 4326). Las formas con SRID 4326, o sin SRID y con coordenadas dentro de los rangos de longitud/latitud, se colocan en el mapa de calles. Las formas en cualquier otro sistema, una cuadrícula nacional o una zona UTM, por ejemplo 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.
SQLly
El aviso de primer uso sobre un mapa nuevo: ¿Cargar el mapa de calles de OpenStreetMap?, con Cargar teselas de mapa y Ahora no, usar un boceto.El aviso de primer uso sobre un mapa nuevo: ¿Cargar el mapa de calles de OpenStreetMap?, con Cargar teselas de mapa y Ahora no, usar un boceto.
El aviso de primer uso sobre un mapa nuevo: ¿Cargar el mapa de calles de OpenStreetMap?, con Cargar teselas de mapa y Ahora no, usar un boceto.

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:

PlataformaCarpeta
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.

SQLly
El mismo resultado dibujado como boceto al rechazar los mosaicos: marcadores sobre un fondo sencillo con una cuadrícula ligera de latitud/longitud y el botón Activar mosaicos del mapa.El mismo resultado dibujado como boceto al rechazar los mosaicos: marcadores sobre un fondo sencillo con una cuadrícula ligera de latitud/longitud y el botón Activar mosaicos del mapa.
El mismo resultado dibujado como boceto al rechazar los mosaicos: marcadores sobre un fondo sencillo con una cuadrícula ligera de latitud/longitud y el botón Activar mosaicos del mapa.

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.
SQLly
Panel de Opciones del mapa: secciones de Datos, Capas y Mapa, una leyenda de colores y la línea -- sqlly map: con Copiar y Escribir en la consulta.Panel de Opciones del mapa: secciones de Datos, Capas y Mapa, una leyenda de colores y la línea -- sqlly map: con Copiar y Escribir en la consulta.
Panel de Opciones del mapa: secciones de Datos, Capas y Mapa, una leyenda de colores y la línea -- sqlly map: con Copiar y Escribir en la consulta.

Desplazarse

AHaz esto
DesplazarseArrastra 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.
ZoomGira 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 todoAjustar 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ísticaPasa 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 filaHaz 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ústerCon 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).

AjusteSignificadoEjemplo
lat=col; lon=colLas columnas de latitud y longitud. Anula la detección por nombre; se necesitan ambas.lat=y; lon=x
geom=colUna columna de geometría en formato well-known text o binario. Tiene prioridad sobre la detección automática.geom=boundary
srid=nEl sistema de coordenadas de los datos. Cualquier valor distinto de 4326 se dibuja como un boceto sin el mapa de calles.srid=27700
label=colEl título flotante. Por defecto: member, key, name, label, title, id, o la primera columna de texto.label=store_name
tooltip=a, bExtra column: value líneas en la información sobre herramientas al pasar el cursor.tooltip=city, revenue
mode=points|heatmap|bothMarcadores, 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=colColorear 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=colEscalar 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=colPondera el calor de cada ubicación según una columna numérica (NULL y los negativos cuentan como 0).weight=orders
radius=pxQué 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=pxSuavizado adicional del mapa de calor, de 0 a 200 píxeles (predeterminado: 0).blur=12
intensity=nRealza el calor tenue hacia el extremo caliente, de 0 a 10 (predeterminado 1).intensity=2
opacity=nOpacidad máxima de la capa del mapa de calor, de 0 a 1 (predeterminado 0,8).opacity=0.6
palette=nameColores 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|offAgrupa los marcadores amontonados en círculos con recuento.cluster=on
basemap=osm|noneEl mapa de calles de OpenStreetMap, o ninguno para este resultado. osm nunca descarga teselas que no hayas aceptado.basemap=none
center=lat,lon; zoom=nLa vista inicial; zoom 0 (mundo) a 19 (calle).center=51.5,-0.12; zoom=10
fit=dataEmpieza encuadrando todos los elementos (predeterminado; anula el centro y el zoom).fit=data
limit=nMáximo de elementos que se dibujan; cualquier valor superior a 50.000 cuenta como 50.000.limit=5000
click=select|noneSi al hacer clic en un elemento se selecciona su fila en la cuadrícula (predeterminado select).click=none
open=auto|manualAbrir 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.