如何在Jupyter Notebook中最大化/全屏显示Kepler GL地图？

我之前也碰到过这个问题！Kepler GL在Jupyter Notebook里默认的输出窗口确实太小，尤其是处理复杂图层的时候特别难受。构造函数的height/width参数之所以没效果，是因为Jupyter单元格的输出容器本身有默认的高度限制，得从突破这个容器限制入手。下面几个方法亲测有效：

方法1：临时修改单元格输出样式（推荐） #

在运行Kepler GL的单元格之前，先执行一个带有自定义CSS的单元格，直接覆盖Jupyter的默认输出区域限制：

%%html
<style>
/* 让输出区域占满大部分屏幕高度 */
.output_area {
    max-height: none !important;
    height: 90vh !important;
    overflow: auto;
}
</style>

• 90vh表示占视口高度的90%，你可以根据需要调整成100vh（全屏）或者具体像素值（比如800px）
• !important用来强制覆盖Jupyter的默认样式，确保生效

之后再运行你的Kepler GL代码，输出窗口就会自动撑大到设置的高度了。

方法2：手动包裹Kepler GL实例 #

如果不想修改全局的单元格样式，也可以把Kepler GL实例放到一个自定义高度的HTML容器里显示：

from keplergl import KeplerGl
from IPython.display import display, HTML

# 假设你的数据是df
map_instance = KeplerGl(data={"my_data": df})

# 用自定义高度的div包裹Kepler的HTML输出
display(HTML(f'<div style="height: 90vh; width: 100%;">{map_instance._repr_html_()}</div>'))

这个方法只会影响当前的Kepler GL实例，不会改变其他单元格的输出样式，适合临时调整单个地图的尺寸。

方法3：全局修改Notebook样式（永久生效） #

如果经常需要用Kepler GL，可以修改Jupyter的全局自定义CSS，让所有输出区域默认都有更大的高度：

1. 找到Jupyter的自定义CSS路径，一般是~/.jupyter/custom/custom.css（如果没有就手动创建这个文件夹和文件）
2. 在文件中添加以下内容：

.output_area {
    max-height: none;
    height: 90vh;
}

3. 重启Jupyter Notebook，之后所有单元格的输出区域都会默认使用这个高度设置。

注意事项 #

• 如果是使用Jupyter Lab，方法1和方法2同样适用，不过Lab的界面布局更灵活，也可以通过拖拽单元格边框手动调整输出区域大小
• 如果你设置了100vh全屏，可能会遮挡Notebook的顶部导航栏，所以90vh是更实用的选择

内容的提问来源于stack exchange，提问作者bluenote10