成功执行后,服务将返回事件点和所选设施点之间的最佳路径和行驶方向;同时显示一个状态,通过以下输出参数指示分析是否成功:
output_closest_facilities
可利用此输出参数访问距离事件点最近的设施点。该参数提供来自相应输入设施点的设施点位置和属性信息。
以下提供针对各个路径返回的字段说明:
字段名 | 描述 |
---|---|
OID | 路径的唯一标识符。该标识符由服务自动生成。 |
FacilityOID | 由输出设施点表示的输入设施点 ObjectID 值。该字段通常用于连接来自输入设施点的信息。 |
output_routes
使用此参数可访问生成的路径或设施点与事件点之间的路径。route_shape 和 route_line_simplification_tolerance 这两个参数会对输出路径的形状造成极大影响。路径几何会以指定为 env:outSR 参数的空间参考的形式返回。
以下提供针对各个路径返回的字段说明:
字段名 | 描述 |
---|---|
OID | 路径的唯一标识符。该标识符由服务自动生成。 |
Name | 最近设施点路径的名称基于相关设施点和事件点的名称。 如果将 Facility to Incident 指定为 travel_direction 参数,则设施点名称在前。例如,Facility 5—Incident 3 表示从设施点 5 到事件点 3 的行驶路径。 而如果将 Incident to Facility 指定为 travel_direction 参数,则事件点名称在前,例如 Incident 3—Facility 5。 |
FacilityID | 路径上设施点的唯一 ID。如果在指定 facilities 参数时包括 ID 属性,则 FacilityID 的值与 ID 属性的值相同。否则,FacilityID 将包含自动生成的标识符。 |
FacilityOID | 用于生成路径的输入设施点 ObjectID 值。该字段通常用于连接设施点到路径的信息。 |
FacilityRank | 某设施点在为相关事件点找到的所有设施点中的等级;最近设施点的等级为 1。 |
FacilityCurbApproach | 描述到达或离开设施点时设施点在车辆的哪一侧。值 1 表示在车辆的右侧;值 2 表示在车辆的左侧。 |
IncidentID | 路径上事件点的唯一 ID。如果在指定 incidents 参数时包括 ID 属性,则 IncidentID 的值与 ID 属性的值相同。否则,IncidentID 将包含自动生成的标识符。 |
IncidentOID | 用于生成路径的输入事件点 ObjectID 值。该字段通常用于连接事件点到路径的信息。 |
IncidentCurbApproach | 描述到达或离开事件点时事件点位于车辆的哪一侧。值 1 表示在车辆的右侧;值 2 表示在车辆的左侧。 |
Shape_Length | 路径长度,单位采用针对路径几何指定的空间参考。如果未指定 env:outSR 参数,则默认采用十进制度。 |
Total_Minutes | 设施点和事件点之间路径的累积行驶时间,以分钟为单位。 |
Total_Miles | 设施点和事件点之间路径的累积行驶距离,以英里为单位。 |
Total_Kilometers | 设施点和事件点之间路径的累积行驶距离,以千米为单位。 |
StartTime | 路径的开始时间,报告为第一个停靠点的本地时间。 |
EndTime | 路径的结束时间,报告为最后一个停靠点的本地时间。 |
StartTimeUTC | 以协调世界时间 (UTC) 格式给出的路径开始时间。 |
EndTimeUTC | 以协调世界时间 (UTC) 格式给出的路径结束时间。 |
output_directions
使用此参数可访问设施点和事件点之间各个生成的路径的逐步行驶方向。此参数包括行驶方向以及文本相应方向要素的几何。方向要素的形状由路径中包括的基础街道确定。要素几何会以指定为 env:outSR 参数的空间参考的形式返回。如果 populate_directions 参数为 false,则要素为空。directions_language、directions_distance_units 和 directions_style_name 参数会对行驶方向造成极大影响。
以下为针对方向要素返回的字段的说明:
字段名 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectID | 方向要素的唯一标识符。该标识符由服务自动生成。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RouteName | 驾驶操作所应用到的路径的名称。该值与 output_routes 参数的 Name 属性值相同。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | 每天启动给定驾驶操作的时间。如果路径跨越多天,将显示日期和时间。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
类型 | 指示方向要素代表的行进策略类型或方向文本类型。要确定 Type 指的是行进策略类型还是方向字符串类型,请检查 SubItemType 字段的值。 例如,在应用程序中显示行驶方向时,Type 类型可根据行进策略类型为方向分配不同的图标,或根据方向字符串类型使用特殊格式样式 Type 值是如下所示行进策略类型或方向字符串类型表格中列出的整数。 行进策略类型
方向字符串类型
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | 指定 Type 字段指的是方向字符串类型表格中的整数,还是行进策略类型表格中的整数。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
文本 | 行驶方向的文本描述。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | 当前行驶方向开始到下一行驶方向开始之时,或到上一行驶方向的路径结束之时所经历的时间,以分钟为单位。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | 当前行驶方向开始到下一行驶方向开始,或到上一行驶方向的路径结束之时所行驶的距离。该值的单位由 distance_units 参数指定。 如果行驶方向与下一次行驶方向开始的位置相同,则此值为零。例如,对于路径开始时的方向文本,DriveDistance 为 0。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | 方向要素的长度,单位采用针对路径指定的空间参考。如果未指定 env:outSR 参数,则默认采用十进制度。 |
solve_succeeded
此参数可用于确定服务是否能够成功找到路径。可请求获取作业的状态,以此获取失败的错误消息。