Field Service Routing：提交官方示例测试数据集出现验证错误

问题场景 #

• 严格遵循Field Service Routing的Hello World教程操作，完全复制文档提供的输入数据集提交至API
• 提交接口响应正常，但调用GET v1/route-plans/{my-id}轮询解决方案时，返回如下验证错误：

"validationResult": {
    "summary": "ERRORS",
    "errors": [
        "The location (latitude=33.68786, longitude=-84.18487) is out of the map coverage.",
        "The location (latitude=33.77301, longitude=-84.43838) is out of the map coverage."
    ]
}

解决方法 #

1. 调整服务的地图覆盖配置 #

默认情况下，Timefold FSR服务可能仅启用了局部区域的地图数据（比如欧洲区域），而示例数据坐标位于美国亚特兰大附近，不在默认覆盖范围内：

• 若为自部署服务：修改application.properties配置文件，添加timefold.fsr.map.coverage=global，然后重启服务
• 若使用Timefold Cloud服务：在控制台的服务配置面板中切换到全球覆盖的地图选项

2. 在请求体中显式指定全球地图覆盖 #

提交路由规划请求时，直接在输入数据集的根层级添加地图覆盖参数，强制使用全球范围的地图数据：

{
  "mapCoverage": "GLOBAL",
  "vehicles": [...],
  "jobs": [...],
  // 其他原有字段
}

3. 快速验证坐标有效性 #

示例数据的坐标（纬度33.xx，经度-84.xx）符合纬度-90~90、经度-180~180的标准范围，此步骤仅用于排除意外的格式错误。

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