地圖檢視

功能性的

將 Redis GEO 回應、經緯度欄位,以及 WKT 或 WKB 形狀放在 OpenStreetMap 街道地圖上,可平移、縮放,還能點擊圖形跳到對應的資料列。

當結果中含有位置資訊時,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= 在一個 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;
SQLly
把 well-known text 欄位中的多邊形和線條畫在街道地圖上,商店則以點顯示。把 well-known text 欄位中的多邊形和線條畫在街道地圖上,商店則以點顯示。
把 well-known text 欄位中的多邊形和線條畫在街道地圖上,商店則以點顯示。
座標系統。 街道地圖採用經度/緯度(WGS 84,SRID 4326)。具有 SRID 4326 的圖形,或沒有 SRID 但座標落在經度/緯度範圍內的圖形,會顯示在街道地圖上。其他座標系統(如國家格網或 UTM 分區)的圖形,例如 SRID=27700 - 仍然會被繪製,可平移及縮放,但作為沒有街道地圖的草圖,並附上一個註明 SRID 的標記。SQLly 不會重新投影它們;在查詢中先進行轉換(例如 ST_Transform(geom, 4326) 在 PostGIS 中)才能在地圖上看到它們。

來自 OpenStreetMap 的街道地圖圖磚

街道地圖由來自 OpenStreetMap 計畫的圖像圖磚組成,下載自 tile.openstreetmap.org。除非你開口,SQLly 不會主動連上圖磚伺服器。

  • 只會問你一次。 第一次開啟地圖時,會有提示說明將會下載的內容。 載入地圖圖塊 會開啟圖磚; 先不要,改用草圖 會讓它們維持關閉。不管選哪個,都會被記住。
  • 只會擷取地圖圖片。 請求只會索取涵蓋畫面範圍的圖磚,其他一概不送。你的查詢結果、欄位名稱與座標絕不會傳送到任何地方。
  • 下載很節制。 一次最多下載兩塊圖磚,只下載你正在檢視的地圖部分(不會預先抓取),請求會以 SQLly 與其版本自我識別,以符合 OpenStreetMap 圖磚使用政策的要求。
  • 出處標示。 顯示圖磚時, © 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以 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|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 絕不會下載地圖圖磚。在地圖上顯示與檢視器的地圖模式會直接開啟草圖,不會彈出提示,並註明瀏覽器中無法使用圖磚。