Вид карты
функциональныйПоказывайте ответы Redis GEO, столбцы с долготой и широтой и геометрии WKT или WKB на уличной карте OpenStreetMap, которую можно двигать и масштабировать, а клик по точке ведёт прямо к строке.
Когда в результате есть местоположения, ответ Redis GEOSEARCH ответ, таблица со столбцами долготы и широты или столбец с пространственными фигурами — SQLly нарисует их на карте улиц, которую можно перемещать и масштабировать. Наведите указатель на точку, чтобы увидеть, какой она соответствует строке, кликните её, чтобы перейти к этой строке в сетке, и переключитесь на тепловую карту
когда точек слишком много, чтобы просматривать их по одной.


Открытие карты
- Из сетки результатов. Щёлкните правой кнопкой мыши по любой ячейке и выберите Инструменты › Показать на карте…. Весь набор результатов открывается в отдельном окне карты — его можно держать рядом с сеткой, пока вы работаете.
- Автоматически. A
-- sqlly map:строка сopen=auto, или-- sqlly view: mapкак первая строка запроса, открывает карту при каждом завершении запроса. - Из одного значения геометрии. Щелкните правой кнопкой мыши по ячейке с формой и выберите Просмотр геометрии… (или выберите её с помощью Панель деталей ячейки открыть). На панели инструментов просмотра есть Эскиз / Карта / Исходный ; Карта отображает эту одну форму на уличной карте.
Что можно отображать
Ответы 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 search (FT.SEARCH по GEOSHAPE поле) приходят в виде well-known text и интерпретируются как любой другой геометрический столбец.


Столбцы с долготой и широтой
Любой результат со столбцом долготы и столбцом широты можно отобразить на карте. SQLly находит их по имени, игнорируя регистр, — по словам в имени столбца:
- Longitude - слово
lon,lng,long, илиlongitude:lon,LNG,pickup_lon,StartLongitude. - Latitude - слово
latилиlatitude:lat,dropoff_lat,EndLatitude.
Слова разделяются подчёркиваниями, пробелами, точками, дефисами и заглавными буквами, поэтому
latency, plate, или longest никогда не путаются с координатами. Значения — числа или числовой текст. Строки без значения, с долготой вне диапазона от -180 до 180 или широтой вне диапазона от -90 до 90, на карту не попадают и учитываются на панели инструментов как строки без местоположения.
Когда есть более одной пары - скажем, pickup_lon/pickup_lat
и dropoff_lon/dropoff_lat - столбцы, которые имеют общую часть имени, группируются, и карта открывается с отображением панели, Опции где переключатель Местоположения позволяет переключаться между ними (или написать lat= и
lon= в директиву карты). Если пар по имени не нашлось, предлагается каждая комбинация долготы и широты.
SELECT trip_id, pickup_lon, pickup_lat, dropoff_lon, dropoff_lat FROM trips WHERE trip_date = '2026-10-01';
Геометрические столбцы (WKT и WKB)
Столбец, значения которого — пространственные фигуры, тоже наносится на карту: точки, линии, полигоны (включая отверстия), их мульти-формы и коллекции геометрии. SQLly читает:
- Известный текст - по желанию с префиксом SRID:
POINT(-0.12 51.5),SRID=4326;POLYGON((...)). - Известный бинарный формат - как байты или в виде шестнадцатеричного текста, что и делает PostGIS по умолчанию при возвращении
geometryстолбца — включая расширенную форму с SRID и собственный формат пространственных значений MySQL.
Столбец считается геометрическим, если его тип пространственный (geometry,
geography, point, и так далее) и хотя бы одно из первых 20 значений не NULL успешно разбирается, или когда все первые 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 никогда не обращается к серверу тайлов, пока вы не дадите команду.
- Вас спросят только один раз. При первом открытии карты появляется подсказка, объясняющая, что будет загружено. Загрузить плитки карты включает плитки; Не сейчас, использовать эскиз оставляет их выключенными. Любой выбор запоминается.
- Загружаются только изображения карты. Запросы получают только плитки, покрывающие область на экране, и ничего больше. Ваши результаты запросов, имена столбцов и координаты никогда никуда не отправляются.
- Вежливая загрузка. Одновременно загружается не более двух плиток, только для той части карты, на которую вы смотрите (ничего не загружается заранее), и запросы идентифицируют себя как SQLly с указанием версии, как требует политика использования плиток OpenStreetMap.
- Атрибуция. Пока отображаются плитки, © Участники OpenStreetMap находится в правом нижнем углу карты; нажмите на него, чтобы открыть страницу с информацией об авторских правах и лицензии OpenStreetMap.
- Плитки можно включать и отключать позже. Используйте Настройки › Результаты › Общие › Карты › Загружать тайлы карт из OpenStreetMap, или Включить тайлы карты кнопка на панели заметок карты после отказа.


Кэш плиток
Каждая плитка сохраняется на вашем компьютере и используется повторно в течение 14 дней, прежде чем скачать ее снова, поэтому повторный просмотр области ничего не стоит, а сервер плиток не запрашивается второй раз. Плитки хранятся в
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 map:строка, которая получается с этими настройками. Копировать копирует это в буфер обмена; Записать в запрос записывает её в блок блокировки запроса, так что карта при каждом запуске возвращается одной и той же — у всех, кто откроет файл.


Перемещение
| До | Сделайте следующее |
|---|---|
| Панорамирование | Перетаскивайте карту. По горизонтали она зациклена, как глобус, поэтому можно перетаскивать её дальше линии перемены дат. |
| Масштаб | Крутите колесо мыши или делайте щипок на тачпаде — точка под курсором остаётся на месте — или используйте − и + кнопки, которые масштабируют на один уровень вокруг центра. Карты улиц идут от всего мира (уровень 0) до уровня улиц (уровень 19). |
| Смотреть всё | Подогнать масштабируется так, чтобы все нанесённые объекты попали в кадр. Карта открывается уже подогнанной. Данные по обе стороны линии перемены дат вписываются в кадр по короткому пути через неё. |
| Как опознать объект | Наведите курсор на него. Всплывающая подсказка показывает имя строки: Redis memberили столбец с названием key, name, label, title, или idиначе первый текстовый столбец; если его нет, номер строки. |
| Найдите её строку | Щёлкните на ней. Объект выделяется, а строка выбирается и прокручивается в видимую область в сетке, из которой была получена карта (выключите это через Нажмите на функцию на панели «Параметры» или click=none). |
| Откройте кластер | С Группировать маркеры при включении скученные маркеры становятся одним кругом; наведите на него, чтобы увидеть, сколько точек внутри, и кликните, чтобы приблизить — так до тех пор, пока круг не разделится. |
Щелчок выбирает строки сетки для результатов, открытых через «Показать на карте»; у карты, открытой со вкладки Сводная или из отдельного значения в просмотрщике, строк для выбора нет. У очень большого результата, строки которого подгружаются с диска по страницам, щелчок выбирает строку, только пока эта часть результата загружена в сетку.
Очень большие результаты
Карта отображает не более 50 000 объектов (меньше, если вы установите Максимум объектов на панели «Параметры» или limit=). После этого отображаются первые 50 000, а на панели инструментов пишется Показано 50 000 из N объектов, чтобы вы всегда знали, когда часть данных отсутствует. Каждая часть составной геометрии учитывается как один объект. Карта читает строки, которые находятся в памяти у сетки, поэтому для результата, слишком большого, чтобы его уместить, отфильтруйте его или возьмите выборку в запросе, либо агрегируйте, когда вам нужна вся картина.
Директива map
A -- sqlly map: комментарий в запросе задает, как его результат отображается, таким же образом grid: задаёт сетку. Это то, что копирует кнопка панели Options Записать в запрос кнопка записывает, и каждую настройку ниже тоже можно изменить на панели.
-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…
Настройки key=value, разделённые ;, в любом порядке. Без числа строка применяется к каждому набору результатов выполнения; map 2: применяется только ко второй, считая с 1. Когда применяются несколько строк, поздние настройки переопределяют более ранние. Имена столбцов сравниваются без учёта регистра и записываются в двойные кавычки, если содержат пробел или любой из , ; : = " | (удвойте кавычку внутри такой строки).
| Настройка | Значение | Пример |
|---|---|---|
lat=col; lon=col | Столбцы широты и долготы. Перекрывают автоопределение по имени; нужны оба. | lat=y; lon=x |
geom=col | Столбец геометрии в формате WKT (well-known text) или WKB (well-known binary). Переопределяет автоопределение. | geom=boundary |
srid=n | Система координат данных. Всё, кроме 4326, отображается как эскиз без карты улиц. | srid=27700 |
label=col | Название при наведении. По умолчанию: member, key, name, label, title, id, или первый текстовый столбец. | label=store_name |
tooltip=a, b | Extra column: value строки во всплывающей подсказке. | tooltip=city, revenue |
mode=points|heatmap|both | Маркеры, тепловая карта или тепловая карта с маркерами сверху. Линии и полигоны всегда отображаются. | mode=both |
color=col | Цвет маркеров и фигур по столбцу: до 12 цветов для текстовых значений (остальные делят один цвет), градиент для чисел. | 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 | Начинать с кадра на все объекты (по умолчанию; переопределяет центр и масштаб). | 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 по первому результату: сетка открывается как обычно, а окно карты открывается рядом. Когда карта для результата уже открыта, повторное выполнение обновляет это окно вместо открытия нового.
Ошибочно написанная настройка или некорректное значение подчеркивается в редакторе с указанием причины (например Директива map: неизвестная настройка “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;
Цветные маркеры с размером и кластеризацией для второго результата; открывается при каждом запуске:
-- 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 никогда не загружает тайлы карт. «Показать на карте» и режим карты просмотрщика открывают эскиз напрямую, без запроса, с пометкой, что тайлы недоступны в браузере.