地图视图

功能的

在可平移、缩放并可点击对应行的 OpenStreetMap 街道地图上显示 Redis GEO 响应、经/纬度列和 WKT 或 WKB 形状。

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

SQLly
带经度和纬度列的结果之上的地图窗口:OpenStreetMap 瓦片、每行一个标记、悬停标签,以及工具栏中的点/热力图/两者、缩放、适应和选项控件。带经度和纬度列的结果之上的地图窗口:OpenStreetMap 瓦片、每行一个标记、悬停标签,以及工具栏中的点/热力图/两者、缩放、适应和选项控件。
带经度和纬度列的结果之上的地图窗口:OpenStreetMap 瓦片、每行一个标记、悬停标签,以及工具栏中的点/热力图/两者、缩放、适应和选项控件。

打开地图

  • 从结果网格中。 右键点击任意单元格并选择 工具 › 在地图上显示…。完整的结果集会在独立的地图窗口中打开,你可以在工作时把它放在网格旁边。
  • 自动。 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
地图上呈现的 Redis GEOSEARCH WITHCOORD 回复:每个成员都是街道地图上的一个点。地图上呈现的 Redis GEOSEARCH WITHCOORD 回复:每个成员都是街道地图上的一个点。
地图上呈现的 Redis GEOSEARCH WITHCOORD 回复:每个成员都是街道地图上的一个点。

经度和纬度列

任何带经度列和纬度列的结果都能标到地图上。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;
SQLly
把 well-known text(WKT)列里的多边形和折线画在街道地图上,商店则显示为点。把 well-known text(WKT)列里的多边形和折线画在街道地图上,商店则显示为点。
把 well-known text(WKT)列里的多边形和折线画在街道地图上,商店则显示为点。
坐标系。 街道地图使用经度/纬度(WGS 84,SRID 4326)。带 SRID 4326 的形状,或没有 SRID 但坐标落在经度/纬度范围内的形状,会画在街道地图上。属于其他任何坐标系——国家网格或 UTM 分区——的形状,例如 SRID=27700 - 仍然会绘制出来,可平移、可缩放,但只是一张没有街道底图的草图,并附注 SRID。SQLly 不做重投影;请在查询里自行转换(例如 ST_Transform(geom, 4326) 在 PostGIS 中)以在地图上查看。

来自 OpenStreetMap 的街道地图瓦片

街道地图由 OpenStreetMap 项目的图像切片组成,从 tile.openstreetmap.org下载。在你明确要求之前,SQLly 不会联系切片服务器。

  • 只会问你一次。 首次打开地图时会弹出提示,说明将要下载的内容。 加载地图图块 开启图块; 暂不加载,使用草图 会让它们保持关闭。无论选哪个答案,都会被记住。
  • 仅获取地图图片。 请求只索取覆盖屏幕区域的图块,别无其他。你的查询结果、列名和坐标绝不会被发送到任何地方。
  • 克制地下载。 最多同时下载两个图块,且仅限你正在查看的地图部分(不会预取你还没看的地方),并且按 OpenStreetMap 图块使用政策的要求,请求会以 SQLly 及其版本号表明身份。
  • 署名。 显示地图瓦片期间, © OpenStreetMap 贡献者 位于地图右下角;点击它会打开 OpenStreetMap 的版权和许可页面。
  • 之后还可以随时开关地图图块。 使用 设置 › 结果 › 常规 › 地图 › 从 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
拒绝图块之后,同样的结果会画成素描样式:纯色背景上的标记,配一层浅淡的经纬网格,外加开启地图图块按钮。拒绝图块之后,同样的结果会画成素描样式:纯色背景上的标记,配一层浅淡的经纬网格,外加开启地图图块按钮。
拒绝图块之后,同样的结果会画成素描样式:纯色背景上的标记,配一层浅淡的经纬网格,外加开启地图图块按钮。

选项面板

点击 选项 位于地图工具栏右侧,点开它可以看到一个面板,里面是地图的全部设置。每改一处都会立即重绘地图。

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