findsequence2 API的timingCompatibility参数作用及可传入值咨询

timingCompatibility参数说明 #

• 该参数为API内部遗留兼容参数，未对外公开说明是因为仅用于适配旧版API的时间计算逻辑，不推荐普通开发者使用
• 合法取值仅包含两类：
  • pre8.18：使用v8.18版本之前的时间计算规则，不包含部分特殊场景（货车限行、实时路况修正）的时间偏移逻辑
  • latest：使用当前最新版本的时间计算规则，为接口默认值
• 该参数的作用范围仅为时间计算逻辑的版本适配，完全不支持出发时间调整、站点时间窗匹配的相关功能，你尝试用该参数实现业务需求无法生效是正常情况。

匹配首个站点开放时间的实现方案 #

你的需求是自动延迟车辆出发时间，适配首个站点的开放时段，不需要用到timingCompatibility参数，使用接口公开的时间窗、出发时间优化参数即可实现，配置步骤如下：

1. 给路径序列中的首个站点配置时间窗参数，在对应waypoint的参数中添加timeWindowStart和timeWindowEnd，取值为RFC3339格式的时间字符串，示例：
   &waypoint1=stopOver,timeWindowStart=2024-05-20T09:00:00+08:00;timeWindowEnd=2024-05-20T18:00:00+08:00;30.123,120.456
   以上示例代表首个站点的开放时段为北京时间2024年5月20日9点到18点。
2. 全局请求参数添加两个配置：
   • departureTime=any：允许接口自动调整出发时间
   • optimize=departureTime：开启出发时间优化策略，优先适配首个站点的时间窗要求
3. 如果是货车场景，需要同步在请求中添加transportMode=truck及对应的货车参数（车重、车高等），接口会自动计算货车的行驶时长，调整出发时间保证车辆在首个站点的开放时段内到达。

内容的提问来源于stack exchange，提问作者HakunaMatmata