使用GeoPandas探索GeoJSON LineString时的交互地图异常问题

原始代码 #

import geopandas

data = {
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "GeometryCollection",
                "geometries": [
                    {
                        "type": "LineString",
                        "coordinates": [
                            [-118, 32], [-119, 33], [-120, 34], [-121, 35], [-122, 36], [-123, 37], [-124, 38]
                        ]
                    }
                ]
            },
            "properties": {
                "provider": "MyProvider"
            }
        }
    ]
}

gdf = geopandas.GeoDataFrame.from_features(data)
gdf.explore()

运行时警告 #

UserWarning: GeoJsonTooltip is not configured to render for GeoJson GeometryCollection geometries. Please consider reworking these features: [{'provider': 'MyProvider'}] to MultiPolygon for full functionality.

问题 #

运行代码时出现上述警告，地图瓦片无法加载，但GeoJSON定义的线条能正常显示；用gdf.plot()可以得到预期图像，但需要explore()提供的交互式地图瓦片。想知道这个警告的具体含义，以及怎么修改数据解决问题。

解答 #

警告含义 #

这个警告的核心是：explore()依赖的GeoJsonTooltip（交互式地图的提示框组件）不支持处理GeometryCollection类型的几何图形。提示里提到改成MultiPolygon只是针对多边形场景的通用建议——你的场景里是单个LineString，完全没必要用GeometryCollection包裹，这种冗余结构会导致提示组件失效，甚至干扰地图瓦片的加载逻辑。

修改方法 #

直接简化GeoJSON的几何结构，去掉GeometryCollection这一层，直接用里面的LineString作为Feature的geometry即可。

修改后的代码如下：

import geopandas

data = {
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [-118, 32], [-119, 33], [-120, 34], [-121, 35], [-122, 36], [-123, 37], [-124, 38]
                ]
            },
            "properties": {
                "provider": "MyProvider"
            }
        }
    ]
}

gdf = geopandas.GeoDataFrame.from_features(data)
gdf.explore()

修改后，explore()就能正常加载交互式地图瓦片，同时GeoJsonTooltip也能正常工作，鼠标悬停在线条上时会显示对应的属性信息。

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