지도 보기

정상 동작

Redis GEO 응답, 경도/위도 열, WKT나 WKB 도형을, 팬과 줌이 자유롭고 클릭하면 해당 행이 열리는 OpenStreetMap 거리 지도 위에 표시합니다.

결과에 위치가 포함되어 있을 때, Redis GEOSEARCH 응답이든, 경도와 위도 열이 있는 테이블이든, 공간 도형 열이든 - SQLly가 이리저리 옮기고 확대·축소할 수 있는 실제 지도 위에 그려 줍니다. 점에 마우스를 올리면 어떤 행인지 보이고, 클릭하면 그리드의 해당 행으로 이동하고, 다음으로 전환할 수 있는 히트맵 점이 너무 많아 하나씩 읽기 어려울 때.

SQLly
경도와 위도 열이 있는 결과를 표시하는 지도 창: OpenStreetMap 타일, 행마다 하나의 마커, 호버 레이블, 그리고 도구 모음의 Points/Heatmap/Both, 확대/축소, 맞춤(Fit), 옵션 컨트롤.경도와 위도 열이 있는 결과를 표시하는 지도 창: OpenStreetMap 타일, 행마다 하나의 마커, 호버 레이블, 그리고 도구 모음의 Points/Heatmap/Both, 확대/축소, 맞춤(Fit), 옵션 컨트롤.
경도와 위도 열이 있는 결과를 표시하는 지도 창: OpenStreetMap 타일, 행마다 하나의 마커, 호버 레이블, 그리고 도구 모음의 Points/Heatmap/Both, 확대/축소, 맞춤(Fit), 옵션 컨트롤.

지도 열기

  • 결과 그리드에서. 아무 셀이나 마우스 오른쪽 버튼으로 클릭하고 도구 › 지도에 표시…. 결과 집합 전체가 별도의 지도 창으로 열리므로, 작업 내내 그리드 옆에 둘 수 있습니다.
  • 자동으로. 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 검색 응답의 지오 셰이프 필드(FT.SEARCH 위의 GEOSHAPE 필드)는 well-known text로 전달되며 다른 지오메트리 열과 똑같이 매핑됩니다.

SQLly
지도로 보는 Redis GEOSEARCH WITHCOORD 응답: 각 멤버를 지도 위의 점으로 표시합니다.지도로 보는 Redis GEOSEARCH WITHCOORD 응답: 각 멤버를 지도 위의 점으로 표시합니다.
지도로 보는 Redis GEOSEARCH WITHCOORD 응답: 각 멤버를 지도 위의 점으로 표시합니다.

경도 및 위도 열

경도 열과 위도 열이 있으면 어떤 결과든 지도에 그릴 수 있습니다. SQLly는 대소문자를 구분하지 않고 열 이름의 단어를 보고 이를 찾아냅니다:

  • 경도 - 하나의 단어 lon, lng, long, 또는 longitude: lon, LNG, pickup_lon, StartLongitude.
  • 위도 - 하나의 단어 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((...)).
  • 잘 알려진 바이너리 - 바이트 또는 16진수 텍스트로 표시하는데, 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
도로 지도 위에 WKT(Well-Known Text) 열에서 그린 다각형과 선, 그리고 점으로 표시된 상점들.도로 지도 위에 WKT(Well-Known Text) 열에서 그린 다각형과 선, 그리고 점으로 표시된 상점들.
도로 지도 위에 WKT(Well-Known Text) 열에서 그린 다각형과 선, 그리고 점으로 표시된 상점들.
좌표계. 그 밖의 좌표계, 국가 격자 또는 UTM 존에 속한 도형은, 예를 들어 SRID=27700 - 여전히 그려지고 팬·줌은 되지만, 거리 지도 없는 스케치일 뿐이고 SRID를 밝히는 메모가 붙습니다. SQLly가 좌표를 다시 투영하지는 않으므로 쿼리에서 변환하세요(예를 들면 ST_Transform(geom, 4326) PostGIS에서) 그래야 지도에 나타납니다.

OpenStreetMap의 거리 지도 타일

거리 지도는 OpenStreetMap 프로젝트의 이미지 타일로 만들어지며, 다음에서 다운로드합니다 tile.openstreetmap.org. SQLly는 사용자가 허용하기 전까지 타일 서버에 접속하지 않습니다.

  • 한 번만 물어봅니다. 지도가 처음 열릴 때, 무엇이 다운로드될지 설명하는 안내창이 나타납니다. 지도 타일 불러오기 타일을 켭니다; 나중에, 스케치 사용 계속 꺼 둡니다. 어느 쪽 답이든 기억해 둡니다.
  • 지도 이미지만 가져옵니다. 요청은 화면에 표시된 영역을 덮는 타일만 요청하며, 다른 것은 요청하지 않습니다. 쿼리 결과, 열 이름, 좌표는 절대 다른 곳으로 전송되지 않습니다.
  • 예의 바른 다운로드. 한 번에 최대 두 개의 타일만 내려받고, 보고 있는 지도 영역에 대해서만 내려받습니다(미리 가져오기는 없음). 요청은 OpenStreetMap 타일 사용 정책에 따라 SQLly와 그 버전으로 식별됩니다.
  • 출처 표시. 타일이 표시되는 동안, © 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).
클러스터 열기와/과 마커 클러스터링 켜짐 상태에서는 겹치는 마커가 하나의 원으로 합쳐집니다. 원에 마우스를 올리면 몇 개의 위치가 모여 있는지 알 수 있고, 클릭하면 갈라질 때까지 확대합니다.

Show on Map으로 연 결과에서는 클릭하면 그리드 행이 선택됩니다. Pivot 탭이나 뷰어의 단일 값으로 연 지도는 선택할 행이 없습니다. 디스크에서 페이지 단위로 불러오는 아주 큰 결과는 해당 부분이 그리드에 로드되어 있는 동안에만 클릭으로 행이 선택됩니다.

매우 큰 결과

지도에서는 최대 50,000개 피처 (다음을 설정하면 더 적음 최대 피처 수 옵션 패널에서 하거나 limit=). 이를 넘으면 처음 50,000개가 그려지고 툴바에는 다음이 표시됩니다 N개 피처 중 50,000개 표시 중, 그래서 데이터 일부가 빠졌을 때 항상 알 수 있습니다. 여러 부분으로 된 도형은 부분 하나하나가 피처 하나로 칩니다. 지도는 그리드가 메모리에 둔 행을 읽으므로, 결과가 너무 커서 담을 수 없을 때는 전체 그림이 필요할 때 쿼리에서 필터링하거나 샘플링하거나 집계하세요.

map 지시문

A -- sqlly map: 주석은 쿼리 안에서 그 결과가 매핑되는 방식을 정하며, 다음과 같은 방식으로 grid: 이 그리드를 설정하는 것과 같은 방식입니다. 옵션 패널의 쿼리에 쓰기 버튼이 쓰는 내용이며, 아래의 모든 설정도 패널에서 변경할 수 있습니다.

-- sqlly map: <setting>; <setting>…
-- sqlly map <n>: <setting>; <setting>…

설정은 key=value, 다음으로 구분된 ;, 순서는 상관없습니다. 번호가 없으면 그 줄은 실행의 모든 결과 집합에 적용됩니다; map 2: 1부터 세었을 때 두 번째에만 적용됩니다. 여러 줄이 적용될 경우, 나중에 설정한 값이 이전 값을 덮어씁니다. 열 이름은 대소문자를 무시하고 일치하며, 공백이나 다음 중 하나를 포함할 경우 큰따옴표로 작성됩니다. , ; : = " | (그 안의 따옴표는 두 번 겹쳐 씁니다).

설정의미예시
lat=col; lon=col위도와 경도 열입니다. 이름 기반 감지를 대체하며, 두 열이 모두 필요합니다.lat=y; lon=x
geom=colwell-known 텍스트나 바이너리 형식의 지오메트리 열입니다. 자동 감지를 덮어씁니다.geom=boundary
srid=n데이터의 좌표계입니다. 4326이 아닌 값은 배경 지도 없이 스케치로만 그려집니다.srid=27700
label=col호버 제목. 기본값: member, key, name, label, title, id, 또는 첫 번째 텍스트 열.label=store_name
tooltip=a, b추가 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는 지도 타일을 전혀 내려받지 않습니다. 지도에 표시와 뷰어의 지도 모드는 확인 창 없이 스케치를 바로 열고, 브라우저에서는 타일을 쓸 수 없다는 안내를 함께 보여줍니다.