deck.gl
저수준 코드Low-level code대규모 지리공간 및 데이터 시각화를 위한 GPU 가속 프레임워크로, WebGL 2에서 동작하며 WebGPU는 실험적으로 지원합니다.A GPU-accelerated framework for large-scale geospatial and data visualization, running on WebGL 2 and, experimentally, WebGPU.
현재 버전Current version: 9.4.0, 정보 확인일 2026-10-24facts checked 2026-10-24
개요Overview
deck.gl은 대규모 데이터를 GPU로 그리는 시각화 프레임워크이며, 특히 지도 위의 데이터에 강합니다. Uber에서 출발해 지금은 vis.gl 프로젝트(github.com/visgl)로 관리되고, 라이선스는 MIT입니다. 수백만 개의 GPS 점, 이동 경로, 공간 데이터셋을 베이스맵 위나 빈 캔버스 위에 레이어로 쌓아 그립니다.
deck.gl is a visualization framework that draws large datasets on the GPU and is especially strong for data on maps. It started at Uber, is now maintained as part of the vis.gl project (github.com/visgl), and is released under the MIT license. It stacks layers of millions of GPS points, trip routes and spatial datasets on top of a base map or a blank canvas.
구조는 레이어 기반입니다. 점에는 ScatterplotLayer, 출발지와 목적지 연결에는 ArcLayer, 공간 집계에는 HexagonLayer, 경계선에는 GeoJsonLayer, 이동 애니메이션에는 TripsLayer를 씁니다. 레이어는 서로 조합할 수 있고, 데이터가 바뀌면 바뀐 부분만 GPU에 다시 올립니다. 베이스맵으로는 MapLibre, Mapbox, Google Maps와 함께 쓸 수 있습니다.
The architecture is layer-based. You use ScatterplotLayer for points, ArcLayer for origin-destination links, HexagonLayer for spatial aggregation, GeoJsonLayer for boundaries and TripsLayer for animated movement. Layers compose with each other, and when the data changes only the affected parts are re-uploaded to the GPU. It works with MapLibre, Mapbox and Google Maps as base maps.
2026년 현재 최신 버전은 9.4.0(2026년 9월 5일)입니다. 이 버전에서 공식 레이어 전체가 WebGPU에 이식되었지만, 개발팀은 WebGPU 지원이 아직 실험 단계이고 운영 환경에는 권장하지 않는다고 밝힙니다. 기본 렌더링은 계속 WebGL 2입니다. Python 사용자는 pydeck(0.9.3)으로 노트북에서 같은 레이어를 쓸 수 있습니다.
As of 2026 the latest version is 9.4.0 (September 5, 2026). That release ported every official layer to WebGPU, but the maintainers state that WebGPU support is still experimental and not recommended for production. Default rendering remains WebGL 2. Python users can use the same layers in notebooks through pydeck (0.9.3).
2026년 현재What's new in 2026
- deck.gl 9.4.0(2026년 9월 5일): 공식 레이어 카탈로그 전체가 WebGPU에서 동작하며 WebGL과 같은 렌더링 결과를 내도록 테스트됩니다.
- deck.gl 9.4.0 (September 5, 2026): the entire official layer catalog runs on WebGPU and is tested for render parity with WebGL.
- WebGPU는 아직 실험 단계입니다. 일부 확장 기능(예: PathStyleExtension, DataFilterExtension)과 일부 picking 메서드는 WebGPU에서 지원되지 않으며, 호환성 표는 공식 WebGPU 가이드에 있습니다.
- WebGPU is still experimental. Some extensions (for example PathStyleExtension and DataFilterExtension) and some picking methods are not available on WebGPU, and the compatibility table is in the official WebGPU guide.
- 9.4는 지구본 보기(GlobeView)의 pitch와 bearing, 트랙패드 제스처, 반응형 다중 뷰와 다중 캔버스 레이아웃, 패턴 채우기와 점선 스타일을 추가했습니다.
- Version 9.4 adds pitch and bearing to the globe view, trackpad gestures, responsive multi-view and multi-canvas layouts, pattern fills and dashed-line styling.
- 9.3.0(2026년 4월 13일)은 위젯, 컨트롤러, WebGPU 개선을 담았습니다. 9.4 이후 v10은 luma.gl 10과 함께 더 큰 구조 변경이 예고되어 있습니다.
- 9.3.0 (April 13, 2026) brought widgets, controllers and WebGPU improvements. The release notes say v10, with luma.gl 10, is expected to bring larger architectural changes.
- 기본 번들에 WebGPU 코드가 포함됩니다. WebGL 2만 쓸 앱은 번들러에서
visgl:webgl-only조건을 지정해 번들 크기를 줄일 수 있습니다. - WebGPU code is included in the default bundle. Apps that only target WebGL 2 can set the
visgl:webgl-onlycondition in their bundler to reduce bundle size. - pydeck은 0.9.3(2026년 7월 2일)이며 JavaScript 릴리스보다 늦게 따라옵니다. deck.gl에 내장된 AI 기능은 없습니다.
- pydeck is at 0.9.3 (July 2, 2026) and lags behind the JavaScript releases. deck.gl has no built-in AI features.
강점Strengths
- GPU 렌더링으로 수백만 개의 점을 부드럽게 인터랙티브하게 그립니다.
- GPU rendering draws millions of points with smooth interactivity.
- 점, 호, 경로, 격자, 육각형, 히트맵, GeoJSON, 3D 모델까지 폭넓은 공식 레이어를 제공합니다.
- A wide set of official layers covers points, arcs, paths, grids, hexagons, heatmaps, GeoJSON and 3D models.
- 레이어를 쌓아 조합하는 구조라서 복합 시각화를 만들기 쉽습니다.
- Stacking layers makes composite visualizations straightforward.
- MapLibre, Mapbox, Google Maps와 연동하며 3D 돌출, 점군, 3D 타일도 다룹니다.
- Integrates with MapLibre, Mapbox and Google Maps, and handles 3D extrusion, point clouds and 3D tiles.
- 호버와 클릭 picking, 뷰 전환, 사용자 지정 컨트롤러 같은 인터랙션을 기본 제공합니다.
- Hover and click picking, view transitions and custom controllers come built in.
- pydeck으로 JavaScript 없이 Jupyter 노트북이나 정적 HTML에서 쓸 수 있습니다.
- With pydeck you can use it from Jupyter notebooks or static HTML without writing JavaScript.
- TileLayer 계열이 큰 데이터를 필요한 구간만 단계적으로 불러옵니다.
- The tile layers load large datasets progressively, only where needed.
한계Limitations
- 학습 곡선이 가파릅니다. 레이어, 뷰 상태, 접근자 함수 개념을 알아야 합니다.
- Steep learning curve: you need to understand layers, view state and accessor functions.
- 지도 중심 도구입니다. 지도가 아닌 차트는 OrthographicView 같은 우회 방법이 필요합니다.
- It is map-centered, and non-map charts need workarounds such as OrthographicView.
- WebGPU는 실험 단계입니다. 운영 환경에서는 WebGL 2를 기본으로 보는 편이 안전합니다.
- WebGPU is experimental, so for production it is safer to treat WebGL 2 as the default.
- 텍스트와 축, 범례를 SVG 기반 도구만큼 정교하게 다루기 어렵습니다.
- Text, axes and legends are harder to handle with the polish of SVG-based tools.
- 접근성 기능(스크린 리더, 키보드 탐색)이 거의 없어 별도 대안을 제공해야 합니다.
- Accessibility support (screen readers, keyboard navigation) is minimal, so you need to provide alternatives.
- 정적 이미지로 내보내려면 스크린샷 같은 별도 작업이 필요합니다.
- Exporting a static image needs extra work such as a screenshot.
- 일부 베이스맵 서비스는 키나 계정이 필요하며, 사용량에 따라 요금이 붙을 수 있습니다. 서비스별 약관을 확인하십시오.
- Some base map services require a key or account and may charge by usage, so check each provider's terms.
- GPU에서 그려진 결과는 SVG 요소처럼 개발자 도구로 검사할 수 없어 디버깅이 어렵습니다.
- Output drawn on the GPU cannot be inspected like SVG elements in developer tools, which makes debugging harder.
이런 용도에 최적Best For
데이터가 지도 위에 있고 규모가 수십만에서 수백만 점에 이를 때 deck.gl이 맞습니다. 도시 분석 대시보드, 물류와 이동 경로 시각화, 부동산 탐색 도구, 이동 데이터의 출발지와 도착지 흐름 지도가 대표적입니다.
deck.gl fits when the data lives on a map and runs from hundreds of thousands to millions of points. Typical uses are city analytics dashboards, logistics and trip-route visualization, real estate explorers, and origin-destination flow maps of movement data.
점이 수천 개 이하이거나 정적인 지도라면 Plotly나 Vega-Lite 같은 고수준 도구가 더 간단합니다. 노트북에서 빠르게 시험해 보려면 pydeck으로 시작하고, 앱에 넣을 때 JavaScript 버전으로 옮기는 흐름이 일반적입니다.
If you have a few thousand points or fewer, or a static map, a high-level tool such as Plotly or Vega-Lite is simpler. A common path is to try ideas in a notebook with pydeck and move to the JavaScript version when building an app.
시작하기Getting Started
npm install deck.gl로 설치합니다. 모든 공식 패키지가 포함된 묶음입니다.- Install with
npm install deck.gl, the bundle that includes the official packages. - 지도가 보일
div를 만들고 아래 코드로 Deck 인스턴스에 레이어를 넘깁니다. 이 예제는 베이스맵 없이 점만 그립니다. - Create a
divfor the map and pass layers to a Deck instance as below. This example draws points without a base map. - 베이스맵이 필요하면 MapLibre와 함께
@deck.gl/mapbox의 MapboxOverlay를 씁니다. - If you need a base map, use MapboxOverlay from
@deck.gl/mapboxtogether with MapLibre. - WebGPU를 시험하려면
@luma.gl/webgpu를 설치하고 마지막 코드 블록처럼deviceProps를 지정합니다. 공식 가이드가 이 기능을 아직 운영용으로 권장하지 않는다는 점을 기억하십시오. - To try WebGPU, install
@luma.gl/webgpuand setdevicePropsas in the last code block. Remember that the official guide does not yet recommend it for production.
import { Deck, ScatterplotLayer } from "deck.gl";
const points = [
{ name: "Seoul", position: [126.978, 37.566], value: 9.4 },
{ name: "Busan", position: [129.075, 35.18], value: 3.3 },
{ name: "Incheon", position: [126.705, 37.456], value: 3.0 },
{ name: "Daegu", position: [128.601, 35.871], value: 2.4 }
];
new Deck({
parent: document.getElementById("map"),
initialViewState: { longitude: 127.8, latitude: 36.4, zoom: 6 },
controller: true,
layers: [
new ScatterplotLayer({
id: "cities",
data: points,
getPosition: d => d.position,
getRadius: d => d.value * 8000,
getFillColor: [230, 57, 70, 180],
pickable: true
})
],
getTooltip: ({ object }) => object && `${object.name}: ${object.value}M`
});
// Experimental: render with WebGPU instead of the default WebGL 2
import { Deck } from "deck.gl";
import { webgpuAdapter } from "@luma.gl/webgpu";
new Deck({
deviceProps: { type: "webgpu", adapters: [webgpuAdapter] }
// ...same view state and layers as above
});
파이썬에서는 pydeck으로 같은 방식의 레이어를 만듭니다.
In Python, pydeck builds layers the same way.
# pip install pydeck pandas
import pandas as pd
import pydeck as pdk
df = pd.DataFrame({
"lng": [126.978, 129.075, 126.705, 128.601],
"lat": [37.566, 35.18, 37.456, 35.871],
"value": [9.4, 3.3, 3.0, 2.4],
})
layer = pdk.Layer(
"ScatterplotLayer",
data=df,
get_position=["lng", "lat"],
get_radius="value * 8000",
get_fill_color=[230, 57, 70, 180],
pickable=True,
)
view = pdk.ViewState(latitude=36.4, longitude=127.8, zoom=6)
pdk.Deck(layers=[layer], initial_view_state=view).to_html("cities.html")
지원 차트 유형Supported Chart Types
레이어가 곧 시각화 유형입니다. ScatterplotLayer는 지도 위 산점도와 버블 지도, GeoJsonLayer와 PolygonLayer는 코로플레스 지도, HeatmapLayer는 밀도 히트맵, HexagonLayer와 GridLayer는 공간 집계, ArcLayer는 출발지와 목적지 흐름 지도, PathLayer와 TripsLayer는 경로와 이동 애니메이션을 그립니다.
Layers are the visualization types. ScatterplotLayer draws scatterplots and bubble maps on a map, GeoJsonLayer and PolygonLayer draw choropleth maps, HeatmapLayer draws density heatmaps, HexagonLayer and GridLayer do spatial aggregation, ArcLayer draws origin-destination flow maps, and PathLayer and TripsLayer draw routes and animated movement.
IconLayer와 TextLayer는 기호와 라벨 지도, ColumnLayer는 지도 위 3D 막대, H3HexagonLayer는 H3 격자 집계, PointCloudLayer와 Tile3DLayer는 3D 점군과 건물 모델, BitmapLayer는 래스터 이미지 오버레이에 씁니다. 지도가 아닌 시각화는 OrthographicView로 같은 렌더링 엔진을 쓸 수 있습니다.
IconLayer and TextLayer make symbol and label maps, ColumnLayer draws 3D bars on a map, H3HexagonLayer aggregates on H3 grids, PointCloudLayer and Tile3DLayer show 3D point clouds and building models, and BitmapLayer overlays raster images. Non-map visualizations can use the same rendering engine through OrthographicView.