设置kivy_garden.mapview的zoom属性导致地图被蓝色遮挡

问题分析 #

地图被蓝色遮挡的核心原因是设置的zoom值超出了MapView支持的有效范围，导致无法加载对应级别的地图瓦片，最终显示控件默认的蓝色背景。另外代码中存在明显参数错误：set_zoom_at(100, ...)里的100完全不在zoom的合理取值范围内。

MapView的zoom有效值通常在**1（全局视图）到19（精细街道视图）**之间，具体范围可能因瓦片服务略有差异，但100这类数值肯定不在支持范围内。

修复步骤 #

1. 修正初始化时的zoom参数
   初始化MapView时使用有效范围内的zoom值，示例：

   self.map = MapView(size_hint=(1, 1), zoom=10)  # 选择1-19之间的数值
   

2. 修正set_zoom_at的参数错误
   在connetti方法中，把set_zoom_at的第一个参数改为合理的zoom值，比如15：

   self.map.set_zoom_at(15, device_latitude, device_longitude)
   

3. 可选：验证瓦片服务可用性
   若修正zoom后仍显示蓝色，检查网络连接是否正常（MapView默认加载在线瓦片），或确认所用瓦片服务支持你设置的zoom级别。

关键代码修正片段 #

# 初始化MapView时设置有效zoom值
self.map = MapView(size_hint=(1, 1), zoom=10)

# connetti方法中的修正部分
marker = MapMarker(lat=device_latitude, lon=device_longitude)
self.map.add_marker(marker)
self.map.set_zoom_at(15, device_latitude, device_longitude)  # 修正超出范围的zoom值
marker.bind(on_press=lambda x: DeviceInfoPopup(device_name, device_battery, device_altitude).open())

效果说明 #

修正后，MapView将正常加载对应zoom级别的地图瓦片，标记点也会精准定位在目标位置，不会再出现蓝色遮挡的情况。

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