Output from Find Closest Facilities

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.

  • If the SubItemType value is 1, the Type value refers to esriDirectionsManeuverType.
  • If the SubItemType value is 2, the Type value refers to esriDirectionsStringType.

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.

Related Topics

1/20/2015