项目技术文档：基于公共交通时刻表的地图动画

1. 安装指南

环境要求

• 需要一个Web服务器（例如Apache）。
• 需要一个现代浏览器（如Chrome、Firefox等）。

安装步骤

1. 克隆或下载项目到Web服务器可访问的目录中。
2. 在浏览器中访问项目路径（例如：http://localhost/transit-map/）。
3. 你应该会看到地图上开始有动画效果。

2. 项目使用说明

项目概述

该项目通过使用公共交通时刻表，在地图上插值车辆（标记）沿路线（折线）的位置，从而实现车辆的动画效果。

自定义配置

项目的主要配置文件是static/js/config.js，其中包含多个参数，用户可以根据需要进行调整。以下是一些关键参数的说明：

地图中心

• center.x：地图中心的经度，值为十进制。
• center.y：地图中心的纬度，值为十进制。

地图类型

• map_type_id：初始地图类型，可选值为roadmap、satellite、terrain、stamen。

缩放级别

• zoom.start：初始地图缩放级别，值范围为1到21。
• zoom.min：最小地图缩放级别。
• zoom.max：最大地图缩放级别。

其他参数

• hms：覆盖一天中的时间，格式为hh:mm:ss。
• time_multiply：加速模拟时间，可选值为1、5、10、100。
• view_mode：视图模式，可选值为iframe，适用于IFRAME集成。

示例

• 使用Stamen水彩地图，中心经度为8.7，纬度为47.18，初始缩放级别为11，模拟时间为10:20:30，时间加速10倍：

  ?center.x=8.7&center.y=47.18&zoom.start=11&map_type_id=stamen&hms=11:20:30&time_multiply=10
  

3. 项目API使用文档

API路径

• api_paths.trips：获取指定时间（hhmm）的所有车辆（或GTFS行程）的API。
• api_paths.departures：获取指定站点（stop_id）在指定时间（hhmm）的出发车辆的API。

GeoJSON路径

• geojson.gtfs_shapes：包含GTFS形状的GeoJSON FeatureCollection。
• geojson.gtfs_stops：包含GTFS站点的GeoJSON FeatureCollection。

示例

• 获取10:20时间的所有车辆：

  api/getTrips/1020
  

• 获取站点stop_id在10:20时间的出发车辆：

  api/getDepartures/stop_id/1020
  

4. 项目安装方式

克隆项目

git clone https://github.com/vasile/transit-map.git

下载项目

直接从GitHub页面下载ZIP文件并解压到Web服务器目录中。

访问项目

在浏览器中访问项目路径，例如：

http://localhost/transit-map/

5. 其他说明

联系作者

如果有其他问题或需要帮助，可以通过Twitter（@vasile23）或发送邮件至作者邮箱联系作者。

许可证

该项目采用MIT许可证，详细信息请参阅项目LICENSE文件。