LocationAllocation output data types

The output data types containing the results from a location-allocation analysis are described.

Lines

This provides access to the lines that connect demand points to the facilities to which they are allocated. Such lines are referenced in the documentation as allocation lines. These allocation lines include data about the demand allocated from each demand point to the associated facility.

The data type supports the following fields:

Field	Description	Data type
ObjectID	The object ID of the feature.	ObjectID
Name	The name of the allocation line that includes the names of the demand point and facility to which the demand point is allocated. The name of the allocation line is based on the names of the associated facility and demand point. The facility name is first if the value for the travelDirection property on the analysis object is set to TravelDirection.FromFacility. For example, Facility 5 - Demand 3 indicates the route travels from Facility 5 to Demand 3. If TravelDirection.ToFacility is specified as the value for the travelDirection property, the demand point name is first, for instance, Demand 3 — Facility 5.	Text
Weight	The weight assigned from the connected demand point to the connected facility.	Double
FacilityID	This field corresponds to the ObjectID field in the output Facilities table and can be used for joins between these two tables.	Long
FacilityOID	This field corresponds to the FacilityOID field in the output Facilities table.	Long
DemandID	This field corresponds to the ObjectID field in the output DemandPoints table and can be used for joins between these two tables.	Long
DemandOID	This field corresponds to the DemandOID field in the output DemandPoints table.	Long
Total_Minutes	The travel time in minutes between the facility and the demand point. Although the allocation lines have either straight or null geometries, the cost always refers to travel times as measured on a transportation network, not straight-line distances. Note: An additional field Total_[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 Total_[AccumulateAttributeName]_[TimeUnits] are included for each time-based cost attribute that is accumulated during the analysis.	Double
TotalWeighted_Minutes	The weighted cost of traveling between the facility and the demand point in minutes. This is the Total_Minutes value multiplied by the weight of the demand point allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is time based. Note: An additional field TotalWeighted_[TimeUnits] is included if the travel mode set for the analysis has an impedance attribute that is time based and 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.	Double
Total_Miles	The travel distance in miles between the facility and the demand point. Although the allocation lines have either straight or null geometries, the cost always refers to travel distances as measured on a transportation network, not straight-line distances.	Double
Total_Kilometers	The travel distance in kilometers between the facility and the demand point. Although the allocation lines have either straight or null geometries, the cost always refers to travel distances as measured on a transportation network, not straight-line distances. Note: An additional field Total_[DistanceUnits] is included if the distanceUnits property of the analysis object is not set to DistanceUnits.Kilometers or DistanceUnits.Miles. The field values are in the units specified by the distanceUnits property. Note: Additional fields Total_[AccumulateAttributeName]_[DistanceUnits] are included for each time-based cost attribute that is accumulated during the analysis.	Double
TotalWeighted_Miles	The weighted cost of traveling between the facility and the demand point in miles. This is the Total_Miles value multiplied by the weight of the demand point allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is distance based.	Double
TotalWeighted_Kilometers	The weighted cost of traveling between the facility and the demand point in kilometers. This is the Total_Kilometers value multiplied by the weight of the demand point allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is distance based. Note: An additional field TotalWeighted_[DistanceUnits] is included if the travel mode set for the analysis has an impedance attribute that is distance based and 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.	Double
Total_Other	The travel cost in unknown units between the facility and the demand point. Although the allocation lines have either straight or null geometries, the cost always refers to travel cost as measured on a transportation network, not straight-line distances. 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 Total_[AccumulateAttributeName]_Other are included for each cost attribute that is neither time based nor distance based and accumulated during the analysis.	Double
TotalWeighted_Other	The weighted cost of traveling between the facility and the demand point in unknown units. This is the Total_Cost value multiplied by the weight of the demand point allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is neither time based nor distance based.	Double

Facilities

This provides access to the chosen, required, and competitor facilities, as well as any candidate facilities that were not chosen.

This 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
FacilityType	The best facilities, or those that are chosen in the analysis, are indicated in this field. The facility types are as follows: 0 (Candidate)—The service didn't choose the candidate facility to be part of the solution. 1 (Required)—Prior to submitting the analysis, the facility was designated as required; it is part of the solution regardless of how much demand it captured. 2 (Competitor)—The facility represents the rivals and will remove demand from the problem. Competitor facilities are specific to the Maximize Market Share and Target Market Share problem types; they are ignored in other problem types. 3 (Chosen)—These are the chosen facilities; that is, they are candidate facilities that capture the most demand.	Long
Weight	The relative weighting of the facility, which is used to rate the attractiveness, desirability, or bias of one facility compared to another. The values for this field are copied from the Weight field on the input facilities.	Double
Capacity	The amount of weighted demand the facility is capable of supplying. The values for this field are copied from the Capacity field on the input facilities.	Double
DemandCount	A count of demand points allocated to the facility. A value other than zero means the facility was part of the solution, either as a required, competitor, or chosen facility.	Long
DemandWeight	The sum of the effective weight from all demand points that were allocated to the facility. The value is the sum of all the weight values from the demand points that were allocated to the facility. In the case of the Maximize Attendance and Market Share problem types, the value is an apportioned sum of the Weight field values, since these problem types allow demand to decay with distance or be split among many facilities.	Double
Total_Minutes	The sum of travel time in minutes between the facility and each of the demand points that were allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is time based. Note: An additional field Total_[TimeUnits] is included if the travel mode set for the analysis has an impedance attribute that is time based and 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.	Double
TotalWeighted_Minutes	This field stores the cumulative weighted cost in minutes for a facility. The weighted cost for a demand point is its weight multiplied by the least-cost path between the facility and the demand point. The weighted cost for a facility is the sum of all the weighted costs of demand points that are allocated to the facility. For example, if a demand point with a weight of 2 is allocated to a facility 10 minutes away, the TotalWeighted_Minutes value is 20 (2 x 10). If another demand point with a weight of 3 is allocated to the same facility and is 5 minutes away, the TotalWeighted_Minutes value increases to 35 (3 x 5 + 20). This field is included only if the travel mode set for the analysis has an impedance attribute that is time based. Note: An additional field TotalWeighted_[TimeUnits] is included if the travel mode set for the analysis has an impedance attribute that is time based and 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.	Double
Total_Miles	The sum of travel distance in miles between the facility and each of the demand points that were allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is distance based. Note: An additional field Total_[DistanceUnits] is included if the travel mode set for the analysis has an impedance attribute that is distance based and 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.	Double
TotalWeighted_Miles	This field stores the cumulative weighted cost in miles for a facility. The weighted cost for a demand point is its weight multiplied by the least-cost path between the facility and the demand point. The weighted cost for a facility is the sum of all the weighted costs of demand points that are allocated to the facility. For example, if a demand point with a weight of 2 is allocated to a facility 10 miles away, the TotalWeighted_Miles value is 20 (2 x 10). If another demand point with a weight of 3 is allocated to the same facility and is 5 miles away, the TotalWeighted_Miles value increases to 35 (3 x 5 + 20) This field is included only if the travel mode set for the analysis has an impedance attribute that is distance based. Note: An additional field TotalWeighted_[DistanceUnits] is included if the travel mode set for the analysis has an impedance attribute that is distance based and 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.	Double
Total_Kilometers	This field is analogous to the Total_Miles field, except values are in kilometers instead of miles.	Double
TotalWeighted_Kilometers	This field is analogous to the TotalWeighted_Miles field, except values are in kilometers instead of miles.	Double
Total_Other	A sum of travel cost in unknown units between the facility and each of the demand points that were allocated to the facility. This field is included only if the travel mode set for the analysis has an impedance attribute that is neither time based nor distance based.	Double
TotalWeighted_Other	This field stores the cumulative weighted cost in unknown units for a facility. The weighted cost for a demand point is its weight multiplied by the least-cost path between the facility and the demand point. The weighted cost for a facility is the sum of all the weighted costs of demand points that are allocated to the facility. This field is included only if the travel mode set 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 depart from or arrive at 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

DemandPoints

This provides access to the demand points that participated in the analysis: those that were and were not allocated to facilities.

This 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 demand point. The values for this field are copied from the Name field on the input demand points.	Text
FacilityID	This field corresponds to the ObjectID field in the output Facilities table and can be used for joins between these two tables.	Long
FacilityOID	The FacilityOID field value in the output Facilities table for the facility to which this demand point is allocated. The field value is Null if the demand point is not allocated to any facility or the FacilityOID field in the output Facilities table is null.	Long
DemandOID	The ObjectID value of the input demand point 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
Weight	The relative weighting of the demand point. The values for this field are copied from the Weight field on the input demand points.	Double
AllocatedWeight	Specifies the amount of demand allocated to chosen and required facilities. The value excludes demand allocated to competing facilities. The value options are as follows: Null—The demand point wasn't assigned to any facility. This can result, for example, if the demand point could not be reached from any facility. 0—The demand point was only assigned to competing facilities. Positive, nonzero value—Indicates how much demand is assigned to the chosen and required facilities.	Double
GroupName	The name of the group of which the demand point is a part. The values for this field are copied from the GroupName field on the input demand points.	Text
ImpedanceTransformation	The values for this field are copied from the ImpedanceTransformation field on the input demand points.	Long
ImpedanceParameter	The values for this field are copied from the ImpedanceParameter field on the input demand points.	Double
Cutoff	The demand point can't be allocated to a facility that is beyond the value indicated here. The values for this field are copied from the Cutoff field on the input demand points.	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 depart from or arrive at the demand point. The values for this field are copied from the CurbApproach field on the input facilities.	Long
Status	Specifies how the demand point was evaluated in the analysis. The possible values are the following: 0 (OK)—The demand point was located on the transportation network and analyzed. 1 (Not Located)—The demand point was not included in the analysis since a traversable road was not found within the maximum search distance from the demand point. 3 (Elements not traversable)—The network element that the demand point is on is not traversable. This can occur when the network 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 may exist where positive numbers are required. 5 (Not Reached)—The demand point couldn't be reached due to constraints; for example, a curb approach is set so that a vehicle must travel in the wrong direction on a one-way street to reach the demand point. 7 (Not located on closest)—The closest network location to the demand point is not traversable because of a restriction or barrier, so the demand 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 demand points.	Double
BearingTol	The values for this field are copied from the BearingTol field on the input demand points.	Double
NavLatency	The values for this field are copied from the NavLatency field on the input demand points.	Double