如何在Plotly scatter_mapbox图表中显示GeoJSON数据图层？

可能的原因及对应解决方案 #

1. 检查GeoJSON坐标系是否匹配Mapbox要求 #

Mapbox默认采用**WGS84（EPSG:4326）**坐标系，QGIS导出时若未指定正确CRS，会导致图层无法正常渲染：

• 重新在QGIS导出GeoJSON：右键目标图层 → 导出 → 保存要素为...，选择GeoJSON格式，在CRS选项中明确选择EPSG:4326覆盖默认设置。
• 确认坐标顺序：GeoJSON标准为[经度, 纬度]，部分工具可能导出[纬度, 经度]，导致图层偏移或完全不显示。

2. 确认GeoJSON图层添加方式正确 #

scatter_mapbox仅负责渲染散点，GeoJSON图层需通过fig.update_layout(mapbox_layers=...)添加，常见参数错误会导致图层不显示：

示例正确代码：

import plotly.express as px
import json

# 读取CSV散点数据
df = px.data.carshare()
fig = px.scatter_mapbox(df, lat="centroid_lat", lon="centroid_lon",
                        color="peak_hour", size="car_hours",
                        zoom=10, mapbox_style="carto-positron")

# 读取GeoJSON文件
with open("your_layer.geojson") as f:
    geojson_data = json.load(f)

# 添加GeoJSON图层（岛屿用fill，街道用line）
fig.update_layout(
    mapbox_layers=[
        {
            "source": geojson_data,
            "type": "fill",  # 街道图层替换为"line"
            "color": "#666666",
            "opacity": 0.4,
            "below": "traces"  # 确保图层在散点下方显示，避免被遮挡
        }
    ]
)

fig.show()

• 务必根据图层类型设置type参数：填充类图层用fill，线类图层用line。
• below: "traces"是关键配置，否则GeoJSON图层可能被散点完全遮挡。

3. 校验GeoJSON格式完整性 #

虽其他应用能显示，但Plotly对GeoJSON格式兼容性要求更严格：

• 使用geojson-validate库本地校验格式：
  安装库：pip install geojson-validate
  校验代码：

  from geojson_validate import validate
  
  with open("your_layer.geojson") as f:
      data = json.load(f)
  print(validate(data))  # 返回True表示格式符合RFC 7946标准
  

• 确保GeoJSON的features数组非空，且每个feature包含geometry和properties字段（properties可为空对象）。

4. 调整Plotly版本 #

Plotly 5.x系列对Mapbox图层的处理存在版本差异，尝试升级或降级版本：

# 升级到最新稳定版
pip install --upgrade plotly
# 或降级到5.3.0（部分用户反馈该版本对GeoJSON支持更稳定）
pip install plotly==5.3.0

5. 排查Mapbox样式影响 #

部分深色或卫星类Mapbox样式会掩盖浅色GeoJSON图层，尝试切换基础样式：

fig = px.scatter_mapbox(..., mapbox_style="open-street-map")

同时可调整GeoJSON图层的color和opacity参数，增强图层对比度。

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