ServiceArea output data types

Upon successful execution, the tool returns the service areas around the facilities and the status indicating the analysis was successful.

The output data types containing the results from a service area analysis are described below.

Polygons

It provides access to polygon features that represent areas that can be reached from the input locations with a given travel time, travel distance, or travel cost.

This data type supports the fields described below. In addition to these fields, the data type also includes all the fields from the input feature class used as facilities for the analysis when generating overlapping or non-overlapping polygons.

Field	Description	Data type
ObjectID	The object ID of the feature.	ObjectID
Name	The name of the service area. It is based on the name of the associated facility and the cutoffs; for example, Store1: 0.0 – 5.0 represents a service area that covers all traversable streets within five minutes of a facility named Store1. The cutoff values are returned without the name of the facility, for example, 0.0 – 5.0, when the geometryAtOverlap property of the analysis object is set to ServiceAreaOverlapGeometry.Dissolve.	Text
FacilityID	This field corresponds to the ObjectID field in the output Facilities table and can be used for joins between these two tables. Multiple facilities can be associated with one service area when the geometryAtOverlap property of the analysis object is set to ServiceAreaOverlapGeometry.Dissolve; therefore, FacilityID field values are set to null when service areas are merged.	Long
FacilityOID	This field corresponds to the FacilityOID field in the output Facilities table. Multiple facilities can be associated with one service area when the geometryAtOverlap property of the analysis object is set to ServiceAreaOverlapGeometry.Dissolve; therefore, FacilityOID field values are set to null when service areas are merged.	Long
FromBreak	The lower bound of the service area's impedance cutoff range. The unit for this field is based on the unit of the impedance attribute set for the analysis. If the impedance attribute is time based, the value is in the units specified by the timeUnits property. If the impedance attribute is distance based, the value is in the units specified by the distanceUnits property. The value is in unknown units if the impedance attribute is neither time based nor distance based.	Double
ToBreak	The upper bound of the service area's impedance cutoff range. The value is in the same units as the FromBreak field values.	Double
Breaks	The values for this field are copied from the Breaks field on the input facilities.	Text
AdditionalTime	The values for this field are copied from the AdditionalTime field on the input facilities.	Double
AdditionalDistance	The values for this field are copied from the AdditionalDistance field on the input facilities.	Double
AdditionalCost	The values for this field are copied from the AdditionalCost field on the input facilities.	Double

Lines

This stores the resultant service areas as linear features and covers the streets, or network edges, that can be reached within the given time, distance, or other travel-cost cutoff. Lines are a truer representation of a service area than polygons since service area analyses are based on measurements along the network lines.

This data type supports the following fields:

Field	Description	Data type
ObjectID	The object ID of the feature.	ObjectID
FacilityID	This field corresponds to the ObjectID field in the output Facilities table and can be used for joins between these two tables. Legacy: This field was added at 3.1. The field is not included in the result if the network data source is a version of ArcGIS Enterprise earlier than 11.1.	Long
FacilityOID	This field corresponds to the FacilityOID field in the output Facilities table.	Long
SourceName	Each service area line traverses a feature from a network source feature class—a feature class used to create the network dataset on which the service area analysis is performed. This field contains the name of the edge source feature class from which the line was generated.	Text
SourceOID	The ObjectID value of the traversed street feature. Summarizing the values for this field can provide useful information such as the number of times a particular street feature is included from the facilities.	Long
FromPosition	Specifies where along the underlying source feature the service area line begins. A value of 0 (zero) indicates that the service area line begins at the from point of the underlying source feature. A value of 1 indicates that the service area line begins at the to point of the underlying source feature. A value between 0 and 1 indicates that the line begins at a point along the underlying source feature; for example, a value of 0.25 means the line begins 25 percent along the digitized direction of the underlying source feature.	Double
ToPosition	Specifies where along the underlying source feature the service area line ends. A value of 0 (zero) indicates that the service area line ends at the from point of the underlying source feature. A value of 1 indicates that the service area line ends at the to point of the underlying source feature. A value between 0 and 1 indicates that the line ends at a point along the underlying source feature; for example, a value of 0.25 means the line ends 25 percent along the digitized direction of the underlying source feature.	Double
FromCumul_Minutes	This field contains the cumulative cost, in minutes, of the path from the facility to the beginning of the line feature. The cost of the adjacent junction at the beginning of the line is included in this value. Note: An additional field, FromCumul_[TimeUnits], is included if the timeUnits property of the analysis object is not set to TimeUnits.Minutes. The field values are in the units specified by the timeUnits property. Note: Additional fields, FromCumul_[AccumulateAttributeName]_[TimeUnits], are included for each time-based cost attribute that is accumulated during the analysis.	Double
ToCumul_Minutes	This field contains the cumulative cost, in minutes, of the path from the facility to the end of the line feature. The cost of the adjacent junction at the end of the line is excluded from this value. Note: An additional field, ToCumul_[TimeUnits], is included if the timeUnits property of the analysis object is not set to TimeUnits.Minutes. The field values are in the units specified by the timeUnits property. Note: Additional fields, ToCumul_[AccumulateAttributeName]_[TimeUnits], are included for each time-based cost attribute that is accumulated during the analysis.	Double
FromCumul_Miles	This field contains the cumulative cost, in miles, of the path from the facility to the beginning of the line feature. The cost of the adjacent junction at the beginning of the line is included in this value. Note: An additional field, FromCumul_[DistanceUnits], is included if the distanceUnits property of the analysis object is not set to DistanceUnits.Miles or DistanceUnits.Kilometers. The field values are in the units specified by the distanceUnits property. Note: Additional fields, FromCumul_[AccumulateAttributeName]_[DistanceUnits], are included for each distance-based cost attribute that is accumulated during the analysis.	Double
ToCumul_Miles	This field contains the cumulative cost, in miles, of the path from the facility to the end of the line feature. The cost of the adjacent junction at the end of the line is excluded from this value. Note: An additional field, ToCumul_[DistanceUnits], is included if the distanceUnits property of the analysis object is not set to DistanceUnits.Miles or DistanceUnits.Kilometers. The field values are in the units specified by the distanceUnits property. Note: Additional fields, ToCumul_[AccumulateAttributeName]_[DistanceUnits], are included for each distance-based cost attribute that is accumulated during the analysis.	Double
FromCumul_Kilometers	This field contains the cumulative cost, in kilometers, of the path from the facility to the beginning of the line feature. The cost of the adjacent junction at the beginning of the line is included in this value.	Double
ToCumul_Kilometers	This field contains the cumulative cost, in kilometers, of the path from the facility to the end of the line feature. The cost of the adjacent junction at the end of the line is excluded from this value.	Double
FromCumul_Other	This field contains the cumulative cost, in unknown units, of the path from the facility to the beginning of the line feature. The cost of the adjacent junction at the beginning of the line is included in this value. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. Note: Additional fields, FromCumul_[AccumulateAttributeName]_Other, are included for each cost attribute that is neither time based nor distance based and accumulated during the analysis.	Double
ToCumul_Other	This field contains the cumulative cost, in unknown units, of the path from the facility to the end of the line feature. The cost of the adjacent junction at the end of the line is excluded from this value. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. Note: Additional fields, ToCumul_[AccumulateAttributeName]_Other, are included for each cost attribute that is neither time based nor distance based and accumulated during the analysis.	Double

Facilities

This provides access to the attributes of the facilities that are used in the service area analysis. You can use the attributes from this data type, such as the Status field, to determine why a facility was not used in the analysis.

The data type supports the following fields. In addition to these fields, the data type also includes all the fields from the input feature class used as facilities for the analysis.

Field	Description	Data type
ObjectID	The object ID of the feature.	ObjectID
Name	The name of the facility. The values for this field are copied from the Name field on the input facilities.	Text
FacilityOID	The ObjectID value of the input facility feature. This field is not always reliable for joins. This field is null for inputs added to the analysis using the insertCursor method. Values may not be unique if multiple feature classes were loaded using the load method.	Long
Breaks	The values for this field are copied from the Breaks field on the input facilities.	Text
AdditionalTime	The values for this field are copied from the AdditionalTime field on the input facilities.	Double
AdditionalDistance	The values for this field are copied from the AdditionalDistance field on the input facilities.	Double
AdditionalCost	The values for this field are copied from the AdditionalCost field on the input facilities. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based.	Double
SourceID	The numeric identifier of the network dataset source feature class on which the input point is located.	Long
SourceOID	The ObjectID of the feature in the source on which the input point is located.	Long
PosAlong	The position along the digitized direction of the source line feature. This value is stored as a ratio. This field is null if the network location references a junction.	Double
SideOfEdge	The side of the edge in relation to the digitized direction of the line feature. This field is limited to a domain of two values: Right Side (1) and Left Side (2).	Long
CurbApproach	The direction a vehicle may arrive at and depart from the facility. The values for this field are copied from the CurbApproach field on the input facilities.	Long
Status	Specifies the status of the point with respect to its location on the network and the outcome of the analysis. The possible values are the following: 0 (OK)—The point was located on the network. 1 (Not Located)—The point was not located on the network and was not included in the analysis. 2 (Network element not located)—The network element identified by the point's network location fields can't be found. This can occur when a network element where the point should be was deleted, and the network location was not recalculated. 3 (Element not traversable)—The network element that the point is located on is not traversable. This can occur when the element is restricted by a restriction attribute. 4 (Invalid Field Values)—Field values fall outside a range or coded-value domain. For example, a negative number exists where positive numbers are required. 5 (Not Reached)—The point can't be reached by the solver. The point may be on a separate, disconnected area of the network from the other inputs, or barriers or restrictions prevent travel to or from the point. 6 (Time window violation)—The point could not be reached within the designated time windows. This status only applies to network analysis types that support time windows. 7 (Not located on closest)—The closest network location to the point is not traversable because of a restriction or barrier, so the point has been located on the closest traversable network feature instead.	Long
SnapX	The x-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset.	Double
SnapY	The y-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset.	Double
SnapZ	The z-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset. The SnapZ field is 0 if the network is two dimensional.	Double
DistanceToNetworkInMeters	The distance in meters between the point's geographic location and the position where it was located on the network.	Double
Bearing	The values for this field are copied from the Bearing field on the input facilities.	Double
BearingTol	The values for this field are copied from the BearingTol field on the input facilities.	Double
NavLatency	The values for this field are copied from the NavLatency field on the input facilities.	Double