Kerry Studio では、結果の地図がグリッドに届いたジオメトリをテーブルの横に描きます。これがないと、セルの POLYGON や POINT の WKT はただの文字列です。地図ボタンで分割を開きます。背景は OpenStreetMap です。

使い方

開いている workspace、接続済みの SQL タブ、ジオメトリのある結果が必要です。結果に空間列がなく、セルにもジオメトリがない場合、地図ボタンは表示されません。テキスト列の WKT、EWKT、GeoJSON があれば地図は開きます。ネイティブ列（geometry、SDO_GEOMETRY、POINT など）はエンジンの空間対応が必要です。内容はエンジンごとの拡張にあります。

空間列、WKT、EWKT、または GeoJSON を返す SELECT を実行します。
結果パネルで地図をクリックします。
グリッドと地図は並びます。分割バーをドラッグすると地図を広げられます。展開アイコンは地図をオーバーレイウィンドウで開きます。地図を閉じる でスペース全体がグリッドに戻ります。
ジオメトリのセルでは、地図で表示 がその値だけの地図を開きます。JSON セルのボタンと同じです。この地図には拡大、縮小、全体を表示があります。ピンをクリックしても地図は閉じません。
拡大と縮小の横にある 全体を表示 は、結果のジオメトリをすべて画面に収めます。分割、オーバーレイ、セルの地図を初めて開いたとき、この収め方はすでに適用されています。オーバーレイウィンドウでは凡例が大きくなります。

パレット（⌘K / CtrlK）→ 結果マップの表示を切り替え も同じです。分割は自動では開きません。開いたままにすると、そのタブが覚えます。タブを切り替えてもズームは持ち越しません。

テキスト

テキストペインは、地図上で選んでいるものの WKT を表示します。結果のジオメトリでも描画でも同じです。何も選んでいないときは、クリックするように案内します。1 件なら WKT だけなので、そのまま貼れます。結合したグループは合併の WKT が 1 つです。複数なら列名や ラッソ 1、長方形 1、楕円 1 のブロックになります。ポインターで Shift、Ctrl、⌘ を使うと項目を足したり外したりできます。そのときカードは開かず、地図も動きません。MULTIPOLYGON では、クリックした島だけを POLYGON として出します。地図の背景をクリックすると選択が消えます。マウスでも、Shift と矢印キーでも、そのテキストを選べます。コピーもできます。コピーボタンも使えます。⌘A または CtrlA はその WKT だけを選びます。選んだものが目立つように、地図の残りは薄くなります。すべて選んでいるときは薄くしません。選んだピンには白い輪郭が付きます。2 件以上のときは、地図の下中央に件数が出ます。

経度と緯度を入れ替え は描画だけを変えます。グリッドの値はデータベースが返したもののままです。地図バーの ラベル スイッチを入れると、各ジオメトリに列名が出ます。結合したグループでは、同じ列のエリアの列名は合併に一度だけ出ます。ピンはそれぞれ出ます。最初はオフです。ピンでは名前が横に貼りつき、ズームしても場所を変えません。エリアでは線の外側に出ます。内側には出しません。色は使っているテーマに合わせます。同じ場所に二つの名前が重なるときは、収まる分だけ出します。ズームインすると残りが見えます。

描画と SQL

選択が既定のツールです。描画またはジオメトリをクリックして選び、その描画をドラッグして動かします。ドラッグでは地図は動きません。地図の背景をクリックしたままドラッグすると、矩形が交差する描画を選びます。周りの空白では選びません。Shift、Ctrl、⌘ で選択に足します。⌘A または CtrlA ですべてのジオメトリと描画を選択します。閉じ済みの描画をクリックすると、ラッソ、長方形、楕円がオンでもその項目を選べます。手のひらで地図をパンします。地図をクリックしたあと、V、H、L、R、E で選択、手のひら、ラッソ、長方形、楕円を切り替えます。これらのショートカットは SQL エディターでは効きません。描きかけの線の途中でツールを変えると、その線は取り消され、新しい形で描き直します。ラッソでは自由な輪郭をいくつでも描けます。長方形と楕円はドラッグで描きます。長方形や楕円で Shift を押すと辺の長さがそろいます。マウスを離すたびにポリゴンが閉じ、次を描けます。描画を削除は選んだ描画を消します。Esc は描きかけの線を取り消し、次に選択を解除し、次にポインターへ戻り、そのあとでオーバーレイを閉じます。そのウィンドウや地図を閉じると描画を終えてポインターに戻ります。閉じ済みの描画は新しいクエリまで残ります。タブを切り替えても、これらの描画は消えません。測量などのバーのモードもそのままです。

ポリゴンを SQL に貼る は、選んだポリゴンをエディターのカーソルへ挿入します。何も選んでいなければ描画全部です。1 つなら POLYGON です。複数ならタブの方言の空間結合になります。結合したグループは、地図に塗った結合そのものを貼ります。クエリのジオメトリと描画が入ります。その結合が分かれたピースのままなら、貼った SQL はそのピースになります。測量はそれぞれの数字を出します。ピンはその SQL に入りません。PostgreSQL と MySQL では Kerry が ST_GeomFromText を貼ります。Oracle では SDO_GEOMETRY を貼ります。SQLite では GeomFromText を貼ります。この SQL はエンジンの空間関数を使います。エンジンごとの拡張と同じものです。ST_Intersects はタブのエンジンの SQL のままです。このボタンはポリゴンだけを貼ります。面積は入りません。ポリゴンをコピー は同じ SQL をクリップボードに入れます。ポリゴンがなければ、どちらのボタンも無効のままです。

結合は選択をグループにし、合併を緑で塗り、元の塗りを空にします。測量はオンでなくて構いません。新しい描画は今の選択に足されます。クエリのジオメトリと描画を結合できます。ツールを変えずに 2 つ描いて結合できます。結合は 結合を解除 を選ぶまでまとまったままです。2 件を結合してから、別の 2 件を結合しても、すでにまとめたグループは解けません。メンバーをクリックするとグループ全体が選ばれます。メンバーをドラッグするとグループ全体が動きます。選択がちょうど 1 つのグループなら、ボタンは 結合を解除 になります。2 つのグループを選んで結合すると、1 つになります。G で結合します。ShiftG で結合を解除します。2 件未満しか選んでいなければ、ボタンは何も結合しません。面が接していなければ、合併は別々のピースのままです。⌘Z または CtrlZ は作成、移動、削除、結合と結合の解除を取り消します。⌘ShiftZ または CtrlShiftZ はやり直します。バーにも 取り消す と やり直す があります。取り消すこともやり直すこともなければ、これらのボタンは無効のままです。

測量

測量は地図バーで各ポリゴンの大きさを、選んだ単位（m²、ha、km²）で出します。凡例、選択チップ、ポリゴンのラベルの数字にはその単位が付きます。MULTIPOLYGON では、各島が地図上に自分の数字を出します。数字はセルの座標、または描いた図の経度・緯度から出ます。列の合計も出ます。JOIN が重ねた同じポリゴンのコピーは、その合計に一度だけ入ります。結合したグループでは、緑の合併ラベルと凡例の結合グループ行が同じ合計を出します。選択チップも合併だけを出します。結合していなければ、2 件選ぶと合計と重なりが出ます。座標系がその計算を許さないときは、ポリゴンは地図に残り、数字は出ません。ポイントとラインは対象外です。新しいクエリは描画を消し、その測量も消えます。地図を開いている間、選んだ単位はそのままです。タブを切り替えても測量はオフになりません。

地図上の列

結果のジオメトリ列ごとに色が付きます。ポイントと面は別の配色です。ポイントは画面の地図ピンを使います。凡例は列名です。SELECT にエイリアスがあればその名前です。SELECT が i.localizacao AS moradia と z.geom AS inundacao なら、凡例は moradia と inundacao です。JOIN は SQL に残ります。地図は結果に既にあるものだけを塗ります。ピンをクリックすると、その列名を見出しにしたカードが開き、同じ行のほかの値（文字列、数値、日付）が出ます。ジオメトリ本体はカードに入りません。結果がエリアだけのときは、エリアのクリックでカードが開きます。ピンとエリアが両方あるときは、JOIN の行が混ざらないよう、エリアではカードを開きません。

レイヤー、画像、印刷

既定の背景は OpenStreetMap です。設定の 地図レイヤー で別のレイヤー（{z}/{x}/{y} を含む HTTPS のタイル URL）を追加したときだけ、背景のセレクターが出ます。背景が失敗しても、ポリゴンは中立の背景に残ります。

地図をエクスポート のメニューは PNG、SVG、WebP、GeoJSON を開きます。PNG、SVG、WebP は結果のジオメトリの地図を、道路の背景つきで、内容のサイズで保存します。画面上の切り抜きはファイルを決めません。ラベル のスイッチは最初からオンで、地図と同じ位置に列名（または SELECT の別名）を書きます。エリアは線の外側、ピンは横です。同じメニューに 画像のテーマ があり、ダーク と ライト を選べます。名前と凡例の色はそのテーマに従います。同じメニューに測量、単位（m²、ha、km²）、結合グループ もあります。ファイル用です。地図バーで測量をオンにしなくても数字を書き出せます。そのメニューで測量がオンなら、面積の数字、重なりの塗り、凡例の合計もファイルに入ります。結合グループがオンなら、地図ですでに作った合併がグループのままファイルに入ります。合併が同じ列のエリアなら、ファイルはその列名を合併に一度だけ出します。ピンはそれぞれ出ます。ファイルの結合グループに、そのメニューの測量は不要です。地図に描画があるとき、描画のスイッチも最初からオンで、それらのポリゴンをファイルに描きます。オフにすればクエリのジオメトリだけを書き出せます。GeoJSON は地図のジオメトリを書き出します。道路の背景は入りません。クエリは必ず入ります。描画と結合グループは、そのスイッチがオンなら入ります。測量がオンなら、各ジオメトリに面積が付きます。ラベルがオンなら、列名が入ります。結合が分かれたピースのままなら、ファイルはそのピースを出します。印刷も同じスイッチと画像のテーマを使います。道路の背景のクレジットは地図上と同じままです。PNG と WebP は高解像度のラスターです。SVG は道路の背景を高解像度で入れ、ジオメトリはベクターです。印刷はその地図の印刷ダイアログを開きます。

エンジンごとの拡張

テーブルの作成と変更のネイティブ型、および貼る ST_GeomFromText、SDO_GEOMETRY、GeomFromText は、エンジンの空間対応が必要です。Kerry がその拡張を入れてくれることはありません。セルに既にある WKT、EWKT、GeoJSON は、地図がそのまま描きます。

PostgreSQL。 PostGIS 拡張が必要です。ないと、テーブルの作成と変更に GEOMETRY と GEOGRAPHY が出て、Kerry はその型に PostGIS が必要だと知らせます。PostgreSQL 側では CREATE EXTENSION postgis でデータベースに PostGIS を入れます。

MySQL と MariaDB。 空間型はネイティブです（GEOMETRY、POINT、POLYGON など）。追加の拡張はありません。

Oracle。 Locator または Spatial が必要です。データベースに SDO_GEOMETRY 型がないと、Kerry はテーブルの作成と変更で知らせます。対応があるときの列は SDO_GEOMETRY です。

SQLite。 SpatiaLite が必要です。SQLite 接続の拡張で拡張ファイルを追加し、接続時に読み込む をオンにします。SpatiaLite が読み込まれるまで、空間型は一覧に出ません。読み込まれると、GEOMETRY、POINT、POLYGON など SpatiaLite の型が出ます。

詳細

地図は結果の第三の表示モードではありません。グリッドとパネルを分けます。
描画はセルの WKT に従います。四隅の POLYGON は矩形に見えます。値がその形だからです。頂点の多い MULTIPOLYGON は、その頂点のいびつな輪郭として描かれます。
列のツールチップの型はカタログの型です。PostGIS の点は geometry だけではなく geometry(Point,4326) と出ます。空間アイコンはこれらの型のどれでも付きます。
タブの 4 つのエンジンで動きます。PostgreSQL、MySQL/MariaDB、Oracle、SQLite です。
別プロジェクトの @プロジェクト.テーブル のクエリは、行をタブ接続の一時テーブルに載せます。その先に GIS があればネイティブの空間型を使い、なければ EWKT テキストになります。