Вид карты

функциональный

Показывайте ответы Redis GEO, столбцы с долготой и широтой и геометрии WKT или WKB на уличной карте OpenStreetMap, которую можно двигать и масштабировать, а клик по точке ведёт прямо к строке.

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

SQLly
Окно карты для результата с колонками долготы и широты: тайлы OpenStreetMap, один маркер на строку, всплывающая подсказка, а также элементы управления Points/Heatmap/Both, масштабирование, Fit и Options на панели инструментов.Окно карты для результата с колонками долготы и широты: тайлы OpenStreetMap, один маркер на строку, всплывающая подсказка, а также элементы управления Points/Heatmap/Both, масштабирование, Fit и Options на панели инструментов.
Окно карты для результата с колонками долготы и широты: тайлы OpenStreetMap, один маркер на строку, всплывающая подсказка, а также элементы управления Points/Heatmap/Both, масштабирование, Fit и Options на панели инструментов.

Открытие карты

  • Из сетки результатов. Щёлкните правой кнопкой мыши по любой ячейке и выберите Инструменты › Показать на карте…. Весь набор результатов открывается в отдельном окне карты — его можно держать рядом с сеткой, пока вы работаете.
  • Автоматически. 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
Ответ Redis GEOSEARCH WITHCOORD на карте: каждый магазин как точка на уличной карте.Ответ Redis GEOSEARCH WITHCOORD на карте: каждый магазин как точка на уличной карте.
Ответ Redis GEOSEARCH WITHCOORD на карте: каждый магазин как точка на уличной карте.

Столбцы с долготой и широтой

Любой результат со столбцом долготы и столбцом широты можно отобразить на карте. 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;
SQLly
Многоугольники и линия из столбца well-known-text, наложенные на карту улиц, с магазинами в виде точек.Многоугольники и линия из столбца well-known-text, наложенные на карту улиц, с магазинами в виде точек.
Многоугольники и линия из столбца 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 никогда не обращается к серверу тайлов, пока вы не дадите команду.

  • Вас спросят только один раз. При первом открытии карты появляется подсказка, объясняющая, что будет загружено. Загрузить плитки карты включает плитки; Не сейчас, использовать эскиз оставляет их выключенными. Любой выбор запоминается.
  • Загружаются только изображения карты. Запросы получают только плитки, покрывающие область на экране, и ничего больше. Ваши результаты запросов, имена столбцов и координаты никогда никуда не отправляются.
  • Вежливая загрузка. Одновременно загружается не более двух плиток, только для той части карты, на которую вы смотрите (ничего не загружается заранее), и запросы идентифицируют себя как SQLly с указанием версии, как требует политика использования плиток OpenStreetMap.
  • Атрибуция. Пока отображаются плитки, © Участники OpenStreetMap находится в правом нижнем углу карты; нажмите на него, чтобы открыть страницу с информацией об авторских правах и лицензии OpenStreetMap.
  • Плитки можно включать и отключать позже. Используйте Настройки › Результаты › Общие › Карты › Загружать тайлы карт из OpenStreetMap, или Включить тайлы карты кнопка на панели заметок карты после отказа.
SQLly
Подсказка при первом открытии новой карты: «Загрузить уличную карту из 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
Тот же результат, нарисованный эскизом после отказа от плиток: маркеры на однотонном фоне с лёгкой сеткой широты/долготы и кнопкой «Включить плитки карты».Тот же результат, нарисованный эскизом после отказа от плиток: маркеры на однотонном фоне с лёгкой сеткой широты/долготы и кнопкой «Включить плитки карты».
Тот же результат, нарисованный эскизом после отказа от плиток: маркеры на однотонном фоне с лёгкой сеткой широты/долготы и кнопкой «Включить плитки карты».

Панель настроек

Нажмите Опции справа на панели инструментов карты, чтобы открыть панель со всеми настройками карты. Любое изменение сразу же перерисовывает карту.

  • Данные - Местоположения (Авто или одна из обнаруженных пар долготы/широты и столбцов геометрии), Метка (заголовок при наведении), Столбцы подсказки (дополнительные строки во всплывающей подсказке), Цвет по (палитра для текста, градиент для чисел с легендой снизу), и Размер по (большие маркеры для больших чисел).
  • Слои - Показать точки, тепловую карту, или оба; Группировать маркеры объединяет слипшиеся маркеры в один круг (наведите на него, чтобы увидеть количество, щелкните, чтобы приблизить); а для тепловой карты — вес, радиус, размытие, интенсивность, непрозрачность и палитра.
  • Карта - Уличная карта включено или выключено для этого результата, что щёлкнув делает с объектом, открывается ли карта открывается при запуске, большинство функций рисовать, и начальный вид (подогнать под данные или запомнить вид, который вы сейчас просматриваете).
  • Директива — -- sqlly map: строка, которая получается с этими настройками. Копировать копирует это в буфер обмена; Записать в запрос записывает её в блок блокировки запроса, так что карта при каждом запуске возвращается одной и той же — у всех, кто откроет файл.
SQLly
Панель параметров карты: разделы Данные, Слои и Карта, цветовая легенда и строка -- sqlly map: с кнопками Копировать и Записать в запрос.Панель параметров карты: разделы Данные, Слои и Карта, цветовая легенда и строка -- sqlly map: с кнопками Копировать и Записать в запрос.
Панель параметров карты: разделы Данные, Слои и Карта, цветовая легенда и строка -- 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, bExtra 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 никогда не загружает тайлы карт. «Показать на карте» и режим карты просмотрщика открывают эскиз напрямую, без запроса, с пометкой, что тайлы недоступны в браузере.