The Find Closest Facilities geoprocessing tool produces a Routes, a Directions, and a ClosestFacilities feature class as output. The output feature classes and their corresponding field attributes are described in this topic.
Routes feature class
The Routes line feature class represents the optimal network path between Incidents and their closest facility or facilities. The default name of this output feature class is Routes, but you can give it a different name by changing the Route Name parameter prior to solving.
The Routes feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.
The field names of the Routes feature class are listed and described below.
Field name | Description |
---|---|
ObjectID | The system-managed ID field. |
Shape | The geometry field indicating the shape of the lines. |
FacilityID | If your input facilities feature class has a field named ID, the values of this field are mapped to the FacilityID field; otherwise, the field values are automatically populated. This field can be used to join attributes from Routes to the input facilities table or from the input facilities to Routes. |
FacilityRank | The rank of the facility with respect to the incident; for example, the closest facility to the incident has a rank of 1, whereas the next closest facility to the same incident has a rank of 2. |
Name | The name of the route is based on the name of the associated incident and facility; for instance, Location 1 - Location 2 would represent a route between a Facility named Location 2 and an Incident named Location 1. |
IncidentCurbApproach | The curb approach of the incident. |
FacilityCurbApproach | The curb approach of the facility. |
IncidentID | If your input incidents feature class has a field named ID, the values of this field are mapped to the IncidentID field; otherwise, the field values are automatically populated. This field can be used to join attributes from Routes to the input incidents table or from the input incidents to Routes. |
Total_Minutes | The total duration of the route in minutes. |
Total_Miles | The total distance of the route in miles. |
Total_Kilometers | The total distance of the route in kilometers. |
Total_[Measurement Units] | The total distance or duration of the route. The units are the same as the units chosen in the Measurement Units parameter. |
Total_[Accumulated attribute name]_[units] | The total distance or duration of the route as measured by a cost attribute chosen in the Accumulate Attributes parameter. |
Total_[distance attribute units] | The length of the route in the units specified in the Distance Attribute Units parameter. If the Distance Attribute Units and Measurement Units parameter values are the same, this field is excluded from the output. |
Total_[time attribute units] | The duration of the route in the units specified in the Time Attribute Units parameter. If the Time Attribute Units and Measurement Units parameter values are the same, this field is excluded from the output. |
FacilityOID | The Object ID of the input facility. This field can be used to join attributes from Routes to the input facilities table or from the input facilities to Routes. |
IncidentOID | The Object ID of the input incident. This field can be used to join attributes from Routes to the input incidents table or from the input incidents to Routes. |
Shape_Length | The geometric length of the feature. |
Directions feature class
The Directions line feature class represents segments in the optimal network path between incidents and their closest facility or facilities along with the text directions for traveling along that segment. The default name of this output feature class is Directions, but you can give it a different name by changing the Directions Name parameter prior to solving.
The Directions feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.
The field names of the Directions feature class are listed and described below.
Field name | Description |
---|---|
ObjectID | The system-managed ID field. |
Shape | The geometry field indicating the shape of the lines. |
RouteName | The name of the route is based on the name of the associated incident and facility; for instance, Location 1 - Location 2 would represent a route between a facility named Location 2 and an Incident named Location 1. |
ArriveTime or DepartTime | The time of day this directions segment begins or ends. If the route spans multiple days, the date and time of day are displayed. |
Type | This field is for advanced users who want to customize the driving-directions text. Most users can meet their requirements by ignoring this field and referring to the Text field instead. Type refers to a constant in one of two enumerations: esriDirectionsManueverType or esriDirectionsStringType. (See the SubItemType field description to learn which enumeration the Type value refers to.) You can see a list of constant values by searching the SDK of your choice for the enumeration name. |
SubItemType | This field is for advanced users who want to customize the driving-directions text. Most users can meet their needs by ignoring this field and referring to the Text field instead. SubItemType works in combination with Type to create the driving direction shown in the Text field. The SubItemType field specifies whether the Type field refers to a constant value in the esriDirectionsManueverType enumeration or the esriDirectionsStringType enumeration.
|
Text | A text description of the driving direction. The text uses the style, units, and language you specified in the tool parameters. |
ElapsedTime | The time it takes to complete the maneuver. The units chosen in the Time Attribute Units parameter determine the units of the ElapsedTime field. |
DriveDistance | The travel distance along this segment of the route. This value is zero for driving directions that occur at the same location where the next one begins. |
Shape_Length | The geometric length of the feature. |
ClosestFacilities feature class
The ClosestFacilities point feature class represents the facilities that were chosen as closest facilities in the analysis. The default name of this output feature class is ClosestFacilities, but you can give it a different name by changing the Closest Facilities Name parameter prior to solving.
The ClosestFacilities feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.
The field names of the ClosestFacilities feature class are listed and described below.
Field name | Description |
---|---|
ObjectID | The system-managed ID field. |
Shape | The geometry of the point, which is stored internally. |
Name | The name of the facility. If the input facilities feature class had a Name field, the Name value is derived from that field; otherwise, the Name value is null. |
ID | The ID of the facility. If the input facilities feature class had an ID field, the ID value is derived from that field; otherwise, the ID value is null. |
Additional Time | The amount of time added to the total route time when this facility is visited. The units for this attribute value are the same as those specified in the Measurement Units parameter. |
Additional Distance | The amount of distance added to the total route distance when this facility is visited. The units for this attribute value are the same as those specified in the Measurement Units parameter. |
Curb Approach | The curb approach in accessing the facility. |
ORIG_FID | The Object ID of the input facility. This field can be used to join attributes from ClosestFacilities to the input facilities table or from the input facilities to ClosestFacilities. It can also be used to join attributes to and from the output Routes feature class. |