如何在Python Kivy的MapView中添加绑定地图的圆形标记

问题 #

我尝试在MapView的指定位置添加圆形，要求半径使用地图画布单位，且圆形在地图移动或缩放时始终绑定在该位置。希望仅通过Python代码实现（不使用kv文件），但以下代码无法达到预期效果：

class Circle(MapMarkerPopup):
    def __init__(self, **kwargs):
        super(Circle, self).__init__(**kwargs)
        with self.canvas:
            Color(0, 0, 0, .6)
            Line(circle=(self.x, self.y, 10), width=200)

原因 #

• 初始化时绘制的画布元素不会随MapView的移动/缩放自动更新，self.x和self.y仅为初始值，无法实时同步地图变化
• MapMarkerPopup的坐标逻辑不适合直接绑定自定义画布元素，无法自动响应地图变换

解决代码 #

纯Python实现的正确方案，通过监听地图变换事件实时更新圆形位置：

from kivy.garden.mapview import MapView
from kivy.graphics import Color, Line
from kivy.uix.widget import Widget

class MapCircle(Widget):
    def __init__(self, map_view, lat, lon, radius, **kwargs):
        super().__init__(**kwargs)
        self.map_view = map_view
        self.lat = lat
        self.lon = lon
        self.radius = radius  # 画布单位半径

        # 初始化圆形绘制元素
        with self.canvas:
            Color(0, 0, 0, 0.6)
            self.circle_line = Line(width=2)

        # 绑定地图更新事件，每次移动/缩放时刷新圆形
        self.map_view.bind(on_map_rel=self.update_circle)
        self.update_circle()

    def update_circle(self, *args):
        # 经纬度转屏幕坐标
        x, y = self.map_view.get_window_xy_from(self.lon, self.lat)
        # 转换为MapView内部相对坐标
        rel_x = x - self.map_view.x
        rel_y = y - self.map_view.y
        # 更新圆形位置和半径
        self.circle_line.circle = (rel_x, rel_y, self.radius)

# 使用示例
class CustomMapView(MapView):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        # 添加圆形：传入地图实例、纬度、经度、画布半径
        self.add_widget(MapCircle(self, 40.7128, -74.0060, 30))

说明 #

• 用Widget替代MapMarkerPopup，避免Marker默认行为干扰画布元素
• 通过get_window_xy_from将目标经纬度转换为屏幕坐标，再适配MapView的内部偏移
• 监听on_map_rel事件，确保地图每次变换时圆形都同步更新位置，始终绑定目标地点

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