

# RouteVehicleSpan
<a name="API_RouteVehicleSpan"></a>

Span computed for the requested SpanAdditionalFeatures.

## Contents
<a name="API_RouteVehicleSpan_Contents"></a>

 ** BestCaseDuration **   <a name="location-Type-RouteVehicleSpan-BestCaseDuration"></a>
Duration of the computed span without traffic congestion.  
 **Unit**: `seconds`   
Type: Long  
Valid Range: Minimum value of 0. Maximum value of 4294967295.  
Required: No

 ** CarAccess **   <a name="location-Type-RouteVehicleSpan-CarAccess"></a>
Access attributes for a car corresponding to the span.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 3 items.  
Valid Values: `Allowed | NoThroughTraffic | TollRoad`   
Required: No

 ** Country **   <a name="location-Type-RouteVehicleSpan-Country"></a>
3 letter Country code corresponding to the Span.  
Type: String  
Length Constraints: Fixed length of 3.  
Pattern: `[A-Z]{3}`   
Required: No

 ** Distance **   <a name="location-Type-RouteVehicleSpan-Distance"></a>
Distance of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.  
Type: Long  
Valid Range: Minimum value of 0. Maximum value of 4294967295.  
Required: No

 ** Duration **   <a name="location-Type-RouteVehicleSpan-Duration"></a>
Duration of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.  
 **Unit**: `seconds`   
Type: Long  
Valid Range: Minimum value of 0. Maximum value of 4294967295.  
Required: No

 ** DynamicSpeed **   <a name="location-Type-RouteVehicleSpan-DynamicSpeed"></a>
Dynamic speed details corresponding to the span.  
 **Unit**: `kilometers per hour`   
Type: [RouteSpanDynamicSpeedDetails](API_RouteSpanDynamicSpeedDetails.md) object  
Required: No

 ** FunctionalClassification **   <a name="location-Type-RouteVehicleSpan-FunctionalClassification"></a>
A numerical value indicating the functional classification of the road segment corresponding to the span.  
Classification values are part of the hierarchical network that helps determine a logical and efficient route, and have the following definitions:  

1. Roads that allow for high volume, maximum speed traffic movement between and through major metropolitan areas.

1. Roads that are used to channel traffic to functional class 1 roads for travel between and through cities in the shortest amount of time.

1. Roads that intersect functional class 2 roads and provide a high volume of traffic movement at a lower level of mobility than functional class 2 roads.

1. Roads that provide for a high volume of traffic movement at moderate speeds between neighborhoods.

1. Roads with volume and traffic movement below the level of any other functional class.
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 5.  
Required: No

 ** Gate **   <a name="location-Type-RouteVehicleSpan-Gate"></a>
Attributes corresponding to a gate. The gate is present at the end of the returned span.  
Type: String  
Valid Values: `Emergency | KeyAccess | PermissionRequired`   
Required: No

 ** GeometryOffset **   <a name="location-Type-RouteVehicleSpan-GeometryOffset"></a>
Offset in the leg geometry corresponding to the start of this span.  
Type: Integer  
Valid Range: Minimum value of 0.  
Required: No

 ** Incidents **   <a name="location-Type-RouteVehicleSpan-Incidents"></a>
Incidents corresponding to the span. These index into the Incidents in the parent Leg.  
Type: Array of integers  
Required: No

 ** Names **   <a name="location-Type-RouteVehicleSpan-Names"></a>
Provides an array of names of the vehicle span in available languages.  
Type: Array of [LocalizedString](API_LocalizedString.md) objects  
Required: No

 ** Notices **   <a name="location-Type-RouteVehicleSpan-Notices"></a>
Notices are additional information returned that indicate issues that occurred during route calculation.  
Type: Array of integers  
Required: No

 ** RailwayCrossing **   <a name="location-Type-RouteVehicleSpan-RailwayCrossing"></a>
Attributes corresponding to a railway crossing. The gate is present at the end of the returned span.  
Type: String  
Valid Values: `Protected | Unprotected`   
Required: No

 ** Region **   <a name="location-Type-RouteVehicleSpan-Region"></a>
2-3 letter Region code corresponding to the Span. This is either a province or a state.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 3.  
Required: No

 ** RoadAttributes **   <a name="location-Type-RouteVehicleSpan-RoadAttributes"></a>
Attributes for the road segment corresponding to the span.   
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 12 items.  
Valid Values: `Bridge | BuiltUpArea | ControlledAccessHighway | DirtRoad | DividedRoad | Motorway | PrivateRoad | Ramp | RightHandTraffic | Roundabout | Tunnel | UnderConstruction`   
Required: No

 ** RouteNumbers **   <a name="location-Type-RouteVehicleSpan-RouteNumbers"></a>
Designated route name or number corresponding to the span.  
Type: Array of [RouteNumber](API_RouteNumber.md) objects  
Required: No

 ** ScooterAccess **   <a name="location-Type-RouteVehicleSpan-ScooterAccess"></a>
Access attributes for a scooter corresponding to the span.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 3 items.  
Valid Values: `Allowed | NoThroughTraffic | TollRoad`   
Required: No

 ** SpeedLimit **   <a name="location-Type-RouteVehicleSpan-SpeedLimit"></a>
Speed limit details corresponding to the span.  
 **Unit**: `kilometers per hour`   
Type: [RouteSpanSpeedLimitDetails](API_RouteSpanSpeedLimitDetails.md) object  
Required: No

 ** TollSystems **   <a name="location-Type-RouteVehicleSpan-TollSystems"></a>
Toll systems are authorities that collect payments for the toll.  
Type: Array of integers  
Required: No

 ** TruckAccess **   <a name="location-Type-RouteVehicleSpan-TruckAccess"></a>
Access attributes for a truck corresponding to the span.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 3 items.  
Valid Values: `Allowed | NoThroughTraffic | TollRoad`   
Required: No

 ** TruckRoadTypes **   <a name="location-Type-RouteVehicleSpan-TruckRoadTypes"></a>
Truck road type identifiers. `BK1` through `BK4` apply only to Sweden. `A2,A4,B2,B4,C,D,ET2,ET4` apply only to Mexico.  
There are currently no other supported values as of 26th April 2024.
Type: Array of integers  
Required: No

 ** TypicalDuration **   <a name="location-Type-RouteVehicleSpan-TypicalDuration"></a>
Duration of the computed span under typical traffic congestion.   
 **Unit**: `seconds`   
Type: Long  
Valid Range: Minimum value of 0. Maximum value of 4294967295.  
Required: No

 ** Zones **   <a name="location-Type-RouteVehicleSpan-Zones"></a>
Zones corresponding to this leg of the route.  
Type: Array of integers  
Required: No

## See Also
<a name="API_RouteVehicleSpan_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/geo-routes-2020-11-19/RouteVehicleSpan) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-routes-2020-11-19/RouteVehicleSpan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/geo-routes-2020-11-19/RouteVehicleSpan) 