地圖檢視
功能性的將 Redis GEO 回應、經緯度欄位,以及 WKT 或 WKB 形狀放在 OpenStreetMap 街道地圖上,可平移、縮放,還能點擊圖形跳到對應的資料列。
當結果中含有位置資訊時,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= 在一個 map 指示詞)。如果沒有任何名稱配對,則提供每個經度/緯度組合。
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
幾何欄位(WKT 和 WKB)
值是空間圖形的欄位也能畫上地圖:點、線字串、多邊形(含洞)、以及各種 Multi 形式和幾何集合。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 不會主動連上圖磚伺服器。
- 只會問你一次。 第一次開啟地圖時,會有提示說明將會下載的內容。 載入地圖圖塊 會開啟圖磚; 先不要,改用草圖 會讓它們維持關閉。不管選哪個,都會被記住。
- 只會擷取地圖圖片。 請求只會索取涵蓋畫面範圍的圖磚,其他一概不送。你的查詢結果、欄位名稱與座標絕不會傳送到任何地方。
- 下載很節制。 一次最多下載兩塊圖磚,只下載你正在檢視的地圖部分(不會預先抓取),請求會以 SQLly 與其版本自我識別,以符合 OpenStreetMap 圖磚使用政策的要求。
- 出處標示。 顯示圖磚時, © 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 | 以 well-known text 或二進位格式表示的幾何欄位。會覆寫自動偵測。 | 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 絕不會下載地圖圖磚。在地圖上顯示與檢視器的地圖模式會直接開啟草圖,不會彈出提示,並註明瀏覽器中無法使用圖磚。