{ "name": "SolveLocationAllocation", "displayName": "SolveLocationAllocation", "description": "The SolveLocationAllocation tool chooses the best location or locations from a set of input locations. Input to this tool includes facilities, which provide goods or services, and demand points, which consume the goods and services. The objective is to find the facilities that supply the demand points most efficiently. The tool solves this problem by analyzing various ways the demand points can be assigned to the different facilities. The solution is the scenario that allocates the most demand to facilities and minimizes overall travel. The output includes the solution facilities, demand points associated with their assigned facilities, and lines connecting demand points to their facilities. The location-allocation tool can be configured to solve specific problem types. Examples include the following: A retail store wants to see which potential store locations would need to be developed to capture 10 percent of the retail market in the area. A fire department wants to determine where it should locate fire stations to reach 90 percent of the community within a four-minute response time. A police department wants to preposition personnel given past criminal activity at night. After a storm, a disaster response agency wants to find the best locations to set up triage facilities, with limited patient capacities, to tend to the affected population.", "category": "", "helpUrl": "https://arcgis-azure.gdi.net/server/rest/directories/arcgisforinspire/Routing/NetworkAnalysis_GPServer/Routing_NetworkAnalysis/SolveLocationAllocation.htm", "executionType": "esriExecutionTypeAsynchronous", "parameters": [ { "name": "Facilities", "dataType": "GPFeatureRecordSetLayer", "displayName": "Facilities", "description": "Specify one or more facilities (up to 1,000). The tool chooses the best locations from the set of facilities you specify here. In a competitive analysis, in which you try to find the best locations in the face of competition, the facilities of the competitors are specified here as well.\n When defining the facilities, you can set properties for each one, such as the facility name or type, by using attributes. Facilities can be specified with the following fields: Name\u2014The name of the facility. The name is included in the name of output allocation lines if the facility is part of the solution. FacilityType\u2014Specifies whether the facility is a candidate, required, or competitor facility. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses):0 (Candidate)\u2014A facility that may be part of the solution.1 (Required)\u2014A facility that must be part of the solution.2 (Competitor)\u2014A rival facility that potentially removes demand from your facilities. Competitor facilities are specific to the Maximize Market Share and Target Market Share problem types; they are ignored in other problem types. Weight\u2014The relative weighting of the facility, which is used to rate the attractiveness, desirability, or bias of one facility compared to another. For example, a value of 2.0 could capture the preference of customers who prefer, at a ratio of 2 to 1, shopping in one facility over another facility. Factors that potentially affect facility weight include square footage, neighborhood, and age of the building. Weight values other than one are only honored by the maximize market share and target market share problem types; they are ignored in other problem types. Capacity\u2014The Capacity field is specific to the Maximize Capacitated Coverage problem type; the other problem types ignore this field. Capacity specifies how much weighted demand the facility is capable of supplying. Excess demand won't be allocated to a facility even if that demand is within the facility's default measurement cutoff. Any value assigned to the Capacity field overrides the Default Capacity parameter (Default_Capacity in Python) for the given facility. CurbApproach\u2014Specifies the direction a vehicle may arrive at or depart\nfrom the facility. The field value is specified as one of the\nfollowing integers (use the numeric code, not the name in parentheses): 0 (Either side of vehicle)\u2014The facility can be visited from either the right or left side of the vehicle. 1 (Right side of vehicle)\u2014Arrive at or depart the facility so that it is on the right side of the vehicle. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side so that passengers can disembark at the curb. 2 (Left side of vehicle)\u2014Arrive at or depart the facility so that it is on the left side of the vehicle. When the vehicle approaches and departs\nthe facility, the curb must be on the left side of the vehicle. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side so that passengers can disembark at the curb. The CurbApproach property is designed to work with both kinds of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider a facility on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach a facility from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at a facility and not have a lane of traffic between the vehicle and the incident, you would choose Right side of vehicle (1) in the United States but Left side of vehicle (2) in the United Kingdom.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "geometryType": "esriGeometryPoint", "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "Name", "type": "esriFieldTypeString", "alias": "Name", "length": 500 }, { "name": "FacilityType", "type": "esriFieldTypeSmallInteger", "alias": "FacilityType" }, { "name": "Weight", "type": "esriFieldTypeDouble", "alias": "Weight" }, { "name": "Capacity", "type": "esriFieldTypeDouble", "alias": "Capacity" }, { "name": "CurbApproach", "type": "esriFieldTypeSmallInteger", "alias": "Curb Approach" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeRequired", "category": "" }, { "name": "Demand_Points", "dataType": "GPFeatureRecordSetLayer", "displayName": "Demand Points", "description": "Specify one or more demand points (up to 10,000). The tool chooses the best facilities based in large part on how they serve the demand points specified here. When defining the demand points, you can set properties for each one, such as the demand-point name or weight, by using attributes. Demand points can be specified with the following fields: Name\u2014The name of the demand point. The name is included in the name of an output allocation line or lines if the demand point is part of the solution. GroupName\u2014The name of the group the demand point is part of. This property is ignored for the maximize capacitated coverage, target market share, and maximize market share problem types. If demand points share a group name, the solver allocates all members of the group to the same facility. (If constraints, such as a cutoff distance, prevent any of the demand points in the group from reaching the same facility, none of the demand points are allocated.) Weight\u2014The relative weighting of the demand point. A value of 2.0 means the demand point is twice as important as one with a weight of 1.0. If demand points represent households, weight could indicate the number of people in each household. Cutoff_Time\u2014The demand point can't be allocated to a facility that is beyond the travel time indicated here. This field value overrides the value of the Default Measurement Cutoff parameter. The units for this attribute value are specified by the Measurement Units parameter. The attribute value is referenced during the analysis only when the measurement units are time based. The default value is null, which means there isn't an override cutoff. Cutoff_Distance\u2014The demand point can't be allocated to a facility that is beyond the travel distance indicated here. This field value overrides the value of the Default Measurement Cutoff parameter. The units for this attribute value are specified by the Measurement Units parameter. The attribute value is referenced during the analysis only when the measurement units are distance based. The default value is null, which means there isn't an override cutoff. CurbApproach\u2014Specifies the direction a vehicle may arrive at or depart\nfrom the demand point. The field value is specified as one of the\nfollowing integers (use the numeric code, not the name in parentheses): 0 (Either side of vehicle)\u2014The demand point can be visited from either the right or left side of the vehicle. 1 (Right side of vehicle)\u2014Arrive at or depart the demand point so that it is on the right side of the vehicle. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side so that passengers can disembark at the curb. 2 (Left side of vehicle)\u2014Arrive at or depart the demand point so that it is on the left side of the vehicle. When the vehicle approaches and departs\nthe demand point, the curb must be on the left side of the vehicle. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side so that passengers can disembark at the curb. The CurbApproach property is designed to work with both kinds of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider a demand point on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach a demand point from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at a demand point and not have a lane of traffic between the vehicle and the demand point, you would choose Right side of vehicle (1) in the United States but Left side of vehicle (2) in the United Kingdom.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "geometryType": "esriGeometryPoint", "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "Name", "type": "esriFieldTypeString", "alias": "Name", "length": 500 }, { "name": "GroupName", "type": "esriFieldTypeString", "alias": "Group Name", "length": 500 }, { "name": "Weight", "type": "esriFieldTypeDouble", "alias": "Weight" }, { "name": "TimeCutoff", "type": "esriFieldTypeDouble", "alias": "Time Cutoff" }, { "name": "DistanceCutoff", "type": "esriFieldTypeDouble", "alias": "Distance Cutoff" }, { "name": "CurbApproach", "type": "esriFieldTypeSmallInteger", "alias": "Curb Approach" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeRequired", "category": "" }, { "name": "Measurement_Units", "dataType": "GPString", "displayName": "Measurement Units", "description": "Specify the units that should be used to measure the travel times or travel distances between demand points and facilities. The tool chooses the best facilities based on which ones can reach, or be reached by, the most amount of weighted demand with the least amount travel. The output allocation lines report travel distance or travel time in different units, including the units you specify for this parameter. The choices are Meters Kilometers Feet Yards Miles NauticalMiles Seconds Minutes Hours Days", "direction": "esriGPParameterDirectionInput", "defaultValue": "Minutes", "parameterType": "esriGPParameterTypeRequired", "category": "", "choiceList": [ "Meters", "Kilometers", "Feet", "Yards", "Miles", "NauticalMiles", "Seconds", "Minutes", "Hours", "Days" ] }, { "name": "Analysis_Region", "dataType": "GPString", "displayName": "Analysis Region", "description": "Specify the region in which to perform the analysis. If a value is not specified for this parameter, the tool\nwill automatically calculate the region name based on the location\nof the input points. Setting the name of the region is recommended to speed up the\ntool execution. To specify a region, use one of\nthe following values: EuropeGreece India JapanKorea MiddleEastAndAfrica NorthAmerica Oceania SouthAmerica SouthEastAsiaTaiwanThailand", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Analysis", "choiceList": [ "NA_ND" ] }, { "name": "Problem_Type", "dataType": "GPString", "displayName": "Problem Type", "description": "Specifies the objective of the location-allocation analysis. The default objective is to minimize impedance. Minimize Impedance: This is also known as the P-Median problem type. Facilities are located such that the sum of all weighted travel time or distance between demand points and solution facilities is minimized. (Weighted travel is the amount of demand allocated to a facility multiplied by the travel distance or time to the facility.) This problem type is traditionally used to locate warehouses, because it can reduce the overall transportation costs of delivering goods to outlets. Since Minimize Impedance reduces the overall distance the public needs to travel to reach the chosen facilities, the minimize impedance problem without an impedance cutoff is ordinarily regarded as more equitable than other problem types for locating some public-sector facilities such as libraries, regional airports, museums, department of motor vehicles offices, and health clinics. The following list describes how the minimize impedance problem type handles demand:A demand point that cannot reach any facilities, due to setting a cutoff distance or time, is not allocated.A demand point that can only reach one facility has all its demand weight allocated to that facility.A demand point that can reach two or more facilities has all its demand weight allocated to the nearest facility only. Maximize Coverage: Facilities are located such that as much demand as possible is allocated to solution facilities within the impedance cutoff. Maximize Coverage is frequently used to locate fire stations, police stations, and ERS centers, because emergency services are often required to arrive at all demand points within a specified response time. Note that it is important for all organizations, and critical for emergency services, to have accurate and precise data so that analysis results correctly model real-world results. Pizza delivery businesses, as opposed to eat-in pizzerias, try to locate stores where they can cover the most people within a certain drive time. People who order pizzas for delivery don't typically worry about how far away the pizzeria is; they are mainly concerned with the pizza arriving within an advertised time window. Therefore, a pizza-delivery business would subtract pizza-preparation time from their advertised delivery time and solve a maximize coverage problem to choose the candidate facility that would capture the most potential customers in the coverage area. (Potential customers of eat-in pizzerias are more affected by distance, since they need to travel to the restaurant; thus, the attendance maximizing or market share problem types would better suit eat-in restaurants.) The following list describes how the Maximize Coverage problem handles demand:A demand point that cannot reach any facilities due to cutoff distance or time is not allocated.A demand point that can only reach one facility has all its demand weight allocated to that facility.A demand point that can reach two or more facilities has all its demand weight allocated to the nearest facility only. Maximize Capacitated Coverage: Facilities are located such that all or the greatest amount of demand can be served without exceeding the capacity of any facility. Maximize Capacitated Coverage behaves like either the Minimize Impedance or Maximize Coverage problem type but with the added constraint of capacity. You can specify a capacity for an individual facility by assigning a numeric value to its corresponding Capacity field on the input facilities. If the Capacity field value is null, the facility is assigned a capacity from the Default Capacity property. Use-cases for Maximize Capacitated Coverage include creating territories that encompass a given number of people or businesses, locating hospitals or other medical facilities with a limited number of beds or patients who can be treated, or locating warehouses whose inventory isn't assumed to be unlimited. The following list describes how the Maximize Capacitated Coverage problem handles demand:Unlike Maximize Coverage, Maximize Capacitated Coverage doesn't require a value for the Default Measurement Cutoff; however, when an cutoff is specified, any demand point outside the cutoff time or distance of all facilities is not allocated.An allocated demand point has all or none of its demand weight assigned to a facility; that is, demand isn't apportioned with this problem type.If the total demand that can reach a facility is greater than the capacity of the facility, only the demand points that maximize total captured demand and minimize total weighted travel are allocated. You may notice an apparent inefficiency when a demand point is allocated to a facility that isn't the nearest solution facility. This may occur when demand points have varying weights and when the demand point in question can reach more than one facility. This kind of result indicates the nearest solution facility didn't have adequate capacity for the weighted demand, or the most efficient solution for the entire problem required one or more local inefficiencies. In either case, the solution is correct. Minimize Facilities: Facilities are chosen such that as much weighted demand as possible are allocated to solution facilities within the travel time or distance cutoff; additionally, the number of facilities required to cover demand is minimized. Minimize Facilities is the same as Maximize Coverage but with the exception of the number of facilities to locate, which in this case is determined by the solver. When the cost of building facilities is not a limiting factor, the same kinds of organizations that use Maximize Coverage (emergency response, for instance) use Minimize Facilities so that all possible demand points will be covered. The following list describes how the Minimize Facilities problem handles demand:A demand point that cannot reach any facilities due to a cutoff distance or time is not allocated.A demand point that can only reach one facility has all its demand weight allocated to that facility.A demand point that can reach two or more facilities has all its demand weight allocated to the nearest facility only. Maximize Attendance: Facilities are chosen such that as much demand weight as possible is allocated to facilities while assuming the demand weight decreases in relation to the distance between the facility and the demand point. Specialty stores that have little or no competition benefit from this problem type, but it may also be beneficial to general retailers and restaurants that don't have the data on competitors necessary to perform market share problem types. Some businesses that might benefit from this problem type include coffee shops, fitness centers, dental and medical offices, and electronics stores. Public transit bus stops are often chosen with the help of Maximize Attendance. Maximize Attendance assumes that the farther people have to travel to reach your facility, the less likely they are to use it. This is reflected in how the amount of demand allocated to facilities diminishes with distance. The following list describes how the Maximize Attendance problem handles demand:A demand point that cannot reach any facilities due to a cutoff distance or time is not allocated.When a demand point can reach a facility, its demand weight is only partially allocated to the facility. The amount allocated decreases as a function of the maximum cutoff distance (or time) and the travel distance (or time) between the facility and the demand point.The weight of a demand point that can reach more than one facility is proportionately allocated to the nearest facility only. Maximize Market Share: A specific number of facilities are chosen such that the allocated demand is maximized in the presence of competitors. The goal is to capture as much of the total market share as possible with a given number of facilities, which you specify. The total market share is the sum of all demand weight for valid demand points. The market share problem types require the most data because, along with knowing your own facilities' weight, you also need to know that of your competitors' facilities. The same types of facilities that use the Maximize Attendance problem type can also use market share problem types given that they have comprehensive information that includes competitor data. Large discount stores typically use Maximize Market Share to locate a finite set of new stores. The market share problem types use a Huff model, which is also known as a gravity model or spatial interaction. The following list describes how the Maximize Market Share problem handles demand:A demand point that cannot reach any facilities due to a cutoff distance or time is not allocated.A demand point that can only reach one facility has all its demand weight allocated to that facility.A demand point that can reach two or more facilities has all its demand weight allocated to them; furthermore, the weight is split among the facilities proportionally to the facilities' attractiveness (facility weight) and inversely proportional to the distance between the facility and demand point. Given equal facility weights, this means more demand weight is assigned to near facilities than far facilities. The total market share, which can be used to calculate the captured market share, is the sum of the weight of all valid demand points. Target Market Share: Target Market Share chooses the minimum number of facilities necessary to capture a specific percentage of the total market share in the presence of competitors. The total market share is the sum of all demand weight for valid demand points. You set the percent of the market share you want to reach and let the solver choose the fewest number of facilities necessary to meet that threshold. The market share problem types require the most data because, along with knowing your own facilities' weight, you also need to know that of your competitors' facilities. The same types of facilities that use the Maximize Attendance problem type can also use market share problem types given that they have comprehensive information that includes competitor data. Large discount stores typically use the Target Market Share problem type when they want to know how much expansion would be required to reach a certain level of the market share or see what strategy would be needed just to maintain their current market share given the introduction of new competing facilities. The results often represent what stores would like to do if budgets weren't a concern. In other cases where budget is a concern, stores revert to the Maximize Market Share problem and simply capture as much of the market share as possible with a limited number of facilities. The following list describes how the target market share problem handles demand:The total market share, which is used in calculating the captured market share, is the sum of the weight of all valid demand points.A demand point that cannot reach any facilities due to a cutoff distance or time is not allocated.A demand point that can only reach one facility has all its demand weight allocated to that facility.A demand point that can reach two or more facilities has all its demand weight allocated to them; furthermore, the weight is split among the facilities proportionally to the facilities' attractiveness (facility weight) and inversely proportional to the distance between the facility and demand point. Given equal facility weights, this means more demand weight is assigned to near facilities than far facilities.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Minimize Impedance", "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings", "choiceList": [ "Maximize Attendance", "Maximize Capacitated Coverage", "Maximize Coverage", "Maximize Market Share", "Minimize Facilities", "Minimize Impedance", "Target Market Share" ] }, { "name": "Number_of_Facilities_to_Find", "dataType": "GPLong", "displayName": "Number of Facilities to Find", "description": "Specify the number of facilities the solver should choose. The default value is 1.\n The facilities with a FacilityType field value of 1 (Required) are always chosen first. Any excess facilities to choose are picked from candidate facilities, which have a FacilityType field value of 2. Any facilities that have a FacilityType value of 3 (Chosen) before solving are treated as candidate facilities at solve time. If the number of facilities to find is less than the number of required facilities, an error occurs. Number of Facilities to Find is disabled for the Minimize Facilities and Target Market Share problem types since the solver determines the minimum number of facilities needed to meet the objectives.", "direction": "esriGPParameterDirectionInput", "defaultValue": 1, "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings" }, { "name": "Default_Measurement_Cutoff", "dataType": "GPDouble", "displayName": "Default Measurement Cutoff", "description": "Specifies the maximum travel time or distance allowed between a demand point and the facility it is allocated to. If a demand point is outside the cutoff of a facility, it cannot be allocated to that facility. The default value is none, which means the cutoff limit doesn't apply.\n The units for this parameter are the same as those specified by the Measurement Units parameter. The travel time or distance cutoff is measured by the shortest path along roads. This property might be used to model the maximum distance that people are willing to travel to visit stores or the maximum time that is permitted for a fire department to reach anyone in the community. Note that demand points have Cutoff_Time and Cutoff_Distance fields, which, if set accordingly, overrides the Default Measurement Cutoff parameter. You might find that people in rural areas are willing to travel up to 10 miles to reach a facility while urbanites are only willing to travel up to two miles. Assuming Measurement Units is set to Miles, you can model this behavior by setting the default measurement cutoff to 10 and the Cutoff_Distance field value of the demand points in urban areas to 2.", "direction": "esriGPParameterDirectionInput", "defaultValue": null, "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings" }, { "name": "Default_Capacity", "dataType": "GPDouble", "displayName": "Default Capacity", "description": "This property is specific to the Maximize Capacitated Coverage problem type. It is the default capacity assigned to all facilities in the analysis. You can override the default capacity for a facility by specifying a value in the facility's Capacity field. \nThe default value is 1.", "direction": "esriGPParameterDirectionInput", "defaultValue": 1, "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings" }, { "name": "Target_Market_Share", "dataType": "GPDouble", "displayName": "Target Market Share", "description": "This parameter is specific to the Target Market Share problem type. It is the percentage of the total demand weight that you want the chosen and required facilities to capture. The solver chooses the minimum number of facilities needed to capture the target market share specified here. \nThe default value is 10 percent.", "direction": "esriGPParameterDirectionInput", "defaultValue": 10, "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings" }, { "name": "Measurement_Transformation_Model", "dataType": "GPString", "displayName": "Measurement Transformation Model", "description": "This sets the equation for transforming the network cost between facilities and demand points. This property, coupled with the Impedance Parameter, specifies how severely the network impedance between facilities and demand points influences the solver's choice of facilities. In the following list of transformation options, d refers to demand points and f, facilities. \"Impedance\" refers to the shortest travel distance or time between two locations. So impedancedf is the shortest-path (time or distance) between demand point d and facility f, and costdf is the transformed travel time or distance between the facility and demand point. Lambda (λ) denotes the impedance parameter. The Measurement Units setting determines whether travel time or distance is analyzed. Linear: costdf = λ * impedancedf The transformed travel time or distance between the facility and the demand point is the same as the time or distance of the shortest path between the two locations. With this option, the impedance parameter (λ) is always set to one. This is the default. Power: costdf = impedancedfλ The transformed travel time or distance between the facility and the demand point is equal to the time or distance of the shortest path raised to the power specified by the impedance parameter (λ). Use the Power option with a positive impedance parameter to specify higher weight to nearby facilities. Exponential: costdf = e(λ * impedancedf) The transformed travel time or distance between the facility and the demand point is equal to the mathematical constant e raised to the power specified by the shortest-path network impedance multiplied with the impedance parameter (λ). Use the Exponential option with a positive impedance parameter to specify a high weight to nearby facilities.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Linear", "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings", "choiceList": [ "Linear", "Power", "Exponential" ] }, { "name": "Measurement_Transformation_Factor", "dataType": "GPDouble", "displayName": "Measurement Transformation Factor", "description": "Provides a parameter value to the equations specified in the Measurement Transformation Model parameter. The parameter value is ignored when the impedance transformation is of type linear. For power and exponential impedance transformations, the value should be nonzero. The default value is 1.", "direction": "esriGPParameterDirectionInput", "defaultValue": 1, "parameterType": "esriGPParameterTypeOptional", "category": "Location-Allocation Problem Settings" }, { "name": "Travel_Direction", "dataType": "GPString", "displayName": "Travel Direction", "description": "Specify whether to measure travel times or distances from facilities to demand points or from demand points to facilities. The default value is to measure from facilities to demand points. Facility to Demand: Direction of travel is from\nfacilities to demand points. This is the default. Demand to Facility: Direction of travel is from\ndemand points to facilities. Travel times and distances may change based on direction of travel. If going from point A to point B, you may encounter less traffic or have a shorter path, due to one-way streets and turn restrictions, than if you were traveling in the opposite direction. For instance, going from point A to point B may only take 10 minutes, but going the other direction may take 15 minutes. These differing measurements may affect whether demand points can be assigned to certain facilities because of cutoffs or, in problem types where demand is apportioned, affect how much demand is captured. Fire departments commonly measure from facilities to demand points since they are concerned with the time it takes to travel from the fire station to the location of the emergency. A retail store is more concerned with the time it takes shoppers to reach the store; therefore, stores commonly measure from demand points to facilities. Travel Direction also determines the meaning of any start time that is provided. See the Time of Day parameter for more information.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Facility to Demand", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Analysis", "choiceList": [ "Demand to Facility", "Facility to Demand" ] }, { "name": "Time_of_Day", "dataType": "GPDate", "displayName": "Time of Day", "description": "Specify the time at which travel begins. This property is ignored unless Measurement Units are time based. The default is no time or date. When Time of Day isn't specified, the solver uses generic speeds\u2014typically those from posted speed limits. Traffic constantly changes in reality, and as it changes, travel times between facilities and demand points also fluctuate. Therefore, indicating different time and date values over several analyses may affect how demand is allocated to facilities and which facilities are chosen in the results. The time of day always indicates a start time. However, travel may start from facilities or demand points; it depends on what you choose for the Travel Direction parameter. The Time Zone for Time of Day parameter specifies whether this time and date refer to UTC or the time zone in which the facility or demand point is located.", "direction": "esriGPParameterDirectionInput", "defaultValue": null, "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Analysis" }, { "name": "Time_Zone_for_Time_of_Day", "dataType": "GPString", "displayName": "Time Zone for Time of Day", "description": "Specifies the time zone of the Time of Day parameter. The default is geographically local. Geographically Local: The Time of Day parameter refers to the time zone in which the facilities or demand points are located. If Travel Direction is facilities to demand points, this is the time zone of the facilities. If Travel Direction is demand points to facilities, this is the time zone of the demand points. UTC: The Time of Day parameter refers to Coordinated Universal Time (UTC). Choose this option if you want to choose the best location for a specific time, such as now, but aren't certain in which time zone the facilities or demand points will be located. Irrespective of the Time Zone for Time of Day setting, the following rules are\nenforced by the tool if your facilities\nand demand points are in multiple time zones:All facilities must be in the same time zone when specifying a time of day and travel is from facility to demand.All demand points must be in the same time zone when specifying a time of day and travel is from demand to facility.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Geographically Local", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Analysis", "choiceList": [ "Geographically Local", "UTC" ] }, { "name": "UTurn_at_Junctions", "dataType": "GPString", "displayName": "UTurn at Junctions", "description": "The U-Turn policy at junctions. Allowing U-turns implies the solver can turn around at a junction and double back on the same street.\n\n Given that junctions represent street intersections and dead ends, different vehicles may be able to turn around at some junctions but not at others\u2014it depends on whether the junction represents an intersection or dead end. To accommodate, the U-turn policy parameter is implicitly specified by how many edges, or streets, connect to the junction, which is known as junction valency. The acceptable values for this parameter are listed below; each is followed by a description of its meaning in terms of junction valency. \n Allowed: U-turns are permitted at junctions with any number of connected edges, or streets. This is the default value. Not Allowed: U-turns are prohibited at all junctions, regardless of junction valency. Allowed only at Dead Ends: U-turns are prohibited at all junctions, except those that have only one adjacent edge (a dead end). Allowed only at Intersections and Dead Ends: U-turns are prohibited at junctions where exactly two adjacent edges meet but are permitted at intersections (junctions with three or more adjacent edges) and dead ends (junctions with exactly one adjacent edge). Oftentimes, networks modeling streets have extraneous junctions in the middle of road segments. This option prevents vehicles from making U-turns at these locations. This parameter is ignored unless Travel Mode is set to Custom.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Allowed", "parameterType": "esriGPParameterTypeOptional", "category": "Custom Travel Mode", "choiceList": [ "Allowed", "Not Allowed", "Allowed Only at Dead Ends", "Allowed Only at Intersections and Dead Ends" ] }, { "name": "Point_Barriers", "dataType": "GPFeatureRecordSetLayer", "displayName": "Point Barriers", "description": "Specify one or more points to act as temporary\nrestrictions or represent additional time or distance that may be\nrequired to travel on the underlying streets. For example, a point\nbarrier can be used to represent a fallen tree along a street or\ntime delay spent at a railroad crossing. The tool imposes a limit of 250 points that can be added\nas barriers. When specifying the point barriers, you can set properties for each one, such as its name or barrier type, by using attributes. The point barriers can be specified with the following attributes: Name: The name of the barrier. BarrierType: Specifies whether the point barrier restricts travel\ncompletely or adds time or distance when it is crossed. The value\nfor this attribute is specified as one of the following\nintegers (use the numeric code, not the name in parentheses): 0 (Restriction)\u2014Prohibits travel through the barrier. The barrier\nis referred to as a restriction point barrier since it acts as a\nrestriction. 2 (Added Cost)\u2014Traveling through the barrier increases the travel\ntime or distance by the amount specified in the\nAdditional_Time or Additional_Distance field. This barrier type is\nreferred to as an added-cost point barrier. Additional_Time: Indicates how much travel time is added when the\nbarrier is traversed. This field is applicable only for added-cost\nbarriers and only if the measurement units are time based. This field\nvalue must be greater than or equal to zero, and its units are the same as those specified in the\nMeasurement Units parameter. Additional_Distance: Indicates how much distance is added when the barrier is\ntraversed. This field is applicable only for added-cost barriers\nand only if the measurement units are distance based. The field value\nmust be greater than or equal to zero, and its units are the same as those specified in the\nMeasurement Units parameter.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "geometryType": "esriGeometryPoint", "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "Name", "type": "esriFieldTypeString", "alias": "Name", "length": 500 }, { "name": "BarrierType", "type": "esriFieldTypeInteger", "alias": "Barrier Type" }, { "name": "Additional_Time", "type": "esriFieldTypeDouble", "alias": "Additional Time" }, { "name": "Additional_Distance", "type": "esriFieldTypeDouble", "alias": "Additional Distance" }, { "name": "CurbApproach", "type": "esriFieldTypeSmallInteger", "alias": "CurbApproach" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Barriers" }, { "name": "Line_Barriers", "dataType": "GPFeatureRecordSetLayer", "displayName": "Line Barriers", "description": "Specify one or more lines that prohibit travel anywhere\nthe lines intersect the streets. For example, a parade or protest\nthat blocks traffic across several street segments can be modeled\nwith a line barrier. A line barrier can also quickly fence off\nseveral roads from being traversed, thereby channeling possible\nroutes away from undesirable parts of the street\nnetwork. The tool imposes a limit on the number of streets you can\nrestrict using the Line Barriers parameter. While there is no limit on\nthe number of lines you can specify as line barriers, the combined\nnumber of streets intersected by all the lines cannot exceed\n500. When specifying the line barriers, you can set a name property for each one by using the following attribute: Name: The name of the barrier.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "geometryType": "esriGeometryPolyline", "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "Name", "type": "esriFieldTypeString", "alias": "Name", "length": 500 }, { "name": "SHAPE_Length", "type": "esriFieldTypeDouble", "alias": "SHAPE_Length" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Barriers" }, { "name": "Polygon_Barriers", "dataType": "GPFeatureRecordSetLayer", "displayName": "Polygon Barriers", "description": "Specify polygons that either completely restrict travel or\nproportionately scale the time or distance required to travel on\nthe streets intersected by the polygons. The service imposes a limit on the number of streets you\ncan restrict using the Polygon Barriers parameter. While there is\nno limit on the number of polygons you can specify as the polygon\nbarriers, the combined number of streets intersected by all the\npolygons should not exceed 2,000. When specifying the polygon barriers, you can set properties for each one, such as its name or barrier type, by using attributes. The polygon barriers can be specified with the following attributes: Name: The name of the barrier. BarrierType: Specifies whether the barrier restricts travel completely\nor scales the time or distance for traveling through it. The field\nvalue is specified as one of the following integers (use the numeric code, not the name in parentheses): 0 (Restriction)\u2014Prohibits traveling through any part of the barrier.\nThe barrier is referred to as a restriction polygon barrier since it\nprohibits traveling on streets intersected by the barrier. One use\nof this type of barrier is to model floods covering areas of the\nstreet that make traveling on those streets impossible. 1 (Scaled Cost)\u2014Scales the time or distance required to travel the\nunderlying streets by a factor specified using the ScaledTimeFactor\nor ScaledDistanceFactor field. If the streets are partially\ncovered by the barrier, the travel time or distance is apportioned\nand then scaled. For example, a factor 0.25 would mean that travel\non underlying streets is expected to be four times faster than\nnormal. A factor of 3.0 would mean it is expected to take three\ntimes longer than normal to travel on underlying streets. This\nbarrier type is referred to as a scaled-cost polygon barrier. It\nmight be used to model storms that reduce travel speeds in specific\nregions. ScaledTimeFactor: This is the factor by which the travel time of the streets\nintersected by the barrier is multiplied. This field is applicable\nonly for scaled-cost barriers and only if the measurement units are time\nbased. The field value must be greater than zero. ScaledDistanceFactor: This is the factor by which the distance of the streets\nintersected by the barrier is multiplied. This attribute is\napplicable only for scaled-cost barriers and only if the measurement\nunits are distance based. The attribute value must be greater than\nzero.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "geometryType": "esriGeometryPolygon", "spatialReference": { "wkid": 4326, "latestWkid": 4326 }, "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "OBJECTID" }, { "name": "Name", "type": "esriFieldTypeString", "alias": "Name", "length": 500 }, { "name": "BarrierType", "type": "esriFieldTypeInteger", "alias": "Barrier Type" }, { "name": "ScaledTimeFactor", "type": "esriFieldTypeDouble", "alias": "Scaled Time Factor" }, { "name": "ScaledDistanceFactor", "type": "esriFieldTypeDouble", "alias": "Scaled Distance Factor" }, { "name": "SHAPE_Length", "type": "esriFieldTypeDouble", "alias": "SHAPE_Length" }, { "name": "SHAPE_Area", "type": "esriFieldTypeDouble", "alias": "SHAPE_Area" } ], "features": [], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Barriers" }, { "name": "Use_Hierarchy", "dataType": "GPBoolean", "displayName": "Use Hierarchy", "description": "Specify whether hierarchy should be used when finding the shortest path between the facilities and demand points. Checked (True): Use hierarchy when measuring between facilities and demand points. When\nhierarchy is used, the tool prefers higher-order streets (such as\nfreeways) to lower-order streets (such as local roads), and can be used\nto simulate the driver preference of traveling on freeways instead\nof local roads even if that means a longer trip. This is especially\ntrue when finding routes to faraway locations, because drivers on long-distance trips tend to prefer traveling on freeways where stops, intersections, and turns can be avoided. Using hierarchy is computationally faster,\nespecially for long-distance routes, since the tool can determine the\nbest route from a relatively smaller subset of streets. Unchecked (False): Do not use hierarchy when measuring between facilities and demand points. If\nhierarchy is not used, the tool considers all the streets and doesn't\nprefer higher-order streets when finding the route. This is often\nused when finding short-distance routes within a city. The tool automatically reverts to using hierarchy if the\nstraight-line distance between facilities and demand points is\ngreater than 50 miles, even if you have set this parameter to not use hierarchy.", "direction": "esriGPParameterDirectionInput", "defaultValue": true, "parameterType": "esriGPParameterTypeOptional", "category": "Custom Travel Mode" }, { "name": "Restrictions", "dataType": "GPMultiValue:GPString", "displayName": "Restrictions", "description": "Specify which restrictions should be honored by the tool when finding the best routes between facilities and demand points. A restriction represents a driving\npreference or requirement. In most cases, restrictions cause roads\nto be prohibited. For instance, using an Avoid Toll Roads restriction will result in a route that will include toll roads only when it is absolutely required to travel on toll roads in order to visit an incident or a facility. Height Restriction makes it possible to route around any clearances that are lower than the height of your vehicle. If you are carrying corrosive materials on your vehicle, using the Any Hazmat Prohibited restriction prevents hauling the materials along roads where it is marked as illegal to do so. Below is a list of available restrictions and a short description. Some restrictions require an additional value to be\nspecified for their desired use. This value needs to be associated\nwith the restriction name and a specific parameter intended to work\nwith the restriction. You can identify such restrictions if their\nnames appear under the AttributeName column in the Attribute\nParameter Values parameter. The ParameterValue field should be\nspecified in the Attribute Parameter Values parameter for the\nrestriction to be correctly used when finding traversable roads. Some restrictions are supported only in certain countries; their availability is stated by region in the list below. Of the restrictions that have limited availability within a region, you can check whether the restriction is available in a particular country by looking at the table in the Country List section of the Data coverage for network analysis services web page. If a country has a value of Yes in the Logistics Attribute column, the restriction with select availability in the region is supported in that country. If you specify restriction names that are not available in the country where your incidents are located, the service ignores the invalid restrictions. The service also ignores restrictions whose Restriction Usage parameter value is between 0 and 1 (see the Attribute Parameter Value parameter). It prohibits all restrictions whose Restriction Usage parameter value is greater than 0. The tool supports the following restrictions:Any Hazmat Prohibited\u2014The results will not include roads\nwhere transporting any kind of hazardous material is\nprohibited. Availability: Select countries in North America and EuropeAvoid Carpool Roads\u2014The results will avoid roads that are\ndesignated exclusively for carpool (high-occupancy)\nvehicles. Availability: All countriesAvoid Express Lanes\u2014The results will avoid roads designated\nas express lanes. Availability: All countriesAvoid Ferries\u2014The results will avoid ferries. Availability: All countriesAvoid Gates\u2014The results will avoid roads where there are\ngates such as keyed access or guard-controlled\nentryways.Availability: All countriesAvoid Limited Access Roads\u2014The results will avoid roads\nthat are limited access highways.Availability: All countriesAvoid Private Roads\u2014The results will avoid roads that are\nnot publicly owned and maintained.Availability: All countriesAvoid Toll Roads\u2014The results will avoid toll\nroads.Availability: All countriesAvoid Truck Restricted Roads\u2014The results will avoid roads where trucks are not allowed, except when making deliveries.Availability: All countries Avoid Unpaved Roads\u2014The results will avoid roads that are\nnot paved (for example, dirt, gravel, and so on). Availability: All countriesAxle Count Restriction\u2014The results will not include roads\nwhere trucks with the specified number of axles are prohibited. The\nnumber of axles can be specified using the Number of Axles\nrestriction parameter.Availability: Select countries in North America and EuropeDriving a Bus\u2014The results will not include roads where\nbuses are prohibited. Using this restriction will also ensure that\nthe results will honor one-way streets. Availability: All countriesDriving a Delivery Vehicle\u2014The results will not include\nroads where delivery vehicles are prohibited. Using this restriction\nwill also ensure that the results will honor one-way\nstreets. Availability: All countriesDriving a Taxi\u2014The results will not include roads where\ntaxis are prohibited. Using this restriction will also ensure that\nthe results will honor one-way streets. Availability: All countriesDriving a Truck\u2014The results will not include roads where\ntrucks are prohibited. Using this restriction will also ensure that\nthe results will honor one-way streets. Availability: All countriesDriving an Automobile\u2014The results will not include roads\nwhere automobiles are prohibited. Using this restriction will also\nensure that the results will honor one-way streets. Availability: All countriesDriving an Emergency Vehicle\u2014The results will not include\nroads where emergency vehicles are prohibited. Using this\nrestriction will also ensure that the results will honor one-way\nstreets.Availability: All countriesHeight Restriction\u2014The results will not include roads\nwhere the vehicle height exceeds the maximum allowed height for the\nroad. The vehicle height can be specified using the Vehicle Height\n(meters) restriction parameter. Availability: Select countries in North America and EuropeKingpin to Rear Axle Length Restriction\u2014The results will\nnot include roads where the vehicle length exceeds the maximum\nallowed kingpin to rear axle for all trucks on the road. The length\nbetween the vehicle kingpin and the rear axle can be specified\nusing the Vehicle Kingpin to Rear Axle Length (meters) restriction\nparameter. Availability: Select countries in North America and EuropeLength Restriction\u2014The results will not include roads\nwhere the vehicle length exceeds the maximum allowed length for the\nroad. The vehicle length can be specified using the Vehicle Length\n(meters) restriction parameter. Availability: Select countries in North America and EuropeRiding a Motorcycle\u2014The results will not include roads\nwhere motorcycles are prohibited. Using this restriction will also\nensure that the results will honor one-way streets.Availability: All countriesRoads Under Construction Prohibited\u2014The results will not\ninclude roads that are under construction.Availability: All countriesSemi or Tractor with One or More Trailers Prohibited\u2014The\nresults will not include roads where semis or tractors with one or\nmore trailers are prohibited. Availability: Select countries in North America and EuropeSingle Axle Vehicles Prohibited\u2014The results will not\ninclude roads where vehicles with single axles are\nprohibited.Availability: Select countries in North America and EuropeTandem Axle Vehicles Prohibited\u2014The results will not\ninclude roads where vehicles with tandem axles are\nprohibited.Availability: Select countries in North America and EuropeThrough Traffic Prohibited\u2014The results will not include\nroads where through traffic (non local) is prohibited.Availability: All countriesTruck with Trailers Restriction\u2014The results will not\ninclude roads where trucks with the specified number of trailers on\nthe truck are prohibited. The number of trailers on the truck can\nbe specified using the Number of Trailers on Truck restriction\nparameter.Availability: Select countries in North America and EuropeUse Preferred Hazmat Routes\u2014The results will prefer roads\nthat are designated for transporting any kind of hazardous\nmaterials. Availability: Select countries in North America and EuropeUse Preferred Truck Routes\u2014The results will prefer roads\nthat are designated as truck routes, such as the roads that are\npart of the national network as specified by the National Surface\nTransportation Assistance Act in the United States, or roads that\nare designated as truck routes by the state or province, or roads\nthat are preferred by the trucks when driving in an\narea.Availability: Select countries in North America and EuropeWalking\u2014The results will not include roads where\npedestrians are prohibited.Availability: All countriesWeight Restriction\u2014The results will not include roads\nwhere the vehicle weight exceeds the maximum allowed weight for the\nroad. The vehicle weight can be specified using the Vehicle Weight\n(kilograms) restriction parameter.Availability: Select countries in North America and EuropeWeight per Axle Restriction\u2014The results will not include\nroads where the vehicle weight per axle exceeds the maximum allowed\nweight per axle for the road. The vehicle weight per axle can be\nspecified using the Vehicle Weight per Axle (kilograms) restriction\nparameter.Availability: Select countries in North America and EuropeWidth Restriction\u2014The results will not include roads where\nthe vehicle width exceeds the maximum allowed width for the road.\nThe vehicle width can be specified using the Vehicle Width (meters)\nrestriction parameter.Availability: Select countries in North America and EuropeThe Driving a Delivery Vehicle restriction attribute is deprecated and will be unavailable in future releases. To achieve similar results, use the Driving a Truck restriction attribute along with the Avoid Truck Restricted Roads restriction attribute.", "direction": "esriGPParameterDirectionInput", "defaultValue": [ "Oneway", "Avoid Unpaved Roads", "Avoid Carpool Roads", "Avoid Express Lanes", "Avoid Gates", "Avoid Private Roads", "Driving an Automobile", "Roads Under Construction Prohibited", "Through Traffic Prohibited" ], "parameterType": "esriGPParameterTypeOptional", "category": "Custom Travel Mode", "choiceList": [ "Avoid Carpool Roads", "Avoid Express Lanes", "Avoid Ferries", "Avoid Gates", "Avoid Limited Access Roads", "Avoid Private Roads", "Avoid Toll Roads", "Avoid Unpaved Roads", "Axle Count Restriction", "Driving a Bus", "Driving a Delivery Vehicle", "Driving a Taxi", "Driving a Truck", "Driving an Automobile", "Driving an Emergency Vehicle", "Hazmat: Any Hazardous Materials Prohibited", "Hazmat: Corrosive Goods Prohibited", "Hazmat: Explosive and Flammable Prohibited", "Hazmat: Explosives Preferred Route", "Hazmat: Explosives Prohibited", "Hazmat: Flammable Goods Prohibited", "Hazmat: Flammable solid/Combustible Prohibited", "Hazmat: Gas Prohibited", "Hazmat: General Hazardous Materials Preferred Route", "Hazmat: Goods Harmful to Water Prohibited", "Hazmat: Medical Waste Materials Preferred Route", "Hazmat: NRHM Preferred Route", "Hazmat: Organic Goods Prohibited", "Hazmat: Other Hazardous Materials Prohibited", "Hazmat: Poison Goods Prohibited", "Hazmat: Poisonous Inhalation Hazard Preferred Route", "Hazmat: Poisonous Inhalation Hazard Prohibited", "Hazmat: Radioactive Goods Prohibited", "Hazmat: Radioactive Materials Preferred Route", "Kingpin to Rear Axle Length Restriction", "Length Restriction", "National STAA Preferred Route", "National STAA and State Truck Designated Preferred Routes", "National STAA and State Truck Designated and Locally Preferred Routes", "Oneway", "Riding a Motorcycle", "Roads Under Construction Prohibited", "Semi or Tractor with One or More Trailers Prohibited", "Single Axle Vehicles Prohibited", "Tandem Axle Vehicles Prohibited", "Through Traffic Prohibited", "Truck with Trailers Restriction", "Walking", "Weight Restriction", "Weight per Axle Restriction", "Width Restriction" ] }, { "name": "Attribute_Parameter_Values", "dataType": "GPRecordSet", "displayName": "Attribute Parameter Values", "description": "Specify additional values required by some restrictions, such as the weight of a vehicle for Weight Restriction. You can also use the attribute parameter to specify whether any restriction prohibits, avoids, or prefers\ntravel on roads that use the restriction. If the restriction is\nmeant to avoid or prefer roads, you can further specify the degree\nto which they are avoided or preferred using this\nparameter. For example, you can choose to never use toll roads, avoid them as much as possible, or even highly prefer them. The values you provide for this parameter are ignored unless Travel Mode is set to Custom. If you specify the Attribute Parameter Values parameter from a\nfeature class, the field names on the feature class must match the fields as described below: AttributeName: Lists the name of the restriction. ParameterName: Lists the name of the parameter associated with the\nrestriction. A restriction can have one or more ParameterName field\nvalues based on its intended use. ParameterValue: The value for ParameterName used by the tool\nwhen evaluating the restriction. Attribute Parameter Values is dependent on the\nRestrictions parameter. The ParameterValue field is applicable only\nif the restriction name is specified as the value for the\nRestrictions parameter. In Attribute Parameter Values, each\nrestriction (listed as AttributeName) has a ParameterName field\nvalue, Restriction Usage, that specifies whether the restriction\nprohibits, avoids, or prefers travel on the roads associated with\nthe restriction and the degree to which the roads are avoided or\npreferred. The Restriction Usage ParameterName can be assigned any of\nthe following string values or their equivalent numeric values\nlisted within the parentheses: PROHIBITED (-1)\u2014Travel on the roads using the restriction is completely\nprohibited. AVOID_HIGH (5)\u2014It\nis highly unlikely for the tool to include in the route the roads\nthat are associated with the restriction. AVOID_MEDIUM (2)\u2014It\nis unlikely for the tool to include in the route the roads that are\nassociated with the restriction. AVOID_LOW (1.3)\u2014It\nis somewhat unlikely for the tool to include in the route the roads\nthat are associated with the restriction. PREFER_LOW (0.8)\u2014It\nis somewhat likely for the tool to include in the route the roads\nthat are associated with the restriction. PREFER_MEDIUM (0.5)\u2014It is likely for the tool to include in the route the roads that\nare associated with the restriction. PREFER_HIGH (0.2)\u2014It is highly likely for the tool to include in the route the roads\nthat are associated with the restriction. In most cases, you can use the default value, PROHIBITED,\nfor the Restriction Usage if the restriction is dependent on a\nvehicle-characteristic such as vehicle height. However, in some\ncases, the value for Restriction Usage depends on your routing\npreferences. For example, the Avoid Toll Roads restriction has the\ndefault value of AVOID_MEDIUM for the Restriction Usage parameter.\nThis means that when the restriction is used, the tool will try to\nroute around toll roads when it can. AVOID_MEDIUM also indicates\nhow important it is to avoid toll roads when finding the best\nroute; it has a medium priority. Choosing AVOID_LOW would put lower\nimportance on avoiding tolls; choosing AVOID_HIGH instead would\ngive it a higher importance and thus make it more acceptable for\nthe service to generate longer routes to avoid tolls. Choosing\nPROHIBITED would entirely disallow travel on toll roads, making it\nimpossible for a route to travel on any portion of a toll road.\nKeep in mind that avoiding or prohibiting toll roads, and thus\navoiding toll payments, is the objective for some; in contrast,\nothers prefer to drive on toll roads because avoiding traffic is\nmore valuable to them than the money spent on tolls. In the latter\ncase, you would choose PREFER_LOW, PREFER_MEDIUM, or PREFER_HIGH as\nthe value for Restriction Usage. The higher the preference, the\nfarther the tool will go out of its way to travel on the roads\nassociated with the restriction.", "direction": "esriGPParameterDirectionInput", "defaultValue": { "displayFieldName": "", "fields": [ { "name": "OBJECTID", "type": "esriFieldTypeOID", "alias": "ObjectID" }, { "name": "AttributeName", "type": "esriFieldTypeString", "alias": "AttributeName", "length": 255 }, { "name": "ParameterName", "type": "esriFieldTypeString", "alias": "ParameterName", "length": 255 }, { "name": "ParameterValue", "type": "esriFieldTypeString", "alias": "ParameterValue", "length": 25 } ], "features": [ { "attributes": { "OBJECTID": 59, "AttributeName": "Avoid Carpool Roads", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_HIGH" } }, { "attributes": { "OBJECTID": 60, "AttributeName": "Avoid Express Lanes", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_HIGH" } }, { "attributes": { "OBJECTID": 61, "AttributeName": "Avoid Ferries", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 62, "AttributeName": "Avoid Gates", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 63, "AttributeName": "Avoid Limited Access Roads", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 64, "AttributeName": "Avoid Private Roads", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 65, "AttributeName": "Avoid Toll Roads", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 66, "AttributeName": "Avoid Unpaved Roads", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_HIGH" } }, { "attributes": { "OBJECTID": 67, "AttributeName": "Axle Count Restriction", "ParameterName": "Number of Axles", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 68, "AttributeName": "Axle Count Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 69, "AttributeName": "Driving a Bus", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 70, "AttributeName": "Driving a Delivery Vehicle", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 71, "AttributeName": "Driving a Taxi", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 72, "AttributeName": "Driving a Truck", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 73, "AttributeName": "Driving an Automobile", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 74, "AttributeName": "Driving an Emergency Vehicle", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 75, "AttributeName": "Hazmat: Any Hazardous Materials Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 76, "AttributeName": "Hazmat: Corrosive Goods Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 77, "AttributeName": "Hazmat: Explosive and Flammable Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 78, "AttributeName": "Hazmat: Explosives Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 79, "AttributeName": "Hazmat: Explosives Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 80, "AttributeName": "Hazmat: Flammable Goods Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 81, "AttributeName": "Hazmat: Flammable solid/Combustible Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 82, "AttributeName": "Hazmat: Gas Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 83, "AttributeName": "Hazmat: General Hazardous Materials Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 84, "AttributeName": "Hazmat: Goods Harmful to Water Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 85, "AttributeName": "Hazmat: Medical Waste Materials Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 86, "AttributeName": "Hazmat: NRHM Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 87, "AttributeName": "Hazmat: Organic Goods Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 88, "AttributeName": "Hazmat: Other Hazardous Materials Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 89, "AttributeName": "Hazmat: Poison Goods Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 90, "AttributeName": "Hazmat: Poisonous Inhalation Hazard Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 91, "AttributeName": "Hazmat: Poisonous Inhalation Hazard Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 92, "AttributeName": "Hazmat: Radioactive Goods Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 93, "AttributeName": "Hazmat: Radioactive Materials Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 94, "AttributeName": "Kingpin to Rear Axle Length Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 95, "AttributeName": "Kingpin to Rear Axle Length Restriction", "ParameterName": "Vehicle Kingpin to Rear Axle Length (meters)", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 96, "AttributeName": "Length Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 97, "AttributeName": "Length Restriction", "ParameterName": "Vehicle Length (meters)", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 98, "AttributeName": "National STAA Preferred Route", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 99, "AttributeName": "National STAA and State Truck Designated Preferred Routes", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 100, "AttributeName": "National STAA and State Truck Designated and Locally Preferred Routes", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_MEDIUM" } }, { "attributes": { "OBJECTID": 101, "AttributeName": "Oneway", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 102, "AttributeName": "Riding a Motorcycle", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 103, "AttributeName": "Roads Under Construction Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 104, "AttributeName": "Semi or Tractor with One or More Trailers Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 105, "AttributeName": "Single Axle Vehicles Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 106, "AttributeName": "Tandem Axle Vehicles Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 107, "AttributeName": "Through Traffic Prohibited", "ParameterName": "Restriction Usage", "ParameterValue": "AVOID_HIGH" } }, { "attributes": { "OBJECTID": 108, "AttributeName": "Truck with Trailers Restriction", "ParameterName": "Number of Trailers on Truck", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 109, "AttributeName": "Truck with Trailers Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 110, "AttributeName": "Walking", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 111, "AttributeName": "Weight Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 112, "AttributeName": "Weight Restriction", "ParameterName": "Vehicle Weight (kilograms)", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 113, "AttributeName": "Weight per Axle Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 114, "AttributeName": "Weight per Axle Restriction", "ParameterName": "Vehicle Weight per Axle (kilograms)", "ParameterValue": "0" } }, { "attributes": { "OBJECTID": 115, "AttributeName": "Width Restriction", "ParameterName": "Restriction Usage", "ParameterValue": "PROHIBITED" } }, { "attributes": { "OBJECTID": 116, "AttributeName": "Width Restriction", "ParameterName": "Vehicle Width (meters)", "ParameterValue": "0" } } ], "exceededTransferLimit": false }, "parameterType": "esriGPParameterTypeOptional", "category": "Custom Travel Mode" }, { "name": "Allocation_Line_Shape", "dataType": "GPString", "displayName": "Allocation Line Shape", "description": "The default is to output straight lines.\n Specify the type of line features that are output by the\ntool. The parameter accepts one of the following\nvalues: Straight Line: Return straight lines between solution facilities and the demand points allocated to them. This is the default. Drawing straight lines on a map helps you visualize how demand is allocated. None: Return a table containing data about the shortest paths between solution facilities and the demand points allocated to them, but don't return lines. No matter which value you choose for the Allocation Line Shape\nparameter, the shortest route is always determined by minimizing the\ntravel time or the travel distance, never using the straight-line\ndistance between demand points and\nfacilities. That is, this parameter only changes the output line shapes; it doesn't change the measurement method.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Straight Line", "parameterType": "esriGPParameterTypeOptional", "category": "Output", "choiceList": [ "None", "Straight Line" ] }, { "name": "Travel_Mode", "dataType": "GPString", "displayName": "Travel Mode", "description": "Specify the mode of transportation to model in the analysis. Travel modes are managed in ArcGIS Online and can be configured by the administrator of your organization to better reflect your organization's workflows. You need to specify the name of a travel mode supported by your organization. To get a list of supported travel mode names, use the same GIS server connection you used to access this tool, and from the Utilities toolbox, run GetTravelModes. The GetTravelModes tool adds a table, Supported Travel Modes, to the application. Any value in the Travel Mode Name field from the Supported Travel Modes table can be specified as input. You can also specify the value from the Travel Mode Settings field as input. This speeds up the tool execution because the tool does not have to look up the settings based on the travel mode name. The default value, Custom, allows you to configure your own travel mode using the custom travel mode parameters (UTurn at Junctions, Use Hierarchy, Restrictions, Attribute Parameter Values, and Impedance). The default values of the custom travel mode parameters model traveling by car. You may want to choose Custom and set the custom travel mode parameters listed above to model a pedestrian with a fast walking speed or a truck with a given height, weight, and cargo of certain hazardous materials. You may choose to do this to try out different settings to get the analysis results you want. Once you have identified the analysis settings, you should work with your organization's administrator and save these settings as part of a new or existing travel mode so that everyone in your organization can rerun the analysis with the same settings. By choosing Custom, the values you set for the custom travel mode parameters are included in the analysis. Specifying another travel mode, as defined by your organization, causes any values you set for the custom travel mode parameters to be ignored; the tool overrides them with values from your specified travel mode.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Custom", "parameterType": "esriGPParameterTypeOptional", "category": "" }, { "name": "Impedance", "dataType": "GPString", "displayName": "Impedance", "description": "Specify the \nimpedance, which is a value that represents the effort or cost of traveling along road segments or on other parts of the transportation network. Travel distance is an impedance; the length of a road in kilometers can be thought of as impedance. Travel distance in this sense is the same for all modes\u2014a kilometer for a pedestrian is also a kilometer for a car. (What may change is the pathways on which the different modes are allowed to travel, which affects distance between points, and this is modeled by travel mode settings.) Travel time can also be an impedance; a car may take one minute to travel a mile along an empty road. Travel times can vary by travel mode\u2014a pedestrian may take more than 20 minutes to walk the same mile, so it is important to choose the right impedance for the travel mode you are modeling. Choose from the following impedance values: Drive Time\u2014Models travel times for a car. These travel times are dynamic and fluctuate according to traffic flows in areas where traffic data is available. This is the default value. Truck Time\u2014Models travel times for a truck. These travel times are static for each road and don't fluctuate with traffic. Walk Time\u2014Models travel times for a pedestrian. Travel Distance\u2014Stores length measurements along roads and paths. To model walk distance, choose this option and ensure Walking is set in the Restriction parameter. Similarly, to model drive or truck distance, choose Travel Distance here and set the appropriate restrictions so your vehicle travels only on roads where it is permitted to do so. The value you provide for this parameter is ignored unless Travel Mode is set to Custom, which is the default value. If you choose Drive Time, Truck Time, or Walk Time, the Measurement Units parameter must be set to a time-based value; if you choose Travel Distance for Impedance, Measurement Units must be distance-based.", "direction": "esriGPParameterDirectionInput", "defaultValue": "Drive Time", "parameterType": "esriGPParameterTypeOptional", "category": "Custom Travel Mode", "choiceList": [ "Drive Time", "Truck Time", "Walk Time", "Travel Distance" ] }, { "name": "Save_Output_Network_Analysis_Layer", "dataType": "GPBoolean", "displayName": "Save Output Network Analysis Layer", "description": "Specify if the tool should save the analysis settings as a network analysis layer file. You cannot directly work with this file even when you open the file in an ArcGIS Desktop application like ArcMap. It is meant to be sent to Esri Technical Support to diagnose the quality of results returned from the tool.\n Checked (True)\u2014Save the network analysis layer file. The file is downloaded in a temporary directory on your machine. In ArcGIS Pro, the location of the downloaded file can be determined by viewing the value for the Output Network Analysis Layer parameter in the entry corresponding to the tool execution in the Geoprocessing history of your Project. In ArcMap, the location of the file can be determined by accessing the Copy Location option in the shortcut menu on the Output Network Analysis Layer parameter in the entry corresponding to the tool execution in the Geoprocessing Results window. Unchecked (False)\u2014Do not save the network analysis layer file. This is the default.", "direction": "esriGPParameterDirectionInput", "defaultValue": false, "parameterType": "esriGPParameterTypeOptional", "category": "Output" }, { "name": "Overrides", "dataType": "GPString", "displayName": "Overrides", "description": "Specify additional settings that can influence the behavior of the solver when finding solutions for the network analysis problems.\n The value for this parameter needs to be specified in JavaScript Object Notation (JSON). For example, a valid value is of the following form {\"overrideSetting1\" : \"value1\", \"overrideSetting2\" : \"value2\"}. The override setting name is always enclosed in double quotation marks. The values can be a number, Boolean, or a string. The default value for this parameter is no\nvalue, which indicates not to override any solver\nsettings. Overrides are advanced settings that should be\nused only after careful analysis of the results obtained before and\nafter applying the settings. A list of supported override settings\nfor each solver and their acceptable values can be obtained by\ncontacting Esri Technical Support.", "direction": "esriGPParameterDirectionInput", "defaultValue": "", "parameterType": "esriGPParameterTypeOptional", "category": "Advanced Analysis" }, { "name": "Solve_Succeeded", "dataType": "GPBoolean", "displayName": "Solve Succeeded", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": null, "parameterType": "esriGPParameterTypeDerived", "category": "" }, { "name": "Output_Allocation_Lines", "dataType": "GPFeatureRecordSetLayer", "displayName": "Output Allocation Lines", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": {}, "parameterType": "esriGPParameterTypeDerived", "category": "" }, { "name": "Output_Facilities", "dataType": "GPFeatureRecordSetLayer", "displayName": "Output Facilities", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": {}, "parameterType": "esriGPParameterTypeDerived", "category": "" }, { "name": "Output_Demand_Points", "dataType": "GPFeatureRecordSetLayer", "displayName": "Output Demand Points", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": {}, "parameterType": "esriGPParameterTypeDerived", "category": "" }, { "name": "Output_Network_Analysis_Layer", "dataType": "GPDataFile", "displayName": "Output Network Analysis Layer", "description": "", "direction": "esriGPParameterDirectionOutput", "defaultValue": null, "parameterType": "esriGPParameterTypeDerived", "category": "" } ] }