地理图表
Geo:地理坐标系
class pyecharts.charts.Geo
class Geo(
# 初始化配置项,参考 `global_options.InitOpts`
init_opts: opts.InitOpts = opts.InitOpts()
# 是否忽略不存在的坐标,默认值为 False,即不忽略
is_ignore_nonexistent_coord: bool = False
)
func pyecharts.charts.Geo.add_schema
def add_schema(
# 地图类型,具体参考 pyecharts.datasets.map_filenames.json 文件
maptype: str = "china",
# 是否开启鼠标缩放和平移漫游。
is_roam: bool = True,
# 当前视角的缩放比例。默认为 1
zoom: Optional[Numeric] = None,
# 当前视角的中心点,用经纬度表示。例如:center: [115.97, 29.71]
center: Optional[Sequence] = None,
# 参数用于 scale 地图的长宽比。
aspect_scale: types.Numeric = 0.75,
# 二维数组,定义定位的左上角以及右下角分别所对应的经纬度。
bounding_coords: types.Optional[types.Sequence[types.Numeric]] = None,
# 最小的缩放值。
min_scale_limit: types.Optional[types.Numeric] = None,
# 最大的缩放值。
max_scale_limit: types.Optional[types.Numeric] = None,
# 默认是 'name',针对 GeoJSON 要素的自定义属性名称,作为主键用于关联数据点和 GeoJSON 地理要素。
name_property: str = "name",
# 选中模式,表示是否支持多个选中,默认关闭,支持布尔值和字符串。
# 字符串取值可选'single'表示单选,或者'multiple'表示多选。
selected_mode: types.Union[bool, str] = False,
# pyecharts 暂时没有提供 left/top/right/bottom 的配置
# layoutCenter 和 layoutSize 提供了除了 left/right/top/bottom/width/height 之外的布局手段。
# 在使用 left/right/top/bottom/width/height 的时候
# 可能很难在保持地图高宽比的情况下把地图放在某个盒形区域的正中间,并且保证不超出盒形的范围。
# 此时可以通过 layoutCenter 属性定义地图中心在屏幕中的位置,layoutSize 定义地图的大小。
# 如下示例
# layoutCenter: ['30%', '30%'],
# // 如果宽高比大于 1 则宽度为 100,如果小于 1 则高度为 100,保证了不超过 100x100 的区域
# layoutSize: 100
layout_center: types.Optional[types.Sequence[str]] = None,
# 地图的大小,见 layoutCenter。支持相对于屏幕宽高的百分比或者绝对的像素大小。
layout_size: types.Union[str, types.Numeric] = None,
# # 标签配置项,参考 `series_options.LabelOpts`
label_opts: Union[opts.LabelOpts, dict, None] = None,
# 地图区域的多边形 图形样式。
itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] =None,
# 高亮状态下的多边形样式
emphasis_itemstyle_opts: Union[opts.ItemStyleOpts, dict,None] = None,
# 高亮状态下的标签样式。
emphasis_label_opts: Union[opts.LabelOpts, dict, None] =None,
# 在地图中对特定的区域配置样式。具体配置参考 `charts_options.GeoRegionsOpts`
regions_opts: types.Union[types.Sequence[types.GeoRegions], types.Sequence[dict]] = None,
):
func pyecharts.charts.Geo.add
def add(
# 系列名称,用于 tooltip 的显示,legend 的图例筛选。
series_name: str,
# 数据项 (坐标点名称,坐标点值)
data_pair: Sequence,
# Geo 图类型,有 9 种
# from pyecharts.globals import GeoType
# ChartType.SCATTER
# ChartType.SCATTERGL
# ChartType.EFFECT_SCATTER
# ChartType.FLOWGL
# ChartType.HEATMAP
# ChartType.LINES
# ChartType.LINESGL
# ChartType.CUSTOM
# ChartType.PIE
type_: str = "scatter",
# 是否选中图例
is_selected: bool = True,
# 标记图形形状
symbol: Optional[str] = None,
# 标记的大小
symbol_size: Numeric = 12,
# 每个点的大小,在地理坐标系(coordinateSystem: 'geo')上有效。
blur_size: types.Numeric = 20,
# 每个点模糊的大小,在地理坐标系(coordinateSystem: 'geo')上有效。
point_size: types.Numeric = 20,
# 饼图的半径, 当 type_ 为 ChartType.PIE 生效
radius: types.Optional[types.Sequence] = None,
# 系列 label 颜色
color: Optional[str] = None,
# 是否是多段线,在画 lines 图情况下
is_polyline: bool = False,
# 是否启用大规模线图的优化,在数据图形特别多的时候(>=5k)可以开启
is_large: bool = False,
# 特效尾迹的长度。取从 0 到 1 的值,数值越大尾迹越长。默认值 0.2
trail_length: Numeric = 0.2,
# 开启绘制优化的阈值。
large_threshold: Numeric = 2000,
# 配置该系列每一帧渲染的图形数
progressive: types.Numeric = 400,
# 启用渐进式渲染的图形数量阈值,在单个系列的图形数量超过该阈值时启用渐进式渲染。
progressive_threshold: types.Numeric = 3000,
# 标签配置项,参考 `series_options.LabelOpts`
label_opts: Union[opts.LabelOpts, dict] = opts.LabelOpts(),
# 涟漪特效配置项,参考 `series_options.EffectOpts`
effect_opts: Union[opts.EffectOpts, dict] = opts.EffectOpts(),
# 线样式配置项,参考 `series_options.LineStyleOpts`
linestyle_opts: Union[opts.LineStyleOpts, dict] = opts.LineStyleOpts(),
# 提示框组件配置项,参考 `series_options.TooltipOpts`
tooltip_opts: Union[opts.TooltipOpts, dict, None] = None,
# 图元样式配置项,参考 `series_options.ItemStyleOpts`
itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None,
# 这个配置相对非常复杂(参照地址: https://www.echartsjs.com/zh/option.html#series-custom.renderItem)
render_item: types.JsCode = None,
# 这个配置相对非常复杂(参照地址: https://www.echartsjs.com/zh/option.html#series-custom.encode)
encode: types.Union[types.JsCode, dict] = None,
)
func pyecharts.charts.Geo.add_coordinate
新增一个坐标点
def add_coordinate(
# 坐标地点名称
name: str,
# 经度
longitude: Numeric,
# 纬度
latitude: Numeric,
)
func pyecharts.charts.Geo.add_coordinate_json
以 JOSN 文件格式新增多个坐标点
def add_coordinate_json(
# json 文件格式的坐标数据
# 格式如下
# {
# "阿城": [126.58, 45.32],
# "阿克苏": [80.19, 41.09]
# }
],
json_file: str
)
func pyecharts.charts.Geo.get_coordinate
查询指定地点的坐标
def get_coordinate(
# 地点名称
name: str
) -> Sequence
Geo 图的坐标引用自 pyecharts.datasets.COORDINATES
,COORDINATES
是一个支持模糊匹配的字典类。可设置匹配的阈值。
from pyecharts.datasets import COORDINATES
# cutoff 为匹配阈值,阈值越高相似性越高,1 为完全相同。默认为 0.6
COORDINATES.cutoff = 0.75
func pyecharts.options.GeoRegionsOpts
class GeoRegionsOpts(
# 地图区域的名称,例如 '广东','浙江'。
name: Optional[str] = None,
# 该区域是否选中。
is_selected: bool = False,
# 该区域的多边形样式设置。
itemstyle_opts: Union[ItemStyleOpts, dict, None] = None,
# 图形上的文本标签,可用于说明图形的一些数据信息,比如值,名称等。
label_opts: Union[LabelOpts, dict, None] = None,
# 高亮状态的样式设置。
emphasis_itemstyle_opts: Union[ItemStyleOpts, dict, None] = None,
# 高亮状态的标签设置。
emphasis_label_opts: Union[LabelOpts, dict, None] = None,
# 选中状态的样式设置。
select_itemstyle_opts: Union[ItemStyleOpts, dict, None] = None,
# 选中状态的标签设置。
select_label_opts: Union[LabelOpts, dict, None] = None,
# 淡出状态的样式设置。
blur_itemstyle_opts: Union[ItemStyleOpts, dict, None] = None,
# 淡出状态的标签设置。
blur_label_opts: Union[LabelOpts, dict, None] = None,
# 本 region 中特定的 tooltip 设定。
tooltip_opts: Union[TooltipOpts, dict, None] = None,
# 图形是否不响应和触发鼠标事件,默认为 false,即响应和触发鼠标事件。
is_silent: bool = False,
)
Demo
Map:地图
class pyecharts.charts.Map
class Map(
# 初始化配置项,参考 `global_options.InitOpts`
init_opts: opts.InitOpts = opts.InitOpts()
)
func pyecharts.charts.Map.add
def add(
# 系列名称,用于 tooltip 的显示,legend 的图例筛选。
series_name: str,
# 数据项 (坐标点名称,坐标点值)
data_pair: types.Sequence[types.Union[types.Sequence, opts.MapItem, dict]],
# 地图类型,具体参考 pyecharts.datasets.map_filenames.json 文件
maptype: str = "china",
# 是否选中图例
is_selected: bool = True,
# 是否开启鼠标缩放和平移漫游。
is_roam: bool = True,
# 当前视角的中心点,用经纬度表示
center: Optional[Sequence] = None,
# 参数用于 scale 地图的长宽比。
aspect_scale: types.Numeric = 0.75,
# 二维数组,定义定位的左上角以及右下角分别所对应的经纬度。
bounding_coords: types.Optional[types.Sequence[types.Numeric]] = None,
# 最小的缩放值。
min_scale_limit: types.Optional[types.Numeric] = None,
# 最大的缩放值。
max_scale_limit: types.Optional[types.Numeric] = None,
# 默认是 'name',针对 GeoJSON 要素的自定义属性名称,作为主键用于关联数据点和 GeoJSON 地理要素。
name_property: str = "name",
# 选中模式,表示是否支持多个选中,默认关闭,支持布尔值和字符串。
# 字符串取值可选'single'表示单选,或者'multiple'表示多选。
selected_mode: types.Union[bool, str] = False,
# 当前视角的缩放比例。
zoom: Optional[Numeric] = 1,
# 自定义地区的名称映射
name_map: Optional[dict] = None,
# 标记图形形状
symbol: Optional[str] = None,
# 多个拥有相同地图类型的系列会使用同一个地图展现。
# 如果多个系列都在同一个区域有值,ECharts 会对这些值统计得到一个数据。
# 这个配置项就是用于配置统计的方式,目前有:
# 'sum' 取和。
# 'average' 取平均值。
# 'max' 取最大值。
# 'min' 取最小值。
map_value_calculation: str = "sum",
# 是否显示标记图形
is_map_symbol_show: bool = True,
# 所有图形的 zlevel 值。
# zlevel 大的 Canvas 会放在 zlevel 小的 Canvas 的上面。
z_level: types.Numeric = 0,
# 组件的所有图形的z值。控制图形的前后顺序。z 值小的图形会被 z 值大的图形覆盖。
# z 相比 zlevel 优先级更低,而且不会创建新的 Canvas。
z: types.Numeric = 2,
# 组件离容器左侧的距离。
# left 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比
# 也可以是 'left', 'center', 'right'。
pos_left: types.Union[str, types.Numeric] = "auto",
# 组件离容器上侧的距离。
# top 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比
# 也可以是 'top', 'middle', 'bottom'。
pos_top: types.Union[str, types.Numeric] = "auto",
# 组件离容器右侧的距离。
# right 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比。默认自适应。
pos_right: types.Union[str, types.Numeric] = "auto",
# 组件离容器下侧的距离。
# bottom 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比。默认自适应。
pos_bottom: types.Union[str, types.Numeric] = "auto",
# 默认情况下,map series 会自己生成内部专用的 geo 组件。但是也可以用这个 geoIndex 指定一个 geo 组件。
geo_index: types.Optional[types.Numeric] = None,
# 当使用 dataset 时,seriesLayoutBy 指定了 dataset 中用行还是列对应到系列上
# 也就是说,系列“排布”到 dataset 的行还是列上。可取值:
# 'column':默认,dataset 的列对应于系列,从而 dataset 中每一列是一个维度(dimension)。
# 'row':dataset 的行对应于系列,从而 dataset 中每一行是一个维度(dimension)。
series_layout_by: str = "column",
# 如果 series.data 没有指定,并且 dataset 存在,那么就会使用 dataset。datasetIndex 指定本系列使用那个 dataset。
dataset_index: types.Optional[types.Numeric] = 0,
# pyecharts 暂时没有提供 left/top/right/bottom 的配置
# layoutCenter 和 layoutSize 提供了除了 left/right/top/bottom/width/height 之外的布局手段。
# 在使用 left/right/top/bottom/width/height 的时候
# 可能很难在保持地图高宽比的情况下把地图放在某个盒形区域的正中间,并且保证不超出盒形的范围。
# 此时可以通过 layoutCenter 属性定义地图中心在屏幕中的位置,layoutSize 定义地图的大小。
# 如下示例
# layoutCenter: ['30%', '30%'],
# // 如果宽高比大于 1 则宽度为 100,如果小于 1 则高度为 100,保证了不超过 100x100 的区域
# layoutSize: 100
layout_center: types.Optional[types.Sequence[str]] = None,
# 地图的大小,见 layoutCenter。支持相对于屏幕宽高的百分比或者绝对的像素大小。
layout_size: types.Union[str, types.Numeric] = None,
# 标签配置项,参考 `series_options.LabelOpts`
label_opts: Union[opts.LabelOpts, dict] = opts.LabelOpts(),
# 提示框组件配置项,参考 `series_options.TooltipOpts`
tooltip_opts: Union[opts.TooltipOpts, dict, None] = None,
# 图元样式配置项,参考 `series_options.ItemStyleOpts`
itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None,
# 高亮标签配置项,参考 `series_options.LabelOpts`
emphasis_label_opts: Union[opts.LabelOpts, dict, None] = None,
# 高亮图元样式配置项,参考 `series_options.ItemStyleOpts`
emphasis_itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None,
)
MapItem:地图数据项
class MapItem(
# 数据所对应的地图区域的名称,例如 '广东','浙江'。
name: Optional[str] = None,
# 该区域的数据值。
value: Optional[Numeric] = None,
# 该数据项的组 ID。
group_id: Optional[str] = None,
# 该区域是否选中。
is_selected: bool = False,
# 标签配置项,参考 `series_options.LabelOpts`
label_opts: Union[LabelOpts, dict, None] = None,
# 图元样式配置项,参考 `series_options.ItemStyleOpts`
itemstyle_opts: Union[ItemStyleOpts, dict, None] = None,
# 提示框组件配置项,参考 `series_options.TooltipOpts`
tooltip_opts: Union[TooltipOpts, dict, None] = None,
)
Demo
BMap:百度地图
百度地图需要申请开发者 AK,官网申请。
class pyecharts.charts.BMap
class BMap(
# 初始化配置项,参考 `global_options.InitOpts`
init_opts: opts.InitOpts = opts.InitOpts()
# 是否忽略不存在的坐标,默认值为 False,即不忽略
is_ignore_nonexistent_coord: bool = False
)
func pyecharts.charts.BMap.add_schema
def add_schema(
# 百度地图开发应用 appkey,请使用到百度地图的开发者自行到百度地图开发者中心
# 注册百度 ak。
baidu_ak: str,
# 当前视角的中心点,用经纬度表示
center: Optional[Sequence] = None,
# 当前视角的缩放比例。
zoom: Optional[Numeric] = None,
# 是否开启鼠标缩放和平移漫游。
is_roam: bool = True,
# 地图样式配置项
map_style: Optional[dict] = None,
)
func pyecharts.charts.BMap.add
def add(
# 系列名称,用于 tooltip 的显示,legend 的图例筛选。
series_name: str,
# 数据项 (坐标点名称,坐标点值)
data_pair: Sequence,
# Geo 图类型,有 scatter, effectScatter, heatmap, lines 4 种,建议使用
# from pyecharts.globals import GeoType
# GeoType.GeoType.EFFECT_SCATTER,GeoType.HEATMAP,GeoType.LINES
type_: str = "scatter",
# 是否选中图例
is_selected: bool = True,
# 标记图形形状
symbol: Optional[str] = None,
# 标记的大小
symbol_size: Numeric = 12,
# 系列 label 颜色
color: Optional[str] = None,
# 是否是多段线,在画 lines 图情况下
is_polyline: bool = False,
# 是否启用大规模线图的优化,在数据图形特别多的时候(>=5k)可以开启
is_large: bool = False,
# 开启绘制优化的阈值。
large_threshold: Numeric = 2000,
# 标签配置项,参考 `series_options.LabelOpts`
label_opts: Union[opts.LabelOpts, dict] = opts.LabelOpts(),
# 涟漪特效配置项,参考 `series_options.EffectOpts`
effect_opts: Union[opts.EffectOpts, dict] = opts.EffectOpts(),
# 线样式配置项,参考 `series_options.LineStyleOpts`
linestyle_opts: Union[opts.LineStyleOpts, dict] = opts.LineStyleOpts(),
# 提示框组件配置项,参考 `series_options.TooltipOpts`
tooltip_opts: Union[opts.TooltipOpts, dict, None] = None,
# 图元样式配置项,参考 `series_options.ItemStyleOpts`
itemstyle_opts: Union[opts.ItemStyleOpts, dict, None] = None,
)
func pyecharts.charts.BMap.add_control_panel
def add_control_panel(
# 地图的平移缩放控件
navigation_control_opts: Union[opts.BMapNavigationControlOpts, dict, None] = None,
# 缩略地图控件
overview_map_opts: Union[opts.BMapOverviewMapControlOpts, dict, None] = None,
# 比例尺控件
scale_control_opts: Union[opts.BMapScaleControlOpts, dict, None] = None,
# 切换地图类型的控件
maptype_control_opts: Union[opts.BMapTypeControlOpts, dict, None] = None,
# 版权控件,您可以在地图上添加自己的版权信息。
# 每一个版权信息需要包含如下内容:版权的唯一标识、版权内容和其适用的区域范围。
copyright_control_opts: Union[opts.BMapCopyrightTypeOpts, dict, None] = None,
# 地图定位的控件,使用 HTML5 浏览器定位功能
geo_location_control_opts: Union[opts.BMapGeoLocationControlOpts, dict, None] = None,
)
BMapNavigationControlOpts:地图的平移缩放控件
class pyecharts.options.BMapNavigationControlOpts
class BMapNavigationControlOpts(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_TOP_LEFT,
# 控件的水平偏移值
offset_width: Numeric = 10,
# 控件的竖直偏移值
offset_height: Numeric = 10,
# 平移缩放控件的类型
# NAVIGATION_CONTROL_LARGE,标准的平移缩放控件(包括平移、缩放按钮和滑块,值为 0
# NAVIGATION_CONTROL_SMALL,仅包含平移和缩放按钮,值为 1
# NAVIGATION_CONTROL_PAN,仅包含平移按钮,值为 2
# NAVIGATION_CONTROL_ZOOM,仅包含缩放按钮,值为 3
type_: Numeric = BMapType.NAVIGATION_CONTROL_LARGE,
# 是否显示级别提示信息
is_show_zoom_info: bool = False,
# 控件是否集成定位功能
is_enable_geo_location: bool = False,
)
BMapOverviewMapControlOpts:缩略地图控件
class pyecharts.options.BMapOverviewMapControlOpts
class BMapOverviewMapControlOpts(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_BOTTOM_RIGHT,
# 控件的水平偏移值
offset_width: Numeric = 10,
# 控件的竖直偏移值
offset_height: Numeric = 50,
# 缩略地图添加到地图后的开合状态,默认为 False 关闭
is_open: bool = False,
)
BMapScaleControlOpts:比例尺控件
class pyecharts.options.BMapScaleControlOpts
class BMapScaleControlOpts(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_BOTTOM_RIGHT,
# 控件的水平偏移值
offset_width: Numeric = 10,
# 控件的竖直偏移值
offset_height: Numeric = 50,
)
BMapTypeControl:切换地图类型的控件
class pyecharts.options.BMapTypeControl
class BMapTypeControl(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_TOP_RIGHT,
# 地图类型属性
# MAPTYPE_CONTROL_HORIZONTAL,按钮水平方式展示,默认采用此类型展示。值为 0
# MAPTYPE_CONTROL_DROPDOWN,按钮呈下拉列表方式展示,值为 1
# MAPTYPE_CONTROL_MAP,以图片方式展示类型控件,设置该类型后无法指定 maptypes 属性,值为 2
type_: Numeric = BMapType.MAPTYPE_CONTROL_HORIZONTAL,
)
BMapCopyrightType:版权控件
class pyecharts.options.BMapCopyrightType
class BMapCopyrightType(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_BOTTOM_RIGHT,
# 控件的水平偏移值
offset_width: Numeric = 10,
# 控件的竖直偏移值
offset_height: Numeric = 50,
# Copyright 的文本内容, 可以放入 HTML 标签
copyright_: str = "",
)
BMapGeoLocationControlOpts:地图定位的控件
class pyecharts.options.BMapGeoLocationControlOpts
class BMapGeoLocationControlOpts(
# 控件的停靠位置
# ANCHOR_TOP_LEFT,控件将定位到地图的左上角,值为 0
# ANCHOR_TOP_RIGHT,控件将定位到地图的右上角,值为 1
# ANCHOR_BOTTOM_LEFT,控件将定位到地图的左下角,值为 2
# ANCHOR_BOTTOM_RIGHT,控件将定位到地图的右下角,值为 3
position: Numeric = BMapType.ANCHOR_BOTTOM_RIGHT,
# 控件的水平偏移值
offset_width: Numeric = 10,
# 控件的竖直偏移值
offset_height: Numeric = 50,
# 是否显示定位信息面板。默认显示定位信息面板
is_show_address_bar: bool = True,
# 添加控件时是否进行定位。默认添加控件时不进行定位
is_enable_auto_location: bool = False,
)