Dans Kerry Studio, la carte dans les résultats dessine la géométrie arrivée dans la grille, à côté de la table. Sans cela, un POLYGON ou un POINT en WKT reste du texte dans la cellule. Le bouton Carte ouvre le découpage. Le fond utilise OpenStreetMap.

Comment l’utiliser

Il faut un workspace ouvert, un onglet SQL connecté et un résultat avec de la géométrie. Si le résultat n'a pas de colonne spatiale et pas de géométrie dans les cellules, le bouton Carte n'apparaît pas. Une colonne de texte avec du WKT, de l’EWKT ou du GeoJSON suffit pour la carte. Une colonne native (geometry, SDO_GEOMETRY, POINT et les autres) demande le support spatial du moteur, décrit dans Extensions par moteur.

Exécutez un SELECT qui renvoie une colonne spatiale, du WKT, de l’EWKT ou du GeoJSON.
Dans le panneau des résultats, cliquez sur Carte.
La grille et la carte restent ensemble. Glissez le séparateur si vous voulez plus de place pour la carte. L’icône d’agrandissement ouvre la carte dans une fenêtre superposée. Fermer la carte rend tout l’espace à la grille.
Dans la cellule de géométrie, le bouton Voir sur la carte ouvre une carte pour cette valeur seulement, comme le bouton JSON. Cette carte a un zoom avant, un zoom arrière et un ajustement à la vue. Un clic sur l’épingle ne ferme pas la carte.
À côté de Zoom avant et Zoom arrière, Ajuster à la vue cadre toutes les géométries du résultat. La première fois que la carte s’ouvre dans le découpage, dans la fenêtre superposée ou dans la carte de la cellule, ce cadrage est déjà appliqué. Dans la fenêtre superposée, la légende est plus grande.

La palette (⌘K / CtrlK) → Afficher ou masquer la carte des résultats fait la même chose. Le découpage ne s’ouvre pas tout seul. Si vous le laissez ouvert, l’onglet s’en souvient. Changer d’onglet n’emporte pas le zoom.

Texte

L’onglet Texte montre le WKT de ce qui est sélectionné sur la carte : une géométrie du résultat ou un dessin. Sans sélection, il demande de cliquer. Un élément sort uniquement en WKT, prêt à coller. Un groupe fusionné sort un seul WKT de l’union. Plusieurs éléments sortent en blocs avec le nom de la colonne ou Lasso 1, Rectangle 1, Ellipse 1. Shift, Ctrl ou ⌘ sur le pointeur ajoutent ou retirent un élément, sans ouvrir la fiche et sans déplacer la carte. Sur un MULTIPOLYGON, le clic prend seulement l’île cliquée et montre un POLYGON. Un clic sur le fond de la carte vide la sélection. Vous pouvez sélectionner ce texte avec la souris ou avec Shift et les flèches. Vous pouvez le copier, ou utiliser le bouton copier. ⌘A ou CtrlA sélectionne uniquement ce WKT. Le reste de la carte s’estompe pour que l’élément choisi reste visible. Quand tous les éléments sont choisis, rien ne s’estompe. L’épingle choisie porte un contour blanc. S’il y a plus d’un élément, le bas de la carte, au centre, indique la quantité.

Inverser lon/lat ne change que le dessin. La valeur dans la grille reste celle renvoyée par la base. L’interrupteur Étiquettes de la barre de la carte affiche le nom de la colonne sur chaque géométrie. Dans un groupe fusionné, les zones de la même colonne affichent le nom une fois sur l’union. Les épingles restent une par une. Il commence désactivé. Sur une épingle, le nom reste collé à côté et ne change pas de place quand vous zoomez. Sur une zone, le nom reste collé juste à l’extérieur du trait, pas à l’intérieur. Les couleurs suivent le thème en cours. Si deux noms occuperaient le même endroit, la carte n’affiche que ce qui tient. Zoomez pour voir le reste.

Dessin et SQL

Sélectionner est l’outil par défaut : cliquer un dessin ou une géométrie pour le choisir, faire glisser ce dessin pour le déplacer. Le glisser ne déplace pas la carte. Cliquez et faites glisser sur le fond de la carte pour sélectionner le dessin que le rectangle croise, pas l’espace vide autour. Shift, Ctrl ou ⌘ ajoutent à la sélection. ⌘A ou CtrlA sélectionne toutes les géométries et tous les dessins. Un clic sur un dessin déjà fermé choisit cet élément même avec le lasso, le rectangle ou l’ellipse activés. Main déplace la carte. Après un clic sur la carte, V, H, L, R et E choisissent Sélectionner, Main, Lasso, Rectangle et Ellipse. Ces raccourcis ne s’appliquent pas dans l’éditeur SQL. Changer d’outil au milieu du tracé annule ce tracé et passe au dessin dans la nouvelle forme. Lasso permet de dessiner plusieurs contours à main levée. Rectangle et Ellipse se dessinent en glissant. Shift sur le rectangle ou l’ellipse garde les côtés égaux. Chaque relâchement de la souris ferme un polygone et vous pouvez dessiner le suivant. Supprimer le dessin retire les dessins sélectionnés. Esc annule le tracé en cours, puis la sélection, puis revient au pointeur, et seulement ensuite ferme la fenêtre superposée. Fermer cette fenêtre ou la carte quitte le dessin et revient au pointeur. Les dessins déjà fermés restent jusqu’à une nouvelle requête. Changer d’onglet n’efface pas ces dessins ni les modes de la barre, comme Mesures.

Coller le polygone dans le SQL insère, au curseur de l’éditeur, le polygone sélectionné, ou tous les dessins s’il n’y en a aucun de sélectionné. Un polygone devient un POLYGON. Plusieurs deviennent l’union spatiale du dialecte de l’onglet. Un groupe fusionné colle l’union peinte sur la carte, géométrie de la requête et dessin ensemble. Si cette union est restée en pièces, le SQL collé emporte ces pièces. Mesures affiche le chiffre de chacune. L’épingle n’entre pas dans ce SQL. Sur PostgreSQL et MySQL, Kerry colle ST_GeomFromText. Sur Oracle, il colle SDO_GEOMETRY. Sur SQLite, il colle GeomFromText. Ce SQL demande les fonctions spatiales du moteur, les mêmes que dans Extensions par moteur. ST_Intersects reste le SQL du moteur de l’onglet. Ce bouton colle uniquement le polygone, sans la mesure. Copier le polygone met le même SQL dans le presse-papiers. Sans polygone, les deux boutons restent inactifs.

Fusionner transforme la sélection en un groupe, peint l’union en vert et vide le remplissage d’origine. Mesures n’a pas besoin d’être activé. Chaque nouveau dessin entre dans la sélection actuelle. Vous pouvez fusionner une géométrie de la requête avec un dessin. Vous pouvez donc en dessiner deux et les fusionner sans changer d’outil. Chaque fusion reste jusqu’à ce que vous choisissiez Séparer. Vous pouvez fusionner deux éléments, puis deux autres, sans défaire les groupes déjà faits. Un clic sur un membre choisit le groupe entier. Faire glisser un membre déplace le groupe entier. Si la sélection est exactement un groupe, le bouton devient Séparer. Si vous sélectionnez deux groupes et fusionnez, ils n’en forment plus qu’un. G fusionne. ShiftG sépare. Sans deux éléments ou plus de sélectionnés, le bouton ne fusionne rien. Si les zones ne se rencontrent pas, l’union reste en pièces séparées. ⌘Z ou CtrlZ annule créer, déplacer, supprimer et fusionner ou séparer. ⌘ShiftZ ou CtrlShiftZ rétablit. La barre a aussi Annuler et Rétablir. S’il n’y a rien à annuler ou à rétablir, ces boutons restent inactifs.

Mesures

Mesures dans la barre de la carte affiche la taille de chaque polygone, dans l’unité choisie : m², ha ou km². Le chiffre de la légende, de la pastille de sélection et de l’étiquette du polygone porte cette unité. Dans un MULTIPOLYGON, chaque île reçoit son propre chiffre sur la carte. Le calcul utilise les coordonnées de la cellule, ou le lon/lat du dessin. Il active aussi le total de la colonne. Les copies identiques du même polygone, comme celles qu’un JOIN empile, ne comptent qu’une fois dans ce total. Avec un groupe fusionné, l’étiquette verte de l’union et la ligne Fusions de la légende affichent le même total. La pastille de sélection n’affiche aussi que l’union. Sans Fusionner, deux éléments sélectionnés montrent le total et le chevauchement. Si le système de coordonnées ne permet pas ce calcul, le polygone reste sur la carte et le chiffre n’apparaît pas. Les points et les lignes n’entrent pas dans le calcul. Une nouvelle requête efface les dessins et leur mesure disparaît avec eux. L’unité choisie reste tant que la carte est ouverte. Changer d’onglet ne désactive pas Mesures.

Colonnes sur la carte

Chaque colonne de géométrie du résultat reçoit une couleur. Le point et la surface utilisent des palettes différentes. Le point reprend l’épingle de carte de l’interface. La légende utilise le nom de la colonne, ou l’alias si le SELECT en a un. Si le SELECT a i.localizacao AS moradia et z.geom AS inundacao, la légende affiche moradia et inundacao. Le JOIN reste dans le SQL. La carte ne peint que ce qui est déjà arrivé dans le résultat. Un clic sur l’épingle ouvre une fiche avec le nom de cette colonne en titre et les autres valeurs de la ligne (texte, nombre, date). La géométrie n’entre pas dans la fiche. Si le résultat n’a que des zones, le clic sur la zone ouvre la fiche. Avec épingles et zones ensemble, la zone n’ouvre pas la fiche, pour ne pas mélanger les lignes du même JOIN.

Couches, image et impression

Le fond par défaut est OpenStreetMap. Le sélecteur de fond n’apparaît que lorsque vous ajoutez une autre couche dans Paramètres, sous Couches de carte, avec une URL HTTPS de tuiles {z}/{x}/{y}. Si le fond échoue, les polygones restent sur le fond neutre.

Le menu Exporter la carte ouvre PNG, SVG, WebP et GeoJSON. PNG, SVG et WebP enregistrent la carte des géométries du résultat, avec le fond de rues, à la taille du contenu. Le recadrage à l’écran ne définit pas le fichier. L’interrupteur Étiquettes est activé au départ et écrit le nom de la colonne (ou l’alias du SELECT) au même endroit que la carte : juste à l’extérieur du trait de chaque zone et à côté de chaque épingle. Le même menu a Thème de l'image, avec Sombre et Clair. Les couleurs des noms et de la légende suivent ce thème. Le même menu a Mesures, le sélecteur d’unité (m², ha ou km²) et Fusions. Ils ne valent que pour le fichier. Vous pouvez exporter les chiffres sans activer Mesures dans la barre. Avec Mesures activé dans ce menu, le fichier reprend les chiffres d’aire, le remplissage du chevauchement et les totaux dans la légende. Avec Fusions activé, les unions déjà faites sur la carte entrent dans le fichier telles qu’elles sont groupées. Si l’union est faite de zones de la même colonne, le fichier affiche ce nom une seule fois sur l’union. Les épingles restent une par une. Fusions dans le fichier n’exigent pas Mesures dans ce menu. S’il y a des dessins sur la carte, l’interrupteur Dessins est aussi activé au départ et dessine ces polygones dans le fichier. Vous pouvez le désactiver pour n’exporter que les géométries de la requête. GeoJSON enregistre les géométries de la carte, sans le fond de rues. La requête entre toujours. Dessins et fusions entrent si ces interrupteurs sont activés. Avec Mesures activé, chaque géométrie porte l’aire. Avec Étiquettes activé, le nom de la colonne entre. Si une fusion est restée en pièces, le fichier emporte ces pièces. Imprimer utilise les mêmes interrupteurs et le thème de l'image. Les crédits du fond de rues restent comme sur la carte. PNG et WebP sont du raster en haute résolution. SVG place le fond de rues en haute résolution et les géométries en vecteur. Imprimer ouvre la boîte de dialogue d’impression de cette carte avec le fond.

Extensions par moteur

Les types natifs dans créer une table et modifier une table, et le SQL collé avec ST_GeomFromText, SDO_GEOMETRY ou GeomFromText, demandent le support spatial du moteur. Kerry n’installe pas cette extension pour vous. La carte continue de dessiner le WKT, l’EWKT et le GeoJSON déjà arrivés dans la cellule.

PostgreSQL. Demande l’extension PostGIS. Sans elle, GEOMETRY et GEOGRAPHY apparaissent dans créer une table et modifier une table, et Kerry prévient que le type demande PostGIS. Dans PostgreSQL lui-même, CREATE EXTENSION postgis installe PostGIS sur la base.

MySQL et MariaDB. Les types spatiaux sont natifs (GEOMETRY, POINT, POLYGON et les autres). Il n’y a pas d’extension supplémentaire.

Oracle. Demande Locator ou Spatial. Sans le type SDO_GEOMETRY sur la base, Kerry prévient dans créer une table et modifier une table. Avec ce support, la colonne est SDO_GEOMETRY.

SQLite. Demande SpatiaLite. Dans la connexion SQLite, sous Extensions, ajoutez le fichier de l’extension et activez Charger à la connexion. Tant que SpatiaLite n’est pas chargé, les types spatiaux n’entrent pas dans la liste. Une fois chargé, GEOMETRY, POINT, POLYGON et les autres types SpatiaLite apparaissent.

Détails

La carte n’est pas un troisième mode d’affichage du résultat. Elle partage le panneau avec la grille.
Le dessin suit le WKT de la cellule. Un POLYGON à quatre coins apparaît comme un rectangle, parce que c’est ce que la valeur décrit. Un MULTIPOLYGON avec beaucoup de sommets apparaît avec le contour irrégulier de ces sommets.
Le type dans l’infobulle de la colonne est le type du catalogue. Un point PostGIS apparaît comme geometry(Point,4326), pas seulement geometry. L’icône spatiale vaut pour chacun de ces types.
Elle fonctionne sur les quatre moteurs de l’onglet : PostgreSQL, MySQL/MariaDB, Oracle et SQLite.
Une requête avec @projet.table d’un autre projet matérialise les lignes sur la connexion de l’onglet. Si cette destination a un GIS, la table temporaire utilise le type spatial natif. Sinon, la géométrie part en texte EWKT.