Vue carte
fonctionnelPlacez les réponses GEO de Redis, les colonnes longitude/latitude et les formes WKT ou WKB sur une carte OpenStreetMap que vous pouvez déplacer et zoomer, avec un clic qui mène à la ligne correspondante.
Lorsqu'un résultat contient des emplacements, un Redis GEOSEARCH réponse, un tableau avec des colonnes de longitude et de latitude, ou une colonne de formes spatiales - SQLly peut les dessiner sur une carte routière que vous pouvez déplacer et zoomer. Survolez un point pour voir à quelle ligne il appartient, cliquez dessus pour aller à cette ligne dans la grille, et passez à un carte thermique
quand il y a trop de points à lire un par un.


Ouvrir une carte
- À partir de la grille des résultats. Cliquez avec le bouton droit sur n'importe quelle cellule et choisissez Outils › Afficher sur la carte…. L'ensemble complet des résultats s'ouvre dans sa propre fenêtre de carte, afin que vous puissiez le garder à côté de la grille pendant que vous travaillez.
- Automatiquement. A
-- sqlly map:ligne avecopen=auto, ou-- sqlly view: mapcomme première ligne de la requête, ouvre la carte chaque fois que la requête se termine. - À partir d'une seule valeur géométrique. Cliquez avec le bouton droit sur une cellule contenant une forme et choisissez Afficher la géométrie… (ou sélectionnez-la avec le panneau Détails de la cellule ouvert). La barre d'outils du visualiseur a un Esquisse / Carte / Brut commutateur ; Carte met cette seule forme sur la carte routière.
Ce qui peut être cartographié
Réponses Redis GEO
GEOSEARCH, GEORADIUS, GEORADIUSBYMEMBER, et
GEOPOS reviennent sous forme de grille avec member, dist,
lon, et lat colonnes lorsque vous demandez des coordonnées. Ajoutez
WITHCOORD pour que la réponse les contienne :
GEOSEARCH stores FROMLONLAT -0.1278 51.5074 BYRADIUS 50 km WITHCOORD WITHDIST ASC
Chaque membre devient un point, étiqueté avec son nom. Les champs de formes géographiques des réponses Redis search (FT.SEARCH sur une GEOSHAPE champ) arrivent sous forme de texte bien connu et sont interprétés comme n'importe quelle autre colonne de géométrie.


Colonnes de longitude et de latitude
Tout résultat avec une colonne de longitude et une colonne de latitude peut être affiché sur une carte. SQLly les repère par leur nom, sans tenir compte de la casse, en examinant les mots du nom de colonne :
- Longitude - un mot
lon,lng,long, oulongitude:lon,LNG,pickup_lon,StartLongitude. - Latitude - un mot
latoulatitude:lat,dropoff_lat,EndLatitude.
Les mots sont séparés par des underscores, des espaces, des points, des tirets et des lettres majuscules, donc
latency, plate, ou longest ne sont jamais confondus avec des coordonnées. Les valeurs peuvent être des nombres ou du texte numérique. Les lignes avec une valeur manquante, ou une longitude en dehors de -180 à 180 ou une latitude en dehors de -90 à 90, sont exclues de la carte et comptées dans la barre d'outils comme lignes sans localisation.
Lorsqu'il y a plus d'une paire - disons pickup_lon/pickup_lat
et dropoff_lon/dropoff_lat - les colonnes qui partagent le reste de leur nom sont appariées, et la carte s'ouvre avec son Options panneau affiché, où le Emplacements sélecteur bascule entre eux (ou écrivez lat= et
lon= dans un directive de carte). Si rien n'est apparié par nom, chaque combinaison longitude/latitude est proposée.
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
Colonnes de géométrie (WKT et WKB)
Une colonne dont les valeurs sont des formes spatiales est elle aussi cartographiée : points, polylignes, polygones (trous compris), leurs variantes multi- et les collections de géométrie. SQLly lit :
- Texte bien connu - éventuellement avec un préfixe SRID :
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - Binaire bien connu - en tant qu'octets ou en texte hexadécimal, ce qui est la manière dont PostGIS retourne une
geometrycolonne par défaut - y compris la forme étendue qui porte un SRID, et le format de valeur spatiale propre à MySQL.
Une colonne est considérée comme géométrie lorsque son type est spatial (geometry,
geography, point, et ainsi de suite) et qu'au moins une de ses 20 premières valeurs non NULL est analysable, ou lorsque toutes ses 20 premières valeurs non NULL sont analysables quel que soit le type. Une forme en plusieurs parties est dessinée comme ses parties, toutes étiquetées sur la même ligne. Les octets natifs geometry/geography octets ne sont pas du well-known binary, donc sélectionnez shape.STAsText() ou shape.STAsBinary() au lieu de la colonne brute.
SELECT name, boundary.STAsText() AS boundary FROM dbo.DeliveryZones;


SRID=27700 - sont toujours dessinées, déplaçables et zoomables, mais comme un croquis sans la carte routière, avec une note indiquant le SRID. SQLly ne les reprojette pas ; transformez-les dans la requête (par exemple ST_Transform(geom, 4326) dans PostGIS) pour les voir sur la carte.Tuiles de la carte routière provenant d'OpenStreetMap
La carte routière est composée de tuiles d'images du projet OpenStreetMap, téléchargées depuis
tile.openstreetmap.org. SQLly ne contacte jamais le serveur de tuiles tant que vous ne le lui demandez pas.
- On vous le demande une seule fois. La première fois qu'une carte s'ouvre, une invite explique ce qui serait téléchargé. Charger les tuiles de carte active les tuiles ; Pas maintenant, utiliser un croquis les laisse désactivées. Votre choix est mémorisé dans les deux cas.
- Seules les images de la carte sont récupérées. Les requêtes demandent uniquement les tuiles couvrant la zone affichée à l'écran, rien d'autre. Les résultats de vos requêtes, les noms de colonnes et les coordonnées ne sont jamais envoyés nulle part.
- Téléchargement poli. Au maximum deux tuiles sont téléchargées à la fois, seulement pour la partie de la carte que vous regardez (rien n'est récupéré à l'avance), et les requêtes s'identifient comme SQLly avec sa version, comme le demande la politique d'utilisation des tuiles d'OpenStreetMap.
- Attribution. Pendant que les tuiles s'affichent, © Contributeurs OpenStreetMap se trouve dans le coin inférieur droit de la carte ; cliquez dessus pour ouvrir la page de copyright et de licence d'OpenStreetMap.
- Activer ou désactiver les tuiles plus tard. Utilisez Paramètres › Résultats › Général › Cartes › Charger les tuiles de la carte routière depuis OpenStreetMap, ou le Activer les tuiles de la carte bouton dans la barre de notes de la carte après avoir refusé.


Le cache des tuiles
Chaque tuile est enregistrée sur votre ordinateur et réutilisée pendant 14 jours avant d'être téléchargée à nouveau, donc revisiter une zone ne coûte rien et le serveur de tuiles n'est pas sollicité deux fois. Les tuiles se trouvent dans un
map-tiles dossier dans le dossier de données de SQLly :
| Plateforme | Dossier |
|---|---|
| macOS | ~/Library/Application Support/SQLLY/map-tiles |
| Windows | %APPDATA%\SQLLY\map-tiles |
| Linux | ~/.local/share/SQLLY/map-tiles |
Vous pouvez supprimer le dossier à tout moment sans risque ; les tuiles sont récupérées à nouveau au besoin.
Sans tuiles : le croquis
Si vous refusez les tuiles, êtes hors ligne ou utilisez SQLly dans le navigateur, la carte fonctionne toujours : les mêmes points, lignes et polygones sont tracés sur un fond uni avec une légère grille de méridiens et de parallèles espacés de 30°, et le panoramique, le zoom, l'ajustement, le survol, le clic et la carte thermique se comportent pareil. Une note sous la barre d'outils explique pourquoi il n'y a pas de carte routière. Quand un téléchargement échoue parce que le serveur de tuiles est injoignable, SQLly cesse de demander, utilise les tuiles déjà en cache, et propose Réessayer.


Le panneau Options
Cliquez Options à droite de la barre d'outils de la carte pour ouvrir un panneau avec tous les paramètres de la carte. Chaque changement redessine la carte immédiatement.
- Données - Emplacements (Automatique, ou l'une des paires longitude/latitude détectées ou des colonnes de géométrie), Étiquette (le titre au survol), Colonnes des info-bulles (lignes supplémentaires dans l'infobulle au survol), Couleur selon (une palette pour le texte, un dégradé pour les nombres, avec une légende en dessous), et Taille selon (des marqueurs plus grands pour des nombres plus grands).
- Couches - Afficher points, un carte thermique, ou les deux ; Regrouper les marqueurs regroupe les marqueurs qui s'entassent en un seul cercle (survolez-le pour le nombre, cliquez pour zoomer) ; et, pour la carte thermique, poids, rayon, flou, intensité, opacité et palette.
- Carte - Carte routière activé ou désactivé pour ce résultat, quoi cliquer ce que fait un clic sur un élément, si la carte s'ouvre à l'exécution, le la plupart des fonctionnalités pour dessiner, et le vue initiale (adjuster aux données, ou se souvenir de la vue que vous regardez maintenant).
- Directive - la
-- sqlly map:ligne que ces paramètres créent. Copier la met dans le presse-papiers ; Écrire dans la requête l'écrit dans le bloc de verrouillage de la requête, de sorte que la carte revienne de la même manière à chaque exécution, pour quiconque ouvre le fichier.


Se déplacer
| Pour | Faire ceci |
|---|---|
| Déplacer | Faites glisser la carte. Elle s'enroule autour du globe horizontalement, vous pouvez donc continuer à faire glisser au-delà de la ligne de changement de date. |
| Zoom | Faites tourner la molette de la souris ou pincez sur un trackpad - l'endroit sous le pointeur reste en place - ou utilisez les − et + boutons, qui zooment d'un niveau autour du centre. Les cartes de rues vont de l'ensemble du monde (niveau 0) au niveau de la rue (niveau 19). |
| Voir tout | Ajuster zoome pour que chaque élément tracé soit dans la vue. Une carte s'ouvre ajustée. Les données de part et d'autre de la ligne de changement de date sont cadrées par le chemin le plus court. |
| Identifier une fonctionnalité | Survolez-le. L'infobulle affiche le nom de la ligne : un Redis member, ou une colonne appelée key, name, label, title, ou id, sinon la première colonne de texte ; à défaut, le numéro de ligne. |
| Trouvez sa ligne | Cliquez dessus. La fonctionnalité est mise en surbrillance et la ligne est sélectionnée puis amenée à l'écran par défilement dans la grille d'où vient la carte (désactivez ceci avec Cliquez sur une fonctionnalité dans le panneau Options, ou click=none). |
| Ouvrir un cluster | Avec Regrouper les marqueurs activé, les marqueurs rapprochés deviennent un cercle ; survolez-le pour voir combien d'emplacements il contient, cliquez dessus pour zoomer jusqu'à ce qu'il se sépare. |
Cliquer sélectionne les lignes de la grille pour les résultats ouverts avec Afficher sur la carte ; une carte ouverte depuis l'onglet Pivot ou depuis une valeur unique dans le visualiseur n'a pas de lignes à sélectionner. Pour un très grand résultat dont les lignes sont chargées par pages depuis le disque, un clic ne sélectionne la ligne que pendant que cette partie du résultat est chargée dans la grille.
Résultats très volumineux
Une carte dessine au maximum 50 000 entités (moins si vous réglez La plupart des fonctionnalités dans le panneau Options, ou limit=). Passé cela, les 50 000 premiers sont tirés et la barre d'outils indique Affichage de 50 000 des N entités, afin que vous sachiez toujours quand une partie des données est manquante. Chaque partie d'une forme multipartie compte comme une caractéristique. La carte lit les lignes que la grille a en mémoire, donc pour un résultat trop volumineux pour être contenu, filtrez-le ou échantillonnez-le dans la requête, ou agrégez-le, lorsque vous avez besoin de voir l'ensemble.
La directive map
A -- sqlly map: commentaire dans la requête définit comment son résultat est mappé, de la même manière grid: définit la grille. C'est ce que le bouton du panneau Options Écrire dans la requête écrit, et chaque paramètre ci-dessous peut également être modifié depuis le panneau.
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
Les paramètres sont key=value, séparés par ;, dans n'importe quel ordre. Sans numéro, la ligne s'applique à chaque ensemble de résultats de l'exécution; map 2: s'applique uniquement au deuxième, en comptant à partir de 1. Lorsque plusieurs lignes s'appliquent, les réglages ultérieurs remplacent les précédents. Les noms de colonnes correspondent en ignorant la casse et sont écrits entre guillemets doubles lorsqu'ils contiennent un espace ou l'un des , ; : = " | (doublez un guillemet à l'intérieur).
| Paramètre | Sens | Exemple |
|---|---|---|
lat=col; lon=col | Les colonnes de latitude et de longitude. Remplace la détection par nom ; les deux sont nécessaires. | lat=y; lon=x |
geom=col | Une colonne de géométrie en well-known text ou en binaire. Outrepasse la détection. | geom=boundary |
srid=n | Le système de coordonnées des données. Toute valeur autre que 4326 est dessinée comme un croquis sans la carte des rues. | srid=27700 |
label=col | Le titre au survol. Par défaut : member, key, name, label, title, id, ou la première colonne de texte. | label=store_name |
tooltip=a, b | Supplémentaire column: value lignes dans l'infobulle. | tooltip=city, revenue |
mode=points|heatmap|both | Marqueurs, une carte thermique, ou la carte thermique avec des marqueurs par-dessus. Les lignes et les polygones sont toujours dessinés. | mode=both |
color=col | Colorer les marqueurs et les formes par colonne : jusqu'à 12 couleurs pour les valeurs textuelles (le reste partage une couleur), un dégradé pour les nombres. | color=region |
size=col | Ajuster la taille des marqueurs selon une colonne numérique, de la plus petite à la plus grande valeur. | size=revenue |
weight=col | Pondérer la chaleur de chaque emplacement par une colonne numérique (NULL et négatif comptent comme 0). | weight=orders |
radius=px | Distance de propagation de la chaleur de chaque emplacement, de 6 à 120 pixels d'écran (par défaut 24). | radius=30 |
blur=px | Adoucissement supplémentaire de la chaleur, de 0 à 200 pixels (par défaut 0). | blur=12 |
intensity=n | Renforce les faibles valeurs de chaleur vers l'extrémité chaude, de 0 à 10 (1 par défaut). | intensity=2 |
opacity=n | Opacité maximale de la couche de chaleur, de 0 à 1 (par défaut 0,8). | opacity=0.6 |
palette=name | Couleurs de la chaleur : heat (du bleu au rouge, par défaut), fire, viridis (adapté aux daltoniens), ocean, ou accent (la couleur d'accent de votre thème). | palette=viridis |
cluster=on|off | Regrouper les marqueurs serrés en cercles comptés. | cluster=on |
basemap=osm|none | La carte des rues OpenStreetMap, ou aucune pour ce résultat. osm ne télécharge jamais de tuiles que vous n'avez pas acceptées. | basemap=none |
center=lat,lon; zoom=n | La vue de départ ; zoom de 0 (monde) à 19 (rue). | center=51.5,-0.12; zoom=10 |
fit=data | Démarrage cadré sur toutes les entités (par défaut ; remplace le centre et le zoom). | fit=data |
limit=n | Nombre maximal d'éléments à dessiner ; toute valeur supérieure à 50 000 compte pour 50 000. | limit=5000 |
click=select|none | Le clic sur un élément sélectionne sa ligne dans la grille (par défaut select). | click=none |
open=auto|manual | Ouvrir la carte automatiquement chaque fois que la requête se termine, ou seulement à partir de Afficher sur la carte… (par défaut). | open=auto |
-- sqlly view: map comme la première ligne de la requête est un raccourci pour
open=auto sur le premier résultat : la grille s'ouvre comme d'habitude et la fenêtre de la carte s'ouvre à côté. Lorsqu'une carte pour le résultat est déjà ouverte, une nouvelle exécution actualise cette fenêtre au lieu d'en ouvrir une autre.
Un paramètre mal orthographié ou une valeur incorrecte est souligné dans l’éditeur avec l’explication (par exemple Directive map : paramètre inconnu « colour »); les autres paramètres sur la ligne s'appliquent toujours et la requête s'exécute normalement. Une colonne que le résultat n'a pas est ignorée, et la fenêtre de la carte indique lesquelles ont été ignorées.
Exemples
Stocke sous forme de points, étiquetés, avec la ville dans l'infobulle :
-- sqlly map: lat=latitude; lon=longitude; label=store_name; tooltip=city
SELECT store_name, city, latitude, longitude FROM stores;
Une carte thermique des commandes, pondérée par le nombre de commandes :
-- 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;
Marqueurs colorés, dimensionnés et regroupés pour le deuxième résultat, ouverts à chaque exécution :
-- sqlly map 2: color=region; size=revenue; cluster=on; open=auto
SELECT COUNT(*) FROM branches;
SELECT branch, region, revenue, lat, lon FROM branches;
Un Redis GEOSEARCH, ouvert automatiquement sur la carte :
-- 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
Formes projetées, dessinées comme un croquis :
-- sqlly map: geom=boundary; srid=27700; basemap=none
SELECT name, ST_AsText(boundary) AS boundary FROM parishes;
Dans le navigateur
Le version navigateur SQLly ne télécharge jamais de tuiles de carte. Afficher sur la carte et le mode carte du visualiseur ouvrent directement le croquis, sans invite, avec une note indiquant que les tuiles ne sont pas disponibles dans le navigateur.