地図表示

実装済み

Redis GEO の応答、経度/緯度の列、WKT または WKB の図形を、パンとズームができ、クリックで該当行に移動できる OpenStreetMap の地図上に表示します。

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

SQLly
経度と緯度の列を持つ結果の地図ウィンドウ: OpenStreetMap のタイル、1 行につき 1 つのマーカー、ホバーラベル、そしてツールバーの「ポイント/ヒートマップ/両方」、ズーム、フィット、オプションのコントロール。経度と緯度の列を持つ結果の地図ウィンドウ: OpenStreetMap のタイル、1 行につき 1 つのマーカー、ホバーラベル、そしてツールバーの「ポイント/ヒートマップ/両方」、ズーム、フィット、オプションのコントロール。
経度と緯度の列を持つ結果の地図ウィンドウ: OpenStreetMap のタイル、1 行につき 1 つのマーカー、ホバーラベル、そしてツールバーの「ポイント/ヒートマップ/両方」、ズーム、フィット、オプションのコントロール。

地図を開く

  • 結果のグリッドから。 任意のセルを右クリックし、次を選択します ツール › 地図で表示…。結果セット全体が専用のマップウィンドウで開くので、作業中もグリッドの隣に置いておけます。
  • 自動的に。 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
地図上の 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)

値が空間図形である列もマップされます。ポイント、ラインストリング、ポリゴン(穴を含む)、それらのマルチ形式、ジオメトリコレクションです。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;
SQLly
ストリートマップ上に、WKT(Well-Known Text)列のポリゴンとラインを描画し、店舗をポイントとして表示します。ストリートマップ上に、WKT(Well-Known Text)列のポリゴンとラインを描画し、店舗をポイントとして表示します。
ストリートマップ上に、WKT(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 はタイルサーバーに接続しません。

  • 確認されるのは一度だけです。 地図を初めて開くと、ダウンロードされる内容を説明するプロンプトが表示されます。 マップタイルを読み込む タイルをオンにします; 今はやめてスケッチを使う オフのままにします。どちらの回答も記憶されます。
  • 地図画像のみ取得されます。 リクエストが求めるのは、画面上の領域をカバーするタイルだけです。クエリ結果、列名、座標がどこかに送信されることはありません。
  • マナーを守ったダウンロード。 同時にダウンロードされるタイルは最大 2 つで、表示している地図の部分に限られ (先読みは行いません)、リクエストは OpenStreetMap のタイル利用ポリシーが求めるとおり、バージョン付きで SQLly と名乗ります。
  • 帰属表示。 タイルが表示されている間、 © OpenStreetMap contributors 地図の右下隅にあります。クリックすると OpenStreetMap の著作権とライセンスのページが開きます。
  • 後でタイルをオンまたはオフにする場合。 使用 設定 › 結果 › 全般 › 地図 › OpenStreetMap から道路地図タイルを読み込む、または次の マップタイルをオンにする 拒否した後のマップのメモバーのボタン。
SQLly
新しい地図の初回利用時のプロンプト: 「OpenStreetMap からストリートマップを読み込みますか?」。「地図タイルを読み込む」と「今はしない(スケッチを使う)」の選択肢があります。新しい地図の初回利用時のプロンプト: 「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 は確認を止め、すでにキャッシュされているタイルを使用し、次を提案します 再試行.

SQLly
タイルを辞退した後に同じ結果をスケッチとして描画したもの: 無地の背景にマーカーを置き、薄い緯度/経度グリッドと「地図タイルをオンにする」ボタンを表示します。タイルを辞退した後に同じ結果をスケッチとして描画したもの: 無地の背景にマーカーを置き、薄い緯度/経度グリッドと「地図タイルをオンにする」ボタンを表示します。
タイルを辞退した後に同じ結果をスケッチとして描画したもの: 無地の背景にマーカーを置き、薄い緯度/経度グリッドと「地図タイルをオンにする」ボタンを表示します。

オプションパネル

クリック オプション マップのツールバー右側にあり、マップのすべての設定を含むパネルを開きます。変更はすぐにマップに反映されます。

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