如何在Python Basemap中实现鼠标点击/悬停显示点位标签？

嘿，这两个问题其实可以借助Matplotlib的事件处理系统轻松解决——毕竟Basemap本身就是基于Matplotlib构建的。另外顺带提一句，Basemap已经停止维护了，更推荐用现代的Cartopy库，我后面也会给出替代方案。先从你当前的需求说起：

一、Basemap中实现悬停+显示文本标签的完整方案 #

核心思路是利用Matplotlib的鼠标移动事件（motion_notify_event）来检测鼠标位置，结合散点图的contains()方法判断是否悬停在点位上，最后用Annotation组件显示地点名称。

完整代码示例 #

from mpl_toolkits.basemap import Basemap
import matplotlib.pyplot as plt

# ---------------------- 1. 准备数据（替换成你从文件读取的真实数据） ----------------------
# 格式：(经度, 纬度, 地点名称)
locations = [
    (116.4074, 39.9042, "北京"),
    (121.4737, 31.2304, "上海"),
    (113.2644, 23.1291, "广州"),
    (108.9398, 34.3416, "西安")
]
lons = [loc[0] for loc in locations]
lats = [loc[1] for loc in locations]
names = [loc[2] for loc in locations]

# ---------------------- 2. 创建Basemap并绘制点位 ----------------------
fig, ax = plt.subplots(figsize=(10, 8))

# 初始化Basemap（这里用圆柱投影，你可以换成自己需要的投影）
m = Basemap(projection='cyl', llcrnrlat=-90, urcrnrlat=90,
            llcrnrlon=-180, urcrnrlon=180, ax=ax)
m.drawcoastlines(linewidth=0.8)
m.drawcountries(linewidth=0.5)

# 将经纬度转换为Basemap的投影坐标
x, y = m(lons, lats)
# 绘制点位，保存散点对象（后续用来检测鼠标悬停）
scatter_points = m.scatter(x, y, c='#ff4444', s=60, zorder=10)

# ---------------------- 3. 初始化悬停注释组件 ----------------------
# 创建一个默认隐藏的注释框，带箭头和圆角样式
hover_annot = ax.annotate(
    "", xy=(0, 0), xytext=(15, 15),
    textcoords="offset points",
    bbox=dict(boxstyle="round,pad=0.3", fc="white", alpha=0.9),
    arrowprops=dict(arrowstyle="->", connectionstyle="arc3,rad=0")
)
hover_annot.set_visible(False)

# ---------------------- 4. 定义悬停事件处理函数 ----------------------
def update_annotation(selected_index):
    """更新注释框的位置和内容"""
    # 获取选中点位的投影坐标
    point_pos = scatter_points.get_offsets()[selected_index["ind"][0]]
    hover_annot.xy = point_pos
    # 设置注释文本为对应地点名称
    location_name = names[selected_index["ind"][0]]
    hover_annot.set_text(location_name)
    # 刷新画布
    fig.canvas.draw_idle()

def on_hover(event):
    """处理鼠标移动事件，判断是否悬停在点位上"""
    current_visibility = hover_annot.get_visible()
    
    # 只处理当前Axes内的事件
    if event.inaxes == ax:
        # 检测鼠标是否在散点范围内
        is_over_point, point_index = scatter_points.contains(event)
        if is_over_point:
            update_annotation(point_index)
            hover_annot.set_visible(True)
        else:
            if current_visibility:
                hover_annot.set_visible(False)
                fig.canvas.draw_idle()

# ---------------------- 5. 绑定事件并显示图形 ----------------------
fig.canvas.mpl_connect("motion_notify_event", on_hover)
plt.title("Basemap点位悬停演示")
plt.show()

关键代码解释 #

• scatter_points.contains(event)：Matplotlib散点对象的内置方法，用来判断鼠标位置是否落在某个点位上，返回布尔值和点位索引。
• Annotation组件：用来创建可动态更新的文本标签，支持设置样式（比如圆角背景、箭头），默认隐藏，悬停时显示。
• motion_notify_event：Matplotlib的鼠标移动事件，每次鼠标移动都会触发on_hover函数。

二、更优方案：用Cartopy替代Basemap #

Basemap已经停止维护多年，Cartopy是官方推荐的替代库，功能更强大且持续更新。实现悬停的逻辑和Basemap完全一致，只需要替换地图初始化的部分：

Cartopy版本代码示例 #

import cartopy.crs as ccrs
import cartopy.feature as cfeature
import matplotlib.pyplot as plt

# 数据部分和上面完全一样
locations = [
    (116.4074, 39.9042, "北京"),
    (121.4737, 31.2304, "上海"),
    (113.2644, 23.1291, "广州"),
    (108.9398, 34.3416, "西安")
]
lons = [loc[0] for loc in locations]
lats = [loc[1] for loc in locations]
names = [loc[2] for loc in locations]

# 初始化Cartopy地图
fig, ax = plt.subplots(figsize=(10, 8), subplot_kw={'projection': ccrs.PlateCarree()})
ax.add_feature(cfeature.COASTLINE.with_scale('50m'), linewidth=0.8)
ax.add_feature(cfeature.BORDERS.with_scale('50m'), linewidth=0.5)
ax.add_feature(cfeature.LAND, facecolor='#f0f0f0')

# 绘制点位（注意要指定坐标转换）
scatter_points = ax.scatter(
    lons, lats, c='#ff4444', s=60, zorder=10,
    transform=ccrs.PlateCarree()
)

# 注释组件和事件处理函数和Basemap版本完全相同
hover_annot = ax.annotate(
    "", xy=(0, 0), xytext=(15, 15),
    textcoords="offset points",
    bbox=dict(boxstyle="round,pad=0.3", fc="white", alpha=0.9),
    arrowprops=dict(arrowstyle="->", connectionstyle="arc3,rad=0")
)
hover_annot.set_visible(False)

def update_annotation(selected_index):
    point_pos = scatter_points.get_offsets()[selected_index["ind"][0]]
    hover_annot.xy = point_pos
    location_name = names[selected_index["ind"][0]]
    hover_annot.set_text(location_name)
    fig.canvas.draw_idle()

def on_hover(event):
    current_visibility = hover_annot.get_visible()
    if event.inaxes == ax:
        is_over_point, point_index = scatter_points.contains(event)
        if is_over_point:
            update_annotation(point_index)
            hover_annot.set_visible(True)
        else:
            if current_visibility:
                hover_annot.set_visible(False)
                fig.canvas.draw_idle()

fig.canvas.mpl_connect("motion_notify_event", on_hover)
plt.title("Cartopy点位悬停演示")
plt.show()

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