지도 차트 · 차트별 기능

내장 Natural Earth 1:110m 국가 경계 위에서 다섯 세계 도시의 활동을 비교하며, 외부 tile/API 요청은 발생하지 않습니다. 이 차트에서 사용할 수 있는 다양한 표현과 기능을 예제로 살펴보세요.

지도 차트

차트 고유 기능

이 차트만의 고유한 실행 기능

기존 Map 모드와 함께 한 국가, 여러 국가, 한 국가의 주요 행정구역, 여러 지역, 국가·지역 혼합 선택, 세계 상세 카탈로그와 자동 맞춤·상세도·라벨을 기능별 탭으로 실행합니다.

Geographic region chart

Geographic region chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: embedded Natural Earth basemap · general fit and clip policy.

불러오는 중

조작 도움말

확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.

Tab으로 조작부를 이동하고 Enter 또는 Space로 실행하세요. 차트에 초점이 있을 때 더하기·빼기 키로 확대·축소하고 화살표 키로 이동할 수 있습니다.

자동 배치는 둘레 후보를 비교해 차트·범례·다른 말풍선과의 겹침을 가능한 한 피합니다. 명시한 위치는 필요한 안전 보정만 적용해 유지합니다. 말풍선 글자는 상자 안에서 안전하게 자동 줄바꿈됩니다. 끊어지지 않는 긴 토큰은 정해진 줄 수 안에서 시각적으로 축약하지만, 보조 기술에는 원문 전체를 유지합니다.

불러오는 중

코드와 설정 보기

브라우저 API

Graflume.geo()

const data = [
  {
    "region": "KR",
    "value": 92
  },
  {
    "region": "JPN",
    "value": 84
  },
  {
    "region": "SGP",
    "value": 79
  },
  {
    "region": "USA",
    "value": 88
  },
  {
    "region": "BRA",
    "value": 63
  },
  {
    "region": "FRA",
    "value": 76
  },
  {
    "region": "ZAF",
    "value": 58
  },
  {
    "region": "AUS",
    "value": 72
  }
];

const options = {
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "지도 차트 example"
  },
  "axes": {
    "x": false,
    "y": false
  },
  "basemap": "natural-earth",
  "graticule": false,
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "차트 조작",
        "enterFullscreen": "전체 화면 열기",
        "exitFullscreen": "전체 화면 닫기",
        "exportPng": "PNG 다운로드",
        "hideAnnotations": "설명 말풍선 숨기기",
        "loop": "반복 재생",
        "nextFrame": "다음 프레임",
        "pause": "일시 정지",
        "play": "재생",
        "previousFrame": "이전 프레임",
        "reset": "보기 초기화",
        "seek": "재생 위치",
        "showAnnotations": "설명 말풍선 표시",
        "speed": "재생 속도",
        "zoomIn": "확대",
        "zoomOut": "축소"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "fields": [
        {
          "field": "region",
          "format": "auto",
          "label": "Region"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        }
      ],
      "title": "지도 차트",
      "trigger": "mark"
    }
  },
  "locale": "ko",
  "mark": {
    "options": {
      "mode": "choropleth"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Geographic region chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: embedded Natural Earth basemap · general fit and clip policy.",
    "text": "지도 차트"
  },
  "width": "container",
  "x": {
    "field": "region",
    "title": "Longitude",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "Latitude",
    "type": "quantitative"
  }
};

Graflume.geo('#chart', data, options);

이식 가능한 스키마

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "지도 차트 example"
  },
  "axes": {
    "x": false,
    "y": false
  },
  "basemap": "natural-earth",
  "graticule": false,
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "차트 조작",
        "enterFullscreen": "전체 화면 열기",
        "exitFullscreen": "전체 화면 닫기",
        "exportPng": "PNG 다운로드",
        "hideAnnotations": "설명 말풍선 숨기기",
        "loop": "반복 재생",
        "nextFrame": "다음 프레임",
        "pause": "일시 정지",
        "play": "재생",
        "previousFrame": "이전 프레임",
        "reset": "보기 초기화",
        "seek": "재생 위치",
        "showAnnotations": "설명 말풍선 표시",
        "speed": "재생 속도",
        "zoomIn": "확대",
        "zoomOut": "축소"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "fields": [
        {
          "field": "region",
          "format": "auto",
          "label": "Region"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        }
      ],
      "title": "지도 차트",
      "trigger": "mark"
    }
  },
  "locale": "ko",
  "mark": {
    "options": {
      "mode": "choropleth"
    }
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Geographic region chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: embedded Natural Earth basemap · general fit and clip policy.",
    "text": "지도 차트"
  },
  "width": "container",
  "x": {
    "field": "region",
    "title": "Longitude",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "Latitude",
    "type": "quantitative"
  }
}
Quick API
map()
브라우저 스냅샷
graflume
mark
map
프리셋
9
  • geo
  • embedded Natural Earth basemap
  • general fit and clip policy

차트 카탈로그

실행 모드와 호환 이름

실행 가능한 모드와 이전 이름의 대응 관계를 확인하세요.

모드: 9 · 호환 이름: 7

지도 차트 · 지원 모드 · 대표 모드 map
ID이름Quick APImodemark렌더러
geo지도 차트 · geogeo()regiongeocanvas
map지도 차트 · mapmap()defaultmapcanvas
flow-map지도 차트 · flow-mapflowMap()flow-mapgeo-flowcanvas
geo-heatmap지도 차트 · geo-heatmapgeoHeatmap()geo-heatmapgeo-heatmapcanvas
map-bubble지도 차트 · map-bubblemapBubble()map-bubblemapcanvas
map-line지도 차트 · map-linemapLine()map-linegeo-linecanvas
map-point지도 차트 · map-pointmapPoint()map-pointmapcanvas
tiled-map 이전 이름 → map지도 차트 · tiled-maptiledMap()tiled-maptiled-mapcanvas
globe지도 차트 · globeglobe()globeglobewebgl
지도 차트 · 호환 이름
식별자기준 모드 ID
flowmapflow-map
geoheatmapgeo-heatmap
mapmap
mapbubblemap-bubble
maplinemap-line
mappointmap-point
tiledwebmaptiled-map

매뉴얼

통합 체크리스트

ARIA · table fallback

접근성

Canvas ARIA 메타데이터에 텍스트 요약과 표 대체 표현을 함께 제공합니다.

standard · large · ultra

성능

standard·large·ultra 프로필은 렌더링 작업량을 제한합니다.

차트 카탈로그