本页介绍了如何使用 Roads Selection API 更新您已创建的路线：
更新路由
如需更新路线，请向 patch 端点发送 PATCH 请求：
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID?updateMask=UPDATE_MASK
请求正文必须是一个 JSON 对象，其中包含要更新的 SelectedRoute 的字段。可更新的字段包括 displayName、routeAttributes 和 dynamicRoute。更新路线几何图形 (dynamicRoute) 时，您必须提供整个 dynamicRoute 对象（起点、目的地和中间途经点）。不支持部分子字段更新。无法修改只读系统字段，例如 name、createTime 和 state。BigQuery 中的历史数据将保留同一 selectedRouteId 下旧几何图形和更新后几何图形的数据。如果您需要单独的历史数据，请创建新路线，而不是执行更新。
更新路线的几何图形 (dynamicRoute) 需要重新验证该路线。
当路线处于 STATE_RUNNING 或 STATE_INVALID 状态时，允许进行几何图形更新；当路线处于 STATE_VALIDATING 或 STATE_DELETING 状态时，则拒绝进行几何图形更新。如需了解详情，请参阅验证和路线状态。
在除 STATE_DELETING 之外的所有状态下，都可以更新元数据，例如 displayName 或 routeAttributes。
以下代码示例展示了向 patch 端点发送的 PATCH 请求的结构：
curl -X PATCH -d '{
"dynamicRoute": {
"origin": {
"latitude": 38.5817,
"longitude": -121.4944
},
"destination": {
"latitude": 38.5449,
"longitude": -121.7405
}
}
}' \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/"\
"PROJECT_NUMBER/selectedRoutes/"\
"SELECTED_ROUTE_ID?updateMask=dynamicRoute"成功后，该 API 会返回更新后的 SelectedRoute 资源：
{ "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID", "dynamicRoute": { "origin": { "latitude": 38.5817, "longitude": -121.4944 }, "destination": { "latitude": 38.5449, "longitude": -121.7405 } }, "createTime": "2026-08-14T20:58:41.345418Z", "state": "STATE_VALIDATING" }
批量更新路线
如需在单个请求中更新多条路线，请使用 batchUpdate 端点。此端点可让您通过一次调用更新最多 1,000 条路线。批量更新是原子性的：如果请求中的任何路线未能通过验证或无法更新，则不会修改批次中的任何路线。
向 batchUpdate 端点发送 POST 请求：
https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchUpdate
请求正文必须是包含 requests 数组的 JSON 对象。此数组中的每个对象都是一个 UpdateSelectedRouteRequest，用于指定路线 name、可选的商品级 updateMask 以及要更新的 selectedRoute 字段。
updateMask 是一个可选参数，用于指定要更新的字段列表（displayName、routeAttributes 或整个 dynamicRoute 对象）。将值设置为 updateMask=* 表示完全替换。updateMask 可在 requests 中每个单独的商品内指定，也可移至批量请求正文的顶层，以应用于批次中的所有更新路线。如果省略 updateMask，则表示要更新请求中填充的所有可更新字段。如果在批次级和商品级都设置了 updateMask，则这两个值必须一致。指定冲突的掩码会导致 INVALID_ARGUMENT 错误。
以下代码示例展示了向 batchUpdate 端点发送的 POST 请求的结构：
curl -X POST -d '{
"requests": [
{
"selectedRoute": {
"name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_1",
"displayName": "DISPLAY_NAME_1",
"dynamicRoute": {
"origin": {"latitude": 37.5, "longitude": -122.1},
"destination": {"latitude": 37.8, "longitude": -122.5}
}
},
"updateMask": "displayName,dynamicRoute"
},
{
"selectedRoute": {
"name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_2",
"displayName": "DISPLAY_NAME_2",
"dynamicRoute": {
"origin": {"latitude": 37.5, "longitude": -122.1},
"destination": {"latitude": 37.8, "longitude": -122.5}
}
},
"updateMask": "displayName,dynamicRoute"
}
]}' \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/"\
"PROJECT_NUMBER/selectedRoutes:batchUpdate"成功后，API 会返回一个包含已更新的 SelectedRoute 资源数组的响应：
{ "selectedRoutes": [ { "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_1", "displayName": "DISPLAY_NAME_1", "dynamicRoute": { "origin": { "latitude": 37.5, "longitude": -122.1 }, "destination": { "latitude": 37.8, "longitude": -122.5 } }, "createTime": "2026-08-14T20:58:41.345418Z", "state": "STATE_VALIDATING" }, { "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_2", "displayName": "DISPLAY_NAME_2", "dynamicRoute": { "origin": { "latitude": 37.5, "longitude": -122.1 }, "destination": { "latitude": 37.8, "longitude": -122.5 } }, "createTime": "2026-08-14T20:58:41.345418Z", "state": "STATE_VALIDATING" } ] }