* 获取刻度的位置百分比 * @param {Object} tickData - 刻度数据 * @returns {number} 位置百分比

* 处理事件卡片点击 * @param {Object} event - 事件对象

* 处理图层切换 * @param {Event} e - 事件对象

* 处理搜索 * @param {Event} e - 事件对象

* 处理视图切换 * @param {Event} e - 事件对象

* 处理年份变化 * @param {number} year - 新的年份值

* 初始化类别按钮

* 初始化类别筛选

* 初始化事件过滤器

* 初始化介绍页面

* 初始化地图

* 检查指定位置是否在时间轴区域内 * @param {number} x - 客户端X坐标 * @param {number} y - 客户端Y坐标 * @returns {boolean} 是否在时间轴区域内

* 加载农业数据 * @returns {Promise<Array>} 农业数据数组

* 加载所有历史事件数据 * @returns {Promise<Array>} 历史事件数组

* 加载文明数据 * @returns {Promise<Array>} 文明数据数组

* 加载数据

* 加载疾病数据 * @returns {Promise<Array>} 疾病数据数组

* 从本地路径加载指定年份的GeoJSON数据 * @param {number} year - 目标年份 * @returns {Promise} 返回解析后的GeoJSON数据的Promise

* 加载初始数据

* 加载迁徙数据 * @returns {Promise<Array>} 迁徙数据数组

* 加载物种数据 * @returns {Promise<Array>} 物种数据数组

* 加载技术发展数据 * @returns {Promise<Array>} 技术发展数据数组

* 加载战争数据 * @returns {Promise<Array>} 战争数据数组

* 显示下一步

* 标准化不同格式的GeoJSON数据 * @param {Object} data - GeoJSON数据 * @returns {Object} 标准化后的GeoJSON数据

* 时间轴区域准备就绪的回调函数 * 此方法由TimelineManager调用，用于协调地图与时间轴的交互 * @param {TimelineManager} timelineManager - 时间轴管理器实例

* 显示上一步

* 设置容器直接拖动功能 * 允许用户直接在滑块容器区域拖动来改变时间

* 设置事件监听器

* 设置地图拖动禁用功能 * 在时间轴区域禁用地图拖动，但不干扰时间轴内部控件的操作

* 设置滑块事件处理

* 设置时间轴区域的事件处理 * 这是集中处理所有时间轴区域事件的地方

* 显示事件详情 * @param {Object} event - 事件对象

* 显示事件详情 * @param {string} eventId - 事件ID

* 显示事件列表帮助信息

* 显示介绍页面

* 切换时间轴播放状态

* 更新当前年份刻度线 * @param {number} year - 当前年份

* 更新年份范围显示 * @param {number} year - 当前年份

* 缓存GeoJSON到本地

* 计算迁徙群体当前位置 * @param {Object} migration - 迁徙路线对象 * @param {number} progress - 完成百分比(0-1) * @returns {Array} 迁徙群体当前位置

* 根据时间计算迁徙路线的完成百分比 * @param {Object} migration - 迁徙路线对象 * @param {number} year - 目标年份 * @returns {number} 完成百分比(0-1)

* 构造函数 * @param {string} eventsListId - 事件列表容器ID * @param {string} eventDetailsId - 事件详情容器ID

* 构造函数

* 构造函数 * @param {string|Object} options - 滑块ID或配置选项 * @param {string} [yearInput] - 年份输入框ID * @param {number} [initialYear] - 初始年份

* 创建世界历史可视化应用实例 * @param {Object} options - 配置选项 * @param {string} options.mapContainer - 地图容器ID * @param {string} options.timelineCont

* 将迁徙路线转换为GeoJSON * @param {Object} migration - 迁徙路线对象 * @param {number} progress - 完成百分比(0-1) * @returns {Object} GeoJSON LineString对象

* 创建事件弹出框内容 * @param {Object} feature - GeoJSON特征 * @returns {string} HTML内容

* 创建迁徙路线弹出框内容 * @param {Object} feature - GeoJSON特征 * @returns {string} HTML内容

* 将事件数据转换为GeoJSON点 * @param {Array} events - 事件数组 * @returns {Object} GeoJSON FeatureCollection

* 过滤指定时间内活跃的迁徙路线 * @param {Array} migrations - 迁徙路线数组 * @param {number} year - 目标年份 * @returns {Array} 过滤后的迁徙路线数组