地図表示
実装済みRedis GEO の応答、経度/緯度の列、WKT または WKB の図形を、パンとズームができ、クリックで該当行に移動できる OpenStreetMap の地図上に表示します。
結果に位置情報が含まれている場合、Redis GEOSEARCH 応答、経度と緯度の列を持つテーブル、または空間図形の列があれば、SQLly はそれらをパンやズームができるストリートマップ上に描画できます。点にカーソルを合わせるとどの行か分かり、クリックするとグリッド内のその行にジャンプでき、次に切り替えることもできます ヒートマップ
一つずつ読み取るにはポイントが多すぎる場合。


地図を開く
- 結果のグリッドから。 任意のセルを右クリックし、次を選択します ツール › 地図で表示…。結果セット全体が専用のマップウィンドウで開くので、作業中もグリッドの隣に置いておけます。
- 自動的に。 A
-- sqlly map:行と一緒にopen=auto、または-- sqlly view: mapクエリの先頭行にあると、クエリが終了するたびにマップが開きます。 - 単一のジオメトリ値から。 形状を含むセルを右クリックし、次を選択します ジオメトリを表示… (またはそれを次で選択 セル詳細パネル 開いている場合)。ビューアーのツールバーには スケッチ / 地図 / 未加工 スイッチ; マップ その 1 つの図形をストリートマップ上に置きます。
マッピングできるもの
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 フィールド)はWKT(ウェルノウンテキスト)として届き、他のジオメトリ列と同じようにマップされます。


経度と緯度の列
経度列と緯度列を含む結果であれば、どれでも地図に表示できます。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)
値が空間図形である列もマップされます。ポイント、ラインストリング、ポリゴン(穴を含む)、それらのマルチ形式、ジオメトリコレクションです。SQLly は次を読み取ります:
- ウェルノウンテキスト (WKT) - 必要に応じて SRID プレフィックス付き:
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - ウェルノウンバイナリ (WKB) - バイト列として、または 16 進テキストとして。これは PostGIS が返す形式です
geometry列で返されるのがデフォルトです - SRIDを持つ拡張形式も、MySQL独自の空間値形式も含まれます。
列は、その型が空間型である場合にジオメトリとして扱われます(geometry,
geography, point、など)で、かつ最初の 20 個の NULL 以外の値のうち少なくとも 1 つが解析できる場合、または最初の 20 個の NULL 以外の値がすべて、型に関係なく解析できる場合。複数パートの図形はそれぞれのパートとして描画され、すべて同じ行のラベルが付きます。SQL Server のネイティブ geometry/geography バイト列はWell-Known Binaryではないため、次を選択します 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 はタイルサーバーに接続しません。
- 確認されるのは一度だけです。 地図を初めて開くと、ダウンロードされる内容を説明するプロンプトが表示されます。 マップタイルを読み込む タイルをオンにします; 今はやめてスケッチを使う オフのままにします。どちらの回答も記憶されます。
- 地図画像のみ取得されます。 リクエストが求めるのは、画面上の領域をカバーするタイルだけです。クエリ結果、列名、座標がどこかに送信されることはありません。
- マナーを守ったダウンロード。 同時にダウンロードされるタイルは最大 2 つで、表示している地図の部分に限られ (先読みは行いません)、リクエストは OpenStreetMap のタイル利用ポリシーが求めるとおり、バージョン付きで SQLly と名乗ります。
- 帰属表示。 タイルが表示されている間、 © OpenStreetMap contributors 地図の右下隅にあります。クリックすると OpenStreetMap の著作権とライセンスのページが開きます。
- 後でタイルをオンまたはオフにする場合。 使用 設定 › 結果 › 全般 › 地図 › OpenStreetMap から道路地図タイルを読み込む、または次の マップタイルをオンにする 拒否した後のマップのメモバーのボタン。


タイルキャッシュ
各タイルはお使いのコンピューターに保存され、14 日間は再利用されてからあらためてダウンロードされるため、同じ地域を見直してもコストはかからず、タイルサーバーに 2 度問い合わせることもありません。タイルは次に保存されます
map-tiles SQLlyのデータフォルダ内のフォルダ:
| プラットフォーム | フォルダー |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/map-tiles |
| Windows | %APPDATA%\SQLLY\map-tiles |
| Linux | ~/.local/share/SQLLY/map-tiles |
フォルダーはいつ削除しても問題ありません。タイルは必要に応じて再取得されます。
タイルなしの場合: スケッチ
タイルを拒否した場合、オフラインの場合、またはブラウザーで SQLly を使っている場合でも、地図は引き続き機能します。同じ点、線、ポリゴンが、経線と緯線の薄い 30° グリッドを引いた無地の背景に描画され、パン、ズーム、フィット、ホバー、クリック、ヒートマップはすべて同じように動作します。ツールバーの下の注記に、ストリートマップがない理由が表示されます。タイルサーバーに到達できずダウンロードが失敗した場合、SQLly は確認を止め、すでにキャッシュされているタイルを使用し、次を提案します 再試行.


オプションパネル
クリック オプション マップのツールバー右側にあり、マップのすべての設定を含むパネルを開きます。変更はすぐにマップに反映されます。
- データ - 場所 (Auto、または検出された経度/緯度のペアやジオメトリ列のいずれか)、 ラベル (ホバー時のタイトル)、 ツールチップの列 (ホバーツールチップの追加行)、 色分けの基準 (テキストにはパレット、数値にはグラデーション。下に凡例が付きます)、および サイズ別 (数値が大きいほどマーカーも大きくなります)。
- レイヤー - 表示 ポイント、 ヒートマップ、またはその両方; クラスターマーカー 互いに重なるマーカーを 1 つの円にまとめ (ホバーで件数を表示、クリックでズーム)、ヒートマップでは重み、半径、ぼかし、強度、不透明度、パレットを設定できます。
- マップ - ストリートマップ この結果をオンまたはオフにし、何が クリック したときに何が起こるか、マップが 実行時に開きます、その ほとんどの機能 描画し、 初期ビュー (データに合わせるか、今見ているビューを記憶します)。
- ディレクティブ - 次の
-- sqlly map:これらの設定が作成する行。 コピー クリップボードに入り、 クエリに書き込む クエリのロックブロックに書き込まれるため、ファイルを開いた人全員に、実行のたびに同じマップが表示されます。


移動のしかた
| に | こうしてください |
|---|---|
| パン | 地図をドラッグします。地図は横方向に地球を一周するようにつながっているため、日付変更線を越えてドラッグし続けられます。 |
| ズーム | マウスホイールを回すか、トラックパッドをピンチします。ポインターの下の位置は動きません。または、次を使います − そして + ボタン。中心を基準に1段階ずつズームします。ストリートマップは世界全体(レベル0)から街路レベル(レベル19)まであります。 |
| すべてを見る | 全体表示 ズームして、プロットされたすべての地物が表示範囲に収まるようにします。マップは最初から全体に合わせて開きます。日付変更線の両側にまたがるデータは、その線をまたぐ短い側で表示範囲が決まります。 |
| 機能を特定する | カーソルを合わせてみてください。ツールチップに行の名前が表示されます:Redis の member、または次の名前の列 key, name, label, title、または id、なければ最初のテキスト列。それもなければ行番号。 |
| その行を探す | クリックします。機能が強調表示され、マップの元になったグリッドで行が選択され、表示位置までスクロールされます (オフにするには 機能をクリックする オプションパネルで、または click=none). |
| クラスターを開く | 次を使う場合 クラスターマーカー オンにすると、密集したマーカーが 1 つの円にまとまります。ホバーすると含まれる場所の数が分かり、クリックすると分かれるまでズームインします。 |
クリックすると、「地図で表示」で開いた結果のグリッド行が選択されます。ピボットタブから開いた地図や、ビューアー内の単一の値から開いた地図には、選択できる行がありません。行がディスクからページ読み込みされる非常に大きな結果では、結果のその部分がグリッドに読み込まれている間だけ、クリックで行が選択されます。
非常に大きな結果
地図に描画するのは最大で 50,000 フィーチャ (次を設定した場合は少なくなります 最大フィーチャー数 オプションパネルで、または limit=)。それを超えると、最初の 50,000 件だけが描画され、ツールバーには次のように表示されます N 件の地物のうち 50,000 件を表示、そのため、データの一部が欠けているときは常に分かります。複数パートのシェイプは、パートごとに 1 つのフィーチャーとして数えられます。マップはグリッドがメモリに保持している行を読むため、保持しきれないほど大きな結果では、全体像が必要なときにクエリ側でフィルターやサンプリング、集計をしてください。
マップディレクティブ
A -- sqlly map: クエリ内のコメントで、結果のマッピング方法を設定します。同じ方法で grid: はグリッドを設定します。これは、オプションパネルの クエリに書き込む ボタンが書き込みを行い、以下の各設定もパネルから変更できます。
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
設定は key=value、区切り文字は ;、順序は問いません。番号がない場合、その行は実行のすべての結果セットに適用されます。 map 2: 2番目のみに適用されます(1から数えます)。複数の行が該当する場合は、後の設定が前の設定を上書きします。列名は大文字小文字を区別せずに照合され、スペースや次の文字を含む場合は二重引用符で囲んで書き出します , ; : = " | (引用符の中の引用符は 2 つ重ねます)。
| 設定 | 意味 | 例 |
|---|---|---|
lat=col; lon=col | 緯度列と経度列。列名による自動検出を上書きします。両方の指定が必要です。 | lat=y; lon=x |
geom=col | Well-Known Text または Well-Known Binary 形式のジオメトリ列。自動検出よりも優先されます。 | 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 色(残りは 1 色を共有)、数値にはグラデーション。 | 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 | すべてのフィーチャーが収まるフレーミングで開始します(既定。center と zoom を上書きします)。 | 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;
実行のたびに開く 2 つ目の結果に対する、色分け・サイズ・クラスタリング付きのマーカー:
-- 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 は地図タイルをダウンロードしません。「地図で表示」とビューアーのマップモードは、プロンプトなしでスケッチを直接開き、タイルはブラウザでは利用できない旨の注記を表示します。