数据要求
标准路网数据
路网由线层文件和点层文件组成，两个文件存在关联关系，这两个文件一般是以下格式：
路网样例数据：西安样例路网数据下载
Note
路网点层数据和线层数据的坐标系必须为：EPSG:4326
路网-点层
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| node_id | int |
节点唯一编码，大于0的正整数，对应线层表的from_node、to_node |
| geometry | geometry |
节点坐标几何列 |
Note
点层表的geometry字段中不允许出现MultiPoint类型，不支持三维坐标
路网-线层
路网线层文件字段要求如下：
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| link_id | int |
必需字段，路段唯一编码, 一定是大于0的正整数 |
| from_node | int |
必需字段，路段拓扑起点节点编号, 一定是大于0的正整数 |
| to_node | int |
必需字段，路段拓扑终点节点编号, 一定是大于0的正整数 |
| dir | int |
必需字段，路段通行方向，0或1或-1， 0代表双向通行，1代表通行方向为路段拓扑正向，-1代表通行方向为路段拓扑反向 |
| length | float |
必需字段，路段长度，单位米 |
| speed | float |
非必需字段，路段限速，单位km/h，启用st-match时需要 |
| geometry | geometry |
必需字段，路段几何线型 |
Note
线层表的geometry字段中不允许出现MultiLineString类型，只允许LineString类型，不支持三维坐标
点层、线层关联关系
-
线层
dir字段与拓扑方向：线层的箭头方向为拓扑方向(即link层geometry中折点的行进方向)，dir字段所描述的行车方向就是与之关联的，dir=1代表该条link是单向路段，行车方向与拓扑方向一致，dir=0代表该条link是双向路段 -
点层
node_id与线层from_node、to_node关联：link层中：一条link的from_node、to_node属性对应节点层的node_id
标准路网数据可以在QGIS或者TransCAD等其他GIS软件中进行可视化：
标准路网样例数据
这里提供了西安市的某片区的线层、点层样例数据：
如果您没有想要研究区域的路网数据，请参考gotrackit的路网生产模块或者使用osmnx
GPS定位数据
GPS轨迹数据字段要求如下：
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| agent_id | string |
车辆唯一编码，准确来说这个字段标注的是车辆的某一次完整出行 |
| lng | float |
经度 |
| lat | float |
纬度 |
| time | string |
定位时间戳 |
| 其他非必需字段 | -- |
----- |
一个定位数据表中可以包含≥1个agent的轨迹数据，gotrackit会依次对不同的agent进行路径匹配。
关于时间列
有轨迹数据作为输入的模块，基本都要求指定time_format和time_unit两个参数，关于这两个参数的解释如下：
time_format：GPS数据中时间列的格式化字符串模板, 默认"%Y-%m-%d %H:%M:%S"。如果您的时间列数据是字符串模板，请指定该参数，可以参照pandas中pd.to_datetime()函数的format参数time_unit： GPS数据中时间列的单位, 默认"s"。如果您的时间列数据是数值，如秒(s)或者毫秒(ms)，请指定该参数。
注意时间列
time列用于确定点的先后顺序，不允许有重复值，如果你的数据没有时间列，请自己赋值一个时间列且确保没有重复值
带途径点的OD数据
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| od_id | int |
车辆唯一编码，准确来说这个字段标注的是车辆的某一次完整出行 |
| o_x | float |
起点经度，不允许为空 |
| o_y | float |
起点纬度，不允许为空 |
| d_x | floatg |
终点经度，不允许为空 |
| d_y | float |
终点纬度，不允许为空 |
| hh | int |
请求时段(0~23), 非必须字段 |
| way_points | string |
途径点坐标串，最多支持10个途径点，允许为空值(多坐标点以 ; 分割) |
关于hh字段
- 关于如果对OD有具体的请求时段限制，请确保有hh列，且将请求参数ignore_hh置为False，不允许有空值；如果没有时段限制, 该列可以不提供
样例OD数据如下：
| od_id | o_x | o_y | d_x | d_y | way_points |
|---|---|---|---|---|---|
| 1 | 120.73054 | 31.67264 | 120.73338 | 31.66751 | 120.73176,31.67052 |
| 2 | 120.73050 | 31.66643 | 120.74717 | 31.66991 | 120.73119,31.6669;120.7380,31.669 |
| 3 | 120.74229 | 31.66071 | 120.74250 | 31.65282 |
平面投影坐标系plain_crs
平面投影坐标系有很多种，这里仅仅列出平面投影6度带的划分，按照经度，每6度对应一个平面投影坐标系，可以按照研究范围的中心点经纬度参照下表选取
| 经度划分 | -180 ~ -174 | -174 ~ -168 | ... | 108 ~ 114 | ... | 174 ~ 180 |
|---|---|---|---|---|---|---|
| plain_crs | EPSG:32601 | EPSG:32602 | ... | EPSG:32649 | ... | EPSG:32660 |
如果你的研究区域是世界范围，那么你可以使用EPSG:3857，这个平面投影坐标系适用于全球任何地区，关于坐标的更多知识请参考epsg.io
关于坐标系的入门简单介绍，可以参考技术博客-坐标系