geopandas.GeoDataFrame.explore#

GeoDataFrame.explore(*args, **kwargs)[来源]#

基于 GeoPandas 和 folium/leaflet.js 的交互式地图

根据 GeoDataFrame 生成交互式的 leaflet 地图

Parameters:
columnstr, np.array, pd.Series (default None)

用于绘图的数据框列的名称， numpy.array， 或 pandas.Series。 如果使用 numpy.array 或 pandas.Series，则其长度必须与数据框相同。

cmapstr, matplotlib.Colormap, branca.colormap or function (default None)

由 matplotlib 识别的色彩图的名称，一个类似列表的颜色， matplotlib.colors.Colormap，一个 branca.colormap.ColorMap 或基于列值返回命名颜色或十六进制的函数，例如：

def my_colormap(value):  # scalar value defined in 'column'
    if value > 1:
        return "green"
    return "red"
colorstr, array-like (default None)

命名颜色或颜色的类列表（命名或十六进制）。

mfolium.Map (default None)

绘制图表的现有地图实例。

tilesstr, xyzservices.TileProvider (default ‘OpenStreetMap Mapnik’)

要使用的地图图块集。可以从folium支持的列表中选择，通过名称查询xyzservices.TileProvider的对象，传递xyzservices.TileProvider对象或传递自定义XYZ URL。 当前内置提供程序列表（当xyzservices不可用时）：

["OpenStreetMap", "CartoDB positron", “CartoDB dark_matter"]

您可以通过将一个Leaflet风格的URL传递给tiles参数来向Folium传递自定义图块集：http://{s}.yourtiles.com/{z}/{x}/{y}.png。请务必查看他们的条款和条件，并使用attr关键字提供归属。

attrstr (default None)

地图瓦片归属；仅在传递自定义瓦片网址时需要。

tooltipbool, str, int, list (default True)

在悬停对象时显示 GeoDataFrame 属性。True 包含所有列。False 移除工具提示。传递字符串或字符串列表以指定列。整数指定包括前 n 列。默认为 True。

popupbool, str, int, list (default False)

输入GeoDataFrame属性以在点击时显示对象。 True包括所有列。 False移除弹出窗口。传递字符串或字符串列表以指定一列（或多列）。整数指定要包含的前n列。默认为False。

highlightbool (default True)

当鼠标悬停在几何图形上时启用高亮功能。

categoricalbool (default False)

如果 False, cmap 将反映正在绘制的列的数值。对于非数值列，这将设置为 True。

legendbool (default True)

在分级色图中绘制图例。
如果未提供 column，则忽略。

schemestr (default None)

分层图分类方案的名称（需要 mapclassify >= 2.4.0）。将会使用一个 mapclassify.classify() 在后台运行。支持所有由 mapclassify 提供的方案（例如 'BoxPlot'， 'EqualInterval'， 'FisherJenks'， 'FisherJenksSampled'， 'HeadTailBreaks'， 'JenksCaspall'， 'JenksCaspallForced'， 'JenksCaspallSampled'， 'MaxP'， 'MaximumBreaks'， 'NaturalBreaks'， 'Quantiles'， 'Percentiles'， 'StdMean'， 'UserDefined'）。参数可以通过 classification_kwds 传递。

kint (default 5)

类别数量

vminNone or float (default None)

cmap的最小值。如果None，则使用要绘制的列中的最小数据值。

vmaxNone or float (default None)

cmap的最大值。如果None，则使用要绘制的列中的最大数据值。

widthpixel int or percentage string (default: ‘100%’)

folium Map的宽度。如果参数 m 被明确给出，则宽度将被忽略。

heightpixel int or percentage string (default: ‘100%’)

folium Map 的高度。如果明确给出了参数 m，则忽略高度。

categorieslist-like

用于分类绘图的类别有序列表对象。

classification_kwdsdict (default None)

传递给mapclassify的关键字参数

control_scalebool, (default True)

是否在地图上添加比例尺。

marker_typestr, folium.Circle, folium.CircleMarker, folium.Marker (default None)

允许的字符串选项有（‘marker’, ‘circle’, ‘circle_marker’）。默认为folium.CircleMarker。

marker_kwds: dict (default {})

额外的关键字将传递给所选的 marker_type，例如：

radiusfloat (default 2 for circle_marker and 50 for circle))

圆的半径，以米为单位（对于 circle）或以像素为单位（对于 circle_marker）。

fillbool (default True)

确定是否用颜色填充 circle 或 circle_marker.

iconfolium.map.Icon

用于渲染标记的 folium.map.Icon 对象。

draggablebool (default False)

设置为 True，以便能够在地图上拖动标记。

style_kwdsdict (default {})

附加样式将传递给 folium style_function:

strokebool (default True)

是否沿路径绘制轮廓。将其设置为 False 以禁用多边形或圆的边框。

colorstr

笔画颜色

weightint

像素中的笔画宽度

opacityfloat (default 1.0)

笔触的不透明度

fillboolean (default True)

是否用颜色填充路径。设置为 False 以禁用多边形或圆圈的填充。

fillColorstr

填充颜色。默认为color选项的值

fillOpacityfloat (default 0.5)

填充不透明度。

style_functioncallable

将GeoJson特征映射到样式的函数 dict。

例如：

lambda x: {"color":"red" if x["properties"]["gdp_md_est"]<10**6
                             else "blue"}

此外，所有这些都由 folium.vector_layers.path_options() 支持。有关详细信息，请参阅 folium.features.GeoJson 的文档。

highlight_kwdsdict (default {})

将样式传递给folium高亮功能。使用与style_kwds相同的关键字。当为空时，默认为{"fillOpacity": 0.75}。

missing_kwdsdict (default {})

缺失值的附加样式：

colorstr

缺失值的颜色。默认为 None，使用Folium的默认值。

labelstr (default “NaN”)

缺失值的图例条目。

tooltip_kwdsdict (default {})

要传递给 folium.features.GeoJsonTooltip 的额外关键字，例如 aliases、labels 或 sticky。

popup_kwdsdict (default {})

要传递给 folium.features.GeoJsonPopup 的附加关键字，例如 aliases 或 labels。

legend_kwdsdict (default {})

要传递给图例的附加关键词。

目前支持的自定义:

captionstring

图例的自定义标题。默认为列名。

当scheme被指定时，接受的其他关键词：

colorbarbool (default True)

一个控制图例样式的选项。如果为True，将使用连续色条。如果为False，将为区间使用分类图例。

scalebool (default True)

根据 bin 边缘沿色条轴缩放 bins（真） 或为每个 bin 使用相等的长度（假）

fmtstring (default “{:.2f}”)

用于图例中类别的分箱边缘的格式规范。例如，要没有小数位：{"fmt": "{:.0f}"}。当colorbar=False时适用。

labelslist-like

一个用于覆盖自动生成标签的图例标签列表。需要与类别的数量（k）具有相同的元素数量。如果 colorbar=False，则适用。

intervalboolean (default False)

控制mapclassify图例中括号的选项。 如果为True，则图例中将显示开/闭区间括号。 适用于 colorbar=False。

max_labelsint, default 10

颜色条刻度标签的最大数量（需要 branca>=0.5.0）

map_kwdsdict (default {})

要传递给 folium Map 的附加关键字，例如 dragging，或 scrollWheelZoom。

**kwargsdict

要传递给folium对象的其他选项。

Returns:
mfolium.folium.Map

folium Map 实例

示例

>>> import geodatasets
>>> df = geopandas.read_file(
...     geodatasets.get_path("geoda.chicago_health")
... )
>>> df.head(2)  
   ComAreaID  ...                                           geometry
0         35  ...  POLYGON ((-87.60914 41.84469, -87.60915 41.844...
1         36  ...  POLYGON ((-87.59215 41.81693, -87.59231 41.816...

[2 行 x 87 列]

>>> df.explore("Pop2012", cmap="Blues")
On this page

这一页