博创联动开放平台API数据获取指南

"博创联动开放平台提供了丰富的接口用于获取车辆相关的数据，包括车辆历史轨迹、最新作业信息、车辆位置、在线状态、最新点位、作业统计、累计里程、车辆信息以及作业段数据等。重要参数包括设备编号（did与vin）、查询时间范围、分页大小、密钥等。此外，查询车辆在线状态需要指定在线定义的时间范围，而车辆作业统计则需要指定日期和统计类型。用户可以通过登录博创联动开放平台，在http://open.umlxny.com/index.html#/development获取更多接口详情。" 博创联动开放平台是一个面向开发者提供的API接口平台，允许开发者通过发送HTTP请求获取车辆的各种实时和历史数据。这个平台的数据接口返回字段和参数详细记录在附件中，包括“博创联动开放平台数据接口返回字段归纳.xlsx”和“config_字段对照表.xml”。 1. **车辆历史轨迹查询**： - 请求参数：设备编号（did与vin）、查询起止时间。 - 示例：使用Python的requests库，根据不同的查询条件定制payload。 2. **车辆最新作业信息**： - 请求参数：设备编号、查询时间。 - 示例：与车辆历史轨迹查询接口类似，可能需要提供did或vin。 3. **车辆位置信息**： - 请求参数：与车辆最新作业信息接口相同。 - 示例：同样需要设备编号和可能的时间信息。 4. **车辆在线状态**： - 请求参数：设备编号、在线定义的时间范围。 - 示例：需要确定车辆在多长时间内上传过数据才视为在线，并可以选择查询当天上线次数。 5. **最新点位信息**： - 请求参数：与上述接口相同。 - 示例：查询车辆的最新地理位置信息。 6. **车辆作业统计**： - 请求参数：日期、统计类型。 - 示例：统计指定日期内的作业数据，按日、周、月、年或总计。 7. **车辆累计里程**： - 请求参数：与车辆作业统计接口相同。 - 示例：获取车辆的总行驶里程。 8. **车辆信息**： - 请求参数：设备编号。 - 示例：查询车辆的基本信息。 9. **作业段数据查询**： - 请求参数：与车辆CAN数据查询接口相同。 - 示例：获取车辆的作业段数据。 10. **车辆是否上报数据查询**： - 请求参数：设备编号。 - 示例：检查车辆最近是否向平台发送过数据。 在使用这些接口时，需要注意每个接口的请求参数，特别是设备编号（did和vin至少需要一个）、查询时间范围和密钥。分页大小参数用于处理大量查询结果，首次查询时可能不需要，但在后续翻页时是必需的。此外，对于车辆在线状态查询，还需要定义“在线”的时间范围，以及是否统计当天的上线次数。所有请求都需要遵循平台提供的API文档，正确构造请求URL和参数，以确保数据获取的准确性和完整性。