地图视图
功能的在可平移、缩放并可点击对应行的 OpenStreetMap 街道地图上显示 Redis GEO 响应、经/纬度列和 WKT 或 WKB 形状。
当结果中包含地理位置时,Redis GEOSEARCH 回复、带有经度和纬度列的表,或一个空间形状列——SQLly 可以在可平移和缩放的街道地图上绘制它们。将鼠标悬停在某个点上以查看它对应哪一行,点击它以跳转到网格中的该行,并切换到 热力图
当点太多无法逐一读取时使用。


打开地图
- 从结果网格中。 右键点击任意单元格并选择 工具 › 在地图上显示…。完整的结果集会在独立的地图窗口中打开,你可以在工作时把它放在网格旁边。
- 自动。 A
-- sqlly map:行,其中open=auto,或-- sqlly view: map作为查询的第一行,每次查询完成时都会打开地图。 - 从单个几何值开始。 右键单击包含图形的单元格并选择 查看几何… (或在 单元格详细信息面板 以打开)。查看器的工具栏有一个 草图 / 地图 / 原始 开关; 地图 把那个形状放到街道地图上。
可以映射的内容
Redis GEO 回复
GEOSEARCH, GEORADIUS, GEORADIUSBYMEMBER,以及
GEOPOS 会以网格形式返回,带有 member, dist,
lon,以及 lat 列,只要你请求坐标。添加
WITHCOORD 让回复带上它们:
GEOSEARCH stores FROMLONLAT -0.1278 51.5074 BYRADIUS 50 km WITHCOORD WITHDIST ASC
每个成员都会变成一个以名称标注的点。来自 Redis 搜索回复(FT.SEARCH 在一个 GEOSHAPE 字段)以 well-known text 格式到达,并像其他任何几何列一样进行映射。


经度和纬度列
任何带经度列和纬度列的结果都能标到地图上。SQLly 会按名称查找这两列,不区分大小写,判断依据是列名中的用词:
- 经度 - 一个单词
lon,lng,long,或longitude:lon,LNG,pickup_lon,StartLongitude. - 纬度 - 一个单词
lat或者latitude:lat,dropoff_lat,EndLatitude.
单词会在下划线、空格、点、连字符和大写字母处分割,因此
latency, plate,或 longest 不会被误当成坐标。值可以是数字或数字文本。缺值的行,以及经度超出 -180 到 180、纬度超出 -90 到 90 的行,都不会画到地图上,而是计入工具栏的 没有位置的行.
当存在不止一对时 - 例如 pickup_lon/pickup_lat
和 dropoff_lon/dropoff_lat - 共享其余名称的列会配对,并且地图打开时会显示其 选项 面板,其中 位置 选择器在它们之间切换(或写入 lat= 和
lon= 在一个 地图指令)。如果按名称配不上对,就会提供所有经度/纬度组合。
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
几何列(WKT 和 WKB)
取值为空间图形的列也会被绘制到地图上:点、线串、多边形(含孔洞)、它们的多重形式,以及几何集合。SQLly 读取:
- 熟知文本 - 也可以带上 SRID 前缀:
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - 熟知二进制 - 以字节或十六进制文本表示,PostGIS 就是这么返回一个
geometry默认按列 - 包括带有 SRID 的扩展形式,以及 MySQL 自己的空间值格式。
当列的类型为空间类型时,该列被视为几何geometry,
geography, point,等等),并且它的前 20 个非 NULL 值里至少有一个能解析,或者它的前 20 个非 NULL 值全都能解析(不管什么类型)。多部分的形状会拆成各个部分来绘制,全部标注为同一行。SQL Server 原生的 geometry/geography 字节不是众所周知的二进制格式,所以请选择 shape.STAsText() 或者 shape.STAsBinary() 而不是原始列。
SELECT name, boundary.STAsText() AS boundary FROM dbo.DeliveryZones;


SRID=27700 - 仍然会绘制出来,可平移、可缩放,但只是一张没有街道底图的草图,并附注 SRID。SQLly 不做重投影;请在查询里自行转换(例如 ST_Transform(geom, 4326) 在 PostGIS 中)以在地图上查看。来自 OpenStreetMap 的街道地图瓦片
街道地图由 OpenStreetMap 项目的图像切片组成,从
tile.openstreetmap.org下载。在你明确要求之前,SQLly 不会联系切片服务器。
- 只会问你一次。 首次打开地图时会弹出提示,说明将要下载的内容。 加载地图图块 开启图块; 暂不加载,使用草图 会让它们保持关闭。无论选哪个答案,都会被记住。
- 仅获取地图图片。 请求只索取覆盖屏幕区域的图块,别无其他。你的查询结果、列名和坐标绝不会被发送到任何地方。
- 克制地下载。 最多同时下载两个图块,且仅限你正在查看的地图部分(不会预取你还没看的地方),并且按 OpenStreetMap 图块使用政策的要求,请求会以 SQLly 及其版本号表明身份。
- 署名。 显示地图瓦片期间, © OpenStreetMap 贡献者 位于地图右下角;点击它会打开 OpenStreetMap 的版权和许可页面。
- 之后还可以随时开关地图图块。 使用 设置 › 结果 › 常规 › 地图 › 从 OpenStreetMap 加载街道地图瓦片,或者 开启地图图块 拒绝后,可通过地图备注栏中的按钮重新打开。


瓦片缓存
每个瓦片都保存在你的电脑上,14 天内重复使用,之后才会重新下载,因此重访某个区域毫无成本,也不会向瓦片服务器重复请求。瓦片存放在一个
map-tiles SQLly 的数据文件夹中的文件夹:
| 平台 | 文件夹 |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/map-tiles |
| Windows | %APPDATA%\SQLLY\map-tiles |
| Linux | ~/.local/share/SQLLY/map-tiles |
在任何时候删除该文件夹都是安全的;瓦片会在你需要时重新获取。
无瓦片:草图
如果你拒绝使用瓦片、处于离线状态,或在浏览器中使用 SQLly,地图仍然可用:相同的点、线和多边形会绘制在纯色背景上,并带有浅淡的 30° 经纬线网格;平移、缩放、适应窗口、悬停、点击和热力图的行为都保持不变。工具栏下方有一条说明,解释为什么没有街道地图。当因瓦片服务器无法访问而导致下载失败时,SQLly 会停止请求,改用已缓存的瓦片,并提供 重试.


选项面板
点击 选项 位于地图工具栏右侧,点开它可以看到一个面板,里面是地图的全部设置。每改一处都会立即重绘地图。
- 数据 - 位置 (自动,或检测到的经纬度对和几何列之一), 标签 (悬停标题), 工具提示列 (悬停提示中的额外行), 颜色依据 (文本调色板,数字渐变,并在下方显示图例),以及 大小依据 (数字越大,标记越大)。
- 层数 - 显示 点,一个 热力图,或两者; 聚类标记 会把挤在一起的标记归并成一个圆圈(悬停显示数量,点击放大);此外还提供热力图的权重、半径、模糊度、强度、不透明度和配色。
- 地图 - 街道地图 针对这个结果是开还是关,以及 点击 要素后会做什么,以及地图是否 运行时打开, 大多数功能 画,和 起始视图 (自适应数据,或记住你当前看到的视图)。
- 指令 - 这里的
-- sqlly map:调整这些设置。 复制 将其放到剪贴板上; 写入查询 将其写入查询的锁块中,因此地图在每次运行时都会以相同的方式返回,对于任何打开该文件的人都是一样的。


地图操作
| 至 | 怎么做 |
|---|---|
| 平移 | 拖动地图。地图可横向环绕地球,因此越过日期变更线后仍可继续拖动。 |
| 缩放 | 滚动鼠标滚轮或在触控板上捏合 — 指针下方的位置保持不动 — 或者使用 − 和 + 按钮,围绕中心一次缩放一级。街道地图从全世界(级别 0)一直画到街道级别(级别 19)。 |
| 查看所有内容 | 适应 缩放,使每个绘制的要素都位于视野内。地图打开时会自动适配范围。日界线两侧的数据会以横跨日界线的较短一侧显示。 |
| 识别地图要素 | 将鼠标悬停在它上面。工具提示显示该行的名称:一个 Redis member,或者一个名为 key, name, label, title,或 id,否则用第一个文本列;再不行就用行号。 |
| 找到对应的行 | 点击它。地图来源的网格会高亮该功能,对应的行会被选中并滚动到可见位置(要关闭,可用 点击某个功能 在“选项”面板中,或者 click=none). |
| 打开一个集群 | 开启 聚类标记 开启后,拥挤的标记会合并成一个圆圈;悬停可查看其中包含多少个位置,点击可放大,直到它分开为止。 |
对于用“在地图上显示”打开的结果,点击即可选中网格中对应的行;从透视表选项卡或查看器里单个值打开的地图没有可选择的行。对于行需从磁盘分页加载的超大结果,只有当对应部分已加载进网格时,点击才能选中该行。
超大结果集
地图最多绘制 50,000 个要素 (如果你设置了 大多数功能 在“选项”面板中,或者 limit=)。超过这个数后,只绘制前 50,000 个,工具栏会显示 显示 N 个要素中的 50,000 个,所以数据哪一部分缺失你总能发现。多部分形状的每一部分都算一个要素。地图读取的是网格已在内存中的行,所以如果结果大到放不下,需要看全貌时,请在查询里先过滤、抽样或聚合。
地图指令
A -- sqlly map: 查询中的注释用来设定其结果的映射方式,原理与 grid: 设置网格。它就是“选项”面板中的 写入查询 按钮所写出的内容,下方的每个设置也都可以在面板中修改。
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
设置的格式为 key=value,用 ;,顺序不限。没有编号时,这一行适用于本次运行的每个结果集; map 2: 仅适用于第二项(从 1 开始计数)。多行同时生效时,后面的设置覆盖前面的。列名匹配时不区分大小写,当列名包含空格或以下字符之一时会用双引号括起: , ; : = " | (引号内的引号需要连写两次)。
| 设置项 | 含义 | 示例 |
|---|---|---|
lat=col; lon=col | 纬度和经度列。设置后会覆盖按名称自动检测的结果;两列都必须提供。 | lat=y; lon=x |
geom=col | 采用 WKT 或 WKB 格式的几何列。会覆盖自动检测。 | geom=boundary |
srid=n | 数据的坐标系。只要不是 4326,就只画成示意图,不带街道地图。 | srid=27700 |
label=col | 悬停标题。默认值: member, key, name, label, title, id,或者第一个文本列。 | label=store_name |
tooltip=a, b | 额外 column: value 行会显示在悬停提示里。 | tooltip=city, revenue |
mode=points|heatmap|both | 标记、热力图,或热力图上叠加标记。线和多边形始终会绘制。 | mode=both |
color=col | 按列的值为标记和形状着色:文本值最多 12 种颜色(其余共用一种),数值用渐变。 | color=region |
size=col | 标记大小按数值列缩放,从最小值到最大值。 | size=revenue |
weight=col | 按数值列为各位置的热度加权(NULL 和负数按 0 计)。 | weight=orders |
radius=px | 每个位置的热度扩散范围,6 到 120 屏幕像素(默认 24)。 | radius=30 |
blur=px | 热度的额外柔化,0 到 200 像素(默认 0)。 | blur=12 |
intensity=n | 将微弱的热度向热端增强,取值 0 到 10(默认 1)。 | intensity=2 |
opacity=n | 热力图层的最大不透明度,范围 0 到 1(默认 0.8)。 | opacity=0.6 |
palette=name | 热度颜色: heat (蓝到红,默认), fire, viridis (色盲友好), ocean,或 accent (你主题的强调色)。 | palette=viridis |
cluster=on|off | 把拥挤的标记聚合成带计数的圆圈。 | cluster=on |
basemap=osm|none | OpenStreetMap 街道地图,或此结果不使用地图。 osm 从不下载你未同意的瓦片。 | basemap=none |
center=lat,lon; zoom=n | 起始视图;缩放级别 0(世界)到 19(街道)。 | center=51.5,-0.12; zoom=10 |
fit=data | 初始视野框住所有要素(默认;会覆盖中心和缩放设置)。 | fit=data |
limit=n | 要绘制的要素数上限;超过 50,000 的按 50,000 计。 | limit=5000 |
click=select|none | 点击要素是否会选中网格中对应的行(默认 select). | click=none |
open=auto|manual | 每次查询完成后自动打开地图,或者仅从 在地图上显示… (默认)。 | open=auto |
-- sqlly view: map 作为查询的第一行,是以下内容的快捷方式:
open=auto 在第一个结果上打开:网格照常显示,地图窗口在其旁打开。如果该结果的地图已打开,重新运行会刷新那个窗口,而不是再开一个。
拼错的设置项或坏值会在编辑器里标上下划线并注明原因(例如 地图指令:未知设置“colour”);该行上的其他设置仍然生效,查询会正常运行。结果中没有的列会被跳过,地图窗口会说明跳过了哪些。
示例
以点形式存储,带标签,工具提示中显示城市:
-- sqlly map: lat=latitude; lon=longitude; label=store_name; tooltip=city
SELECT store_name, city, latitude, longitude FROM stores;
按订单数量加权的订单热力图:
-- 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;
第二个结果使用带颜色、大小和聚类的标记,每次运行都会打开:
-- sqlly map 2: color=region; size=revenue; cluster=on; open=auto
SELECT COUNT(*) FROM branches;
SELECT branch, region, revenue, lat, lon FROM branches;
一个 Redis GEOSEARCH,在地图上自动打开:
-- 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
投影后的形状,以草图形式画出:
-- sqlly map: geom=boundary; srid=27700; basemap=none
SELECT name, ST_AsText(boundary) AS boundary FROM parishes;
在浏览器中
这 浏览器版本 的 SQLly 从不下载地图瓦片。在地图上显示和查看器的地图模式会直接打开草图,不弹提示,并注明瓦片在浏览器中不可用。