Repast官方示例文件无法正常显示背景地图问题求助

通用根因 #

官方示例默认配置的在线底图瓦片源大多已停止服务，同时Windows系统默认权限、网络规则也可能拦截瓦片资源请求。

分步修复操作 #

• 替换失效在线瓦片源
  打开对应模型的GIS Display设置面板，找到「Base Map」配置项：
  • Geotracks案例默认使用的NASA Blue Marble在线瓦片源已下线，手动切换为内置的OpenStreetMap Standard源即可正常加载全球底图；如需保留蓝色星球样式，可自行下载Blue Marble瓦片包配置为本地底图
  • Geography案例的芝加哥周边地图缺失是默认瓦片源缩放层级限制导致，将缩放层级范围调整为1-18，同时开启瓦片本地缓存即可正常加载周边区域
• 调整Windows系统权限与网络规则
  • 临时关闭Windows Defender防火墙测试，如果底图恢复加载，在防火墙出入站规则中添加Repast程序的访问许可，允许其访问80、443端口获取瓦片资源
  • 打开Repast安装目录下的repast.properties配置文件，将瓦片缓存路径修改为当前用户可读写的目录，例如C:/Users/你的用户名/RepastCache，避免默认安装在Program Files目录下无写入权限导致瓦片缓存失败
• 适配本地配置路径
  检查模型目录下的gis.xml配置文件，将所有硬编码的绝对路径替换为./开头的相对路径，适配模型在本地的实际存储位置。

北极仿真项目前置建议 #

后续开发北极海上交通仿真时，建议提前预下载北极区域自定义瓦片包配置为本地底图，避免仿真过程依赖在线网络：使用QGIS导出对应区域、对应缩放层级的瓦片包，存储到本地目录后，在Repast的GIS Display设置中选择「Local Tile Cache」指向瓦片包根目录即可。

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