Loading...
The URL can be used to link to this page
Your browser does not support the video tag.
Home
My WebLink
About
Manual_QuickestRoute
Spillman Quickest Route Manual Spillman® Public Safety Software Spillman Technologies, Inc. 4625 West Lake Park Blvd. Salt Lake City, Utah 84120 Telephone: 1-800-860-8026 www.spillman.com First Publication: December 2013 Notice Copyright © 2015, Spillman Technologies, Inc. All rights reserved. The information contained herein is proprietary to Spillman Technologies, Inc. Spillman Technologies, Inc., reserves the right to make improvements and changes in the product described in this publication at any time and without notice, and may revise this publication from time to time without notice. Spillman Technologies, Inc., provides this publication “as is” without warranty of any kind, either expressed or implied, including but not limited to the implied warranties or conditions of merchantability or fitness for a particular purpose. While every precaution has been taken in the preparation of this manual and its representation of the product, the publisher and author assume no responsibility for errors, omissions, or any damages or loss of data as a result of said errors or omissions. All other registered or unregistered trademarks and names are the property of their respective owners. Spillman, Sentryx, Involvements, Spillman Touch and Visual Involvements are federally registered trademarks of Spillman Technologies, Inc. Spillman Mobile and InSight are trademarks of Spillman Technologies, Inc. All other registered or unregistered trademarks and names are the property of their respective owners. Rev 4.23.15 Table of Contents Spillman Quickest Route Manual iii Preface 5 Other Spillman manuals 5 Windows basics 5 System requirements 6 Conventions 7 User Information 9 Introduction 10 Using Quickest Route 11 Displaying the quickest route on the CAD map 11 Using the Show Route option 12 Using the MAP SR command 12 Recommending units based on drive time 13 Using other customizing options in Mobile 14 Creating Custom Routes on the Map 17 Using the Route option 17 Using the Locate option 18 Customizing route colors in Mobile 19 Clearing custom routes from the map 20 Clearing routes manually 21 Understanding Routes on the Map 23 Viewing route directions in Mobile 23 Updating a unit-to-call route 24 Using the Quickest Route ToolTip 25 Viewing and copying turn directions 26 Administrator Information 27 Introduction 28 Installing Quickest Route 28 TOC iv Spillman Quickest Route Manual Completing setup tasks 29 Setting Up the Quickest Route Service 30 Creating an Administration Security file 30 Accessing the Quickest Route Service 31 Navigating the Quickest Route Service 33 Checking the Status of the Quickest Route Service 33 Checking the settings of the Quickest Route Service 41 Understanding the Properties file 44 Modifying the Properties file 46 Adding a configuration to the Properties file 47 Using and Selecting Multiple Datasets 50 Determining the Drive Time Delay 52 Recommending Units Based on Drive Time 53 Viewing Route Directions in Mobile 54 Recommendations for Setting Up ESRI Network Analyst Datasets 55 Setting Up Quickest Route Application Parameters 57 Setting up the qrweburl application parameter 57 Setting up the qrdtrad application parameter 59 Setting up the qrznstat application parameter 60 Understanding Barrier Layers on the Map 61 Creating an input feature class 61 Using barriers on the map 62 Using a Point barrier layer 62 Using a Line barrier layer 64 Using a Scaled Cost Line barrier layer 66 Using a Polygon barrier layer 67 Troubleshooting the barrier layer 68 Spillman Quickest Route Manual 5 Preface Welcome to the Spillman Quickest Route Manual. This manual is written for users on how to use the Spillman Quickest Route module, and for Spillman Application Administrators (SAA) on how to set up Quickest Route for their agency. Other Spillman manuals The Spillman Hub online Help file and Spillman RMS User’s Guide provides information about basic features of the Spillman software, including how to start, exit, and navigate in Spillman, and how to search screens, print information, and run reports. The Spillman Hub online Help file and Spillman RMS User’s Guide also explain how to use the Hub module, which is comprised of tables used by most Spillman users. The Spillman Applications Setup and Maintenance, Spillman Security Setup and Maintenance, and Spillman Code Table Setup and Maintenance manuals provide information for the Spillman Applications Administrator (SAA) at your agency. Windows basics Before using Spillman, be familiar with the standard features of Microsoft® Windows®. At minimum, know how to do the following: Use a mouse or keyboard to do basic tasks, such as choosing menu options and buttons. Work with windows, such as selecting, minimizing, restoring, maximizing, sizing, scrolling, closing, and so forth. Work with dialog boxes. If these tasks are unfamiliar, refer to your Windows online documentation or complete an online Windows tour. 6 Spillman Quickest Route Manual Pre System requirements General Before using Quickest Route, the following is required: Experience with ESRI ArcMap and using ArcMap of the reporting areas Knowledge of ESRI Network Analyst Extension Knowledge of your agency’s area maps Hardware The following hardware elements are required: A Windows computer with the following elements: –2 GHz processor –1 GB Memory/RAM –1.5 GB of free disk space A Windows computer can be the same as aWindows Server, but only if the above resources are dedicated solely to Quickest Route. A TCP/IP network connecting the computer running ArcEngine to the Spillman Application Server port Software The following software elements are required: Windows Operating System: Window XP, Windows7, or Windows Server 2003 and above ESRI ArcGIS 9.3.1 or 10.0, with Network Analyst Extension to create and maintain the network dataset. ESRI ArcEngine, with Network Analyst licenses for the Spillman Quickest Route Service Spillman CAD Mapping and/or Mobile Mapping license Spillman CAD Quickest Route module and/or Mobile Quickest Route license Spillman Application Server Spillman 4.6, or 6.x and above Spillman Quickest Route Manual 7 Pre Conventions When using this manual, please note the following conventions. Convention Meaning/Use Examples bold Used for names of menus, options, text boxes, buttons, fields, and other items that appear on the screen. OK is a button on the screen. Click OK or press Enter. angle bracket (>) between items Shows the menu option(s) that must be selected, in sequence, to get to a specific option. From the Start menu, select All Programs > Spillman > Spillman Mobile. plus sign (+) between keys Used for keys that are pressed at the same time. Hold down the first key, and press the other key(s). When a keystroke is available for a mouse action, both the mouse action and the keystroke are presented. Press Ctrl+E. Click Close, or press Ctrl+F4. comma (,) between keys Used for keys that are pressed in sequence. Press and release each key, in the order shown. Press Alt, F, O to open the File Options dialog box. Courier font Used for displayed text. Used for Spillman table names The software prompts: Are you sure you want to delete this record? bold Courier font Used for information you enter. Enter the street address, such as 401 W Sycamore St. italics Used for emphasis. Used for variable information you supply. Enter the date, using the mm/dd/yyyy format. 8 Spillman Quickest Route Manual Pre The following boxes signify special information. Features on your computer will depend upon your software version, modules, and privileges. Actual screens on your computer may vary from example screens shown in this manual. However, any differences are minor and do not affect the tasks being described. To find more manuals, visit MySpillman or the Spillman Knowledgebase. NOTE Notes call attention to information that is of particular importance or that varies depending on a particular condition, such as the way your Spillman Applications Administrator has configured the software. TIP Tips present recommendations, optional actions, and additional ways to perform specific tasks. CAUTION Cautions point out actions that might endanger your data or its integrity (usefulness) or cause other problems later. Chapter 1 User Information Introduction Using Quickest Route Creating Custom Routes on the Map Understanding Routes on the Map 10 Spillman Quickest Route Manual 1 User Information Introduction Introduction The Quickest Route module uses the current location of all units to determine which unit can arrive the fastest on scene, and can be used to plot routes in CAD Mapping, Pin Mapping, and Mobile Mapping. Quickest Route is also used to determine drive time and response plans for nearest units, and compensate for roadblocks or delays on a call. With Quickest Route, custom routes can be plotted between locations on the map, and from one unit, call, or address to any other unit, call, or address. Turn-by-turn directions for a route can be viewed, and colors of the assigned route can be customized. The accompanying software your agency uses, be it CAD Mapping, Pin Mapping, or Mobile Mapping, will determine which features are available to use or customize in Quickest Route. Spillman Quickest Route Manual 11 User Information 1Using Quickest Route Using Quickest Route The following sections explain how to use Quickest Route: “Displaying the quickest route on the CAD map” on page 11 “Using other customizing options in Mobile” on page 14 “Using the Route option” on page 17 “Using the Locate option” on page 18 “Customizing route colors in Mobile” on page 19 “Clearing custom routes from the map” on page 20 “Viewing route directions in Mobile” on page 23 “Updating a unit-to-call route” on page 24 “Using the Quickest Route ToolTip” on page 25 “Viewing and copying turn directions” on page 26 Displaying the quickest route on the CAD map Each time the software displays a route on the map, it selects a random color to highlight the route. Routes on the map can be displayed in the following ways, depending on the software being used: Show Route option. Determines the fastest route for an actively assigned unit or device. For more information, see “Using the Show Route option” on page 12. MAP SR command. Determines the fastest route between a specified unit, call, device, or address, and a different unit, call, device, or address. For more information, see “Using the MAP SR command” on page 12. Route button. Used to create a custom route on the map. For more information, see “Using the Route option” on page 17. Locate button. Used to locate a route on the map. For more information, see “Using the Locate option” on page 18. NOTE Only CAD Mapping uses the MAP SR command. The Route button and Locate button are available with CAD, Pin, and Mobile Mapping. The Show Route option is available only with CAD and Mobile Mapping. 12 Spillman Quickest Route Manual 1 User Information Using Quickest Route Using the Show Route option The Show Route option displays the quickest route for an actively assigned unit or device. To use the Show Route option: 1.Right-click the assigned unit or device on the map. A short-cut menu opens. 2.Select Show Route. The software displays the quickest route for the assigned unit. Using the MAP SR command The MAP SR command can be used to display the quickest route for any combination of a unit, call, device, or address to another unit, call, device, or address. Units do not need to be assigned to a call to use the MAP SR command. If a route is already displayed for a unit or device, then the software updates the route for the specified unit or device. For example, to display unit-to-call routes, enter the MAP SR command at the CAD command line in the following format: map sr.[unit#]{.call#} To display the route for a unit actively assigned to a call, the call number does not need to be specified. For example, if the unit number 103 is assigned to call 4l, enter map sr.103. To display the route for a unit not actively assigned to a call, the unit number and the call number must be specified. For example, to determine the quickest route from unit 102 to call number 10f, enter map sr.102.10f. To display device-to-call routes, enter the MAP SR command at the CAD command line in the following format: map sr.[devicelabel]{.call#} To display address-to-address routes, enter the MAP SR command at the CAD command line using the following format: map sr.[address][.address] Spillman Quickest Route Manual 13 User Information 1Using Quickest Route For example, to locate the route between 3100 Kendall Drive and 105 Mayfair Drive, enter map sr.3100 Kendall Dr.105 Mayfair Dr. The route displays on the map with the beginning and ending address points, as shown in the following example. Recommending units based on drive time Your SAA determines which criteria is used to sort recommended units. If your agency chooses to use the DRIVE feature with Quickest Route, then units can be sorted from the quickest drive time to the longest drive time when 14 Spillman Quickest Route Manual 1 User Information Using Quickest Route dispatching a call. If the DRIVE feature is included in the sort criteria, then a Drive column displays on the Recommended Units List screen, showing the calculated drive time (in minutes) for each unit. Ask your SAA if your agency uses the DRIVE feature. Using other customizing options in Mobile The following customizing options are available only in Mobile: Auto-zoom options. From the Mobile menu bar, select File > Options > Mapping. Drive column Auto-Zoom options Spillman Quickest Route Manual 15 User Information 1Using Quickest Route In the Routing Options area, the following auto-zoom options are available: –Auto-zoom to Extent of Route check box. When selected, the map continually zooms in as the unit approaches the call. When deselected, the map zooms to the extent of the route the first time the route is displayed and stays at this zoom level for the duration of the time that the unit drives to the call. –Maximum zoom level field. This field is enabled only when the Auto-zoom to Extent of Route check box is selected. Select from the list of values the maximum zoom level the map will zoom in as the unit approaches the call address:10 miles, 5 miles, 2 miles, 1 mile, 1/2 mile, 1/4 mile, or 1/8 mile. No matter how small of an area the route covers, the map will not magnify more than the zoom level selected. –Auto-zoom when Auto-Pan Enabled check box. When selected, the map continually zooms to a pre-set level when auto-panning is enabled. For more information, see the Spillman Automatic Vehicle Locator (AVL) Manual. –Zoom level field. This field is enabled only when the Auto-zoom when Auto-Pan Enabled check box is selected. Select from the list of values to zoom when auto-panning is enabled. For more information, see the Spillman Automatic Vehicle Locator (AVL) Manual. Auto Panning button ( ). Located on the Mapping toolbar, this button enables the Auto Panning mode (Ctrl+N), also known as the Follow My Unit feature, which automatically pans the map while keeping a specified unit or device’s location centered. When enabled, a large compass displays in the upper-left corner of the map, indicating the direction of travel. To change the zoom level while in Auto Panning mode, press the Page Up or Page Down keys to increase or decrease magnification. However, if the Zoom In/Out buttons are used on the map, or any of the direction keys are pressed, then the map exits Auto Panning mode. When disabled, the map stays at the current zoom level. For more information, see the Spillman Automatic Vehicle Locator (AVL) Manual. Quickest Route button ( ). Located on the Mapping toolbar, this button is used to toggle on and off the display of routes from the map and directions from the Directions pane. When deselected, any defined pin points are disabled. 16 Spillman Quickest Route Manual 1 User Information Using Quickest Route Rebidding the Route feature. When a call address changes while viewing the map with a route, the route is automatically updated, as well as the Address pane displaying the call address on the map. Spillman Quickest Route Manual 17 User Information 1Creating Custom Routes on the Map Creating Custom Routes on the Map Using the Mapping toolbar, custom routes can be displayed on the map using the following options: Route option. Creates a custom route as the quickest route. See “Using the Route option” on page 17. Locate option. Displays the quickest route from any unit, call, or address on the map to any other unit, call, or address on the map. See “Using the Locate option” on page 18. Using the Route option To create a custom route using the Route option: 1.From the Mapping toolbar, click the Route option ( ). The software displays the cursor as a green pin icon ( ). 2.Click the location from which to start the route. The software places the green pin icon on the start location and changes the cursor to a red pin icon ( ). 3.Move the red pin icon to the location at which to end the route. 4.Click the ending route point. 18 Spillman Quickest Route Manual 1 User Information Creating Custom Routes on the Map The software places the red pin at the ending location and draws the quickest route from the beginning point to the ending point. Using the Locate option To display a route using the Locate option: 1.From the Mapping toolbar, click the Locate option ( ), or press Ctrl+F. Spillman Quickest Route Manual 19 User Information 1Creating Custom Routes on the Map The Locate dialog box opens. 2.Click the Route tab. 3.In the From area, select the Unit, Device, Call, or Address from which to start the route. 4.In the To area, select the Unit, Device, Call, or Address at which to end the route. 5.Click OK. Customizing route colors in Mobile Route colors are customizable only in Mobile. To customize route colors: 1.From the Mobile menu bar, select File > Options > Mapping. Route tab 20 Spillman Quickest Route Manual 1 User Information Creating Custom Routes on the Map The Options screen opens. 2.In the Route Colors area, choose the route type to customize. Route colors may be customized for Assigned call routes and/or for Custom call routes. 3.In the desired route type field, click the drop-down arrow and select a color to change the route to. 4.Click Apply. 5.Click OK. Clearing custom routes from the map To clear a custom route from the map: 1.From the Mapping toolbar, click the Route option. Route Colors area Spillman Quickest Route Manual 21 User Information 1Creating Custom Routes on the Map 2.Select Mapping > Clear Route, or press Ctrl+R. Clearing routes manually Routes can be cleared manually, using the following methods: Clearing from the map Clearing at the Spillman command line (CAD Mapping only) Manually clearing custom routes from the map To clear a custom route from the map: 1.Right-click anywhere on the desired custom route to clear. A shortcut menu appears. 2.Select Clear Custom Route. The software clears the route. Manually clearing unit-to-call routes from the map To clear a unit-to-call route from the map: 1.Right-click the unit whose route is to be cleared. A shortcut menu appears. 2.Select Clear Route. The software clears the route. Clear Route option 22 Spillman Quickest Route Manual 1 User Information Creating Custom Routes on the Map Manually clearing unit-to-call routes at the Spillman command line For CAD Mapping only, routes can be cleared at the Spillman command line. To clear a unit-to-call route at the Spillman command line, enter the Map Clear Route command in the following format: map cr.{unit# | ALL} For example, to clear the route for unit 101, enter map cr.101. To clear the route for all units, enter map cr.ALL. Spillman Quickest Route Manual 23 User Information 1Understanding Routes on the Map Understanding Routes on the Map The following sections provide information on how to view and update routes on the map: “Viewing route directions in Mobile” on page 23 “Updating a unit-to-call route” on page 24 “Using the Quickest Route ToolTip” on page 25 “Viewing and copying turn directions” on page 26 Viewing route directions in Mobile Route directions are available only in Mobile. To view directions for a route: 1.From the Mobile Mapping toolbar, click the Route option. The Directions pane opens at the bottom of the map. Directions pane 24 Spillman Quickest Route Manual 1 User Information Understanding Routes on the Map 2.Do one of the following: –To view multiple lines of directions at a time, make the Directions pane larger, or click anywhere inside the pane to enable Multi-direction mode, as shown in the following example. –To view one line at a time, make the Directions pane smaller, or click inside the pane again to reduce it to its original size. The current direction segment becomes highlighted and scrolled to the top of the Directions pane based on the unit’s current location. To resize the Directions pane, place the cursor on the line separating the map from the pane. The cursor becomes a double-arrow. Drag the double-arrow up or down until the desired size is achieved. Updating a unit-to-call route To update a unit-to-call route on the map: 1.Right-click the unit whose route will be updated. A shortcut menu opens. 2.Select Update Route. The software updates the route from the unit to the assigned call. NOTE Route directions are updated automatically as the route is traveled. If a turn is missed or the route becomes off course, the software immediately displays an Off Route warning message and recalculates the quickest route with new directions. NOTE If an assigned call route and a custom call route are displayed on the map, the Directions pane shows only the directions for the assigned call. The software will show the directions for the custom route once the assigned call is complete. Spillman Quickest Route Manual 25 User Information 1Understanding Routes on the Map Using the Quickest Route ToolTip To view information about a route on the map, rest the cursor on the route. A ToolTip containing data about the route displays, as well as a hyperlink to the Directions window. For information on route directions, see “Viewing and copying turn directions” on page 26. The Accumulate values displayed in the bottom portion of the ToolTip depend on how your SAA sets up the software. These values come from the Impedance and AcummulateAttributeNames properties in the SpillmanQuickestRouteService.properties file, and may differ from agency to agency. However, for most agencies, the route displays the minutes for the specified route, as shown in the following example. Directions hyperlink 26 Spillman Quickest Route Manual 1 User Information Understanding Routes on the Map Viewing and copying turn directions To view and copy turn directions, click the Directions hyperlink from the route ToolTip. The Directions window opens to display turn-by-turn directions for the route, as well as the total route distance. If using the Locate option and the Route tab to locate an address, then the route description also displays. To copy turn directions, click the Copy button, and then paste the directions into a separate document or file. Copy button Chapter 2 Administrator Information Introduction Setting Up the Quickest Route Service Navigating the Quickest Route Service Using and Selecting Multiple Datasets Determining the Drive Time Delay Recommending Units Based on Drive Time Viewing Route Directions in Mobile Recommendations for Setting Up ESRI Network Analyst Datasets Setting Up Quickest Route Application Parameters Understanding Barrier Layers on the Map 28 Spillman Quickest Route Manual 2 Administrator Information Introduction Introduction The Quickest Route module uses Network Analyst from the Environmental Systems Research Institute (ESRI) to calculate a unit’s drive time to a location based on a street network maintained by your agency. It can be used with CAD Mapping, Pin Mapping, and Mobile. Quickest Route enables your agency to use different configurations, which can include multiple datasets. Some configurations can be automatically activated on a certain schedule, while others must be manually activated to adjust for conditional factors, such as a severe storm or road construction. For Quickest Route to work properly with your map, make sure of the following: Your map must have a street layer. Quickest Route draws the route on the map directly below the street layer. If the street layer is not set up, then routes will not draw on the map. For information on how to set up your map’s street layer, see the following Spillman manuals: –Mobile Administration –CAD Mapping –Pin Mapping All streets on your map must be snapped together. If the software runs into a break where road segments are not snapped, then it calculates an alternate route—which might not be the quickest. When testing routes from the map screen, select View > Ouput to view any errors related to your street layer. Installing Quickest Route The Quickest Route module is initially set up by Spillman. However, if your agency needs to reinstall Quickest Route, do the following: Make sure all system requirements are fulfilled. For more information, see “System requirements” on page 6. Run the QuickRoute.exe installer on the dedicated computer. NOTE The QuickRoute.exe installer will not create an icon on the desktop. Instead, a service entry and ArcGIS entry is created in the start-all programs menu. Spillman Quickest Route Manual 29 Administrator Information 2Introduction For help with reinstalling or troubleshooting Quickest Route, call Spillman Customer Support. Completing setup tasks To set up and maintain Quickest Route, complete the following tasks: “Setting Up the Quickest Route Service” on page 30 “Navigating the Quickest Route Service” on page 33 “Using and Selecting Multiple Datasets” on page 50 “Determining the Drive Time Delay” on page 52 “Recommendations for Setting Up ESRI Network Analyst Datasets” on page 55 “Setting Up Quickest Route Application Parameters” on page 57 “Understanding Barrier Layers on the Map” on page 61 30 Spillman Quickest Route Manual 2 Administrator Information Setting Up the Quickest Route Service Setting Up the Quickest Route Service The Quickest Route Service contains the settings and properties essential for the Quickest Route module to work properly. To use Quickest Route, the Quickest Route Service must be set up. To set up the Quickest Route Service, complete the following tasks: “Creating an Administration Security file” on page 30 “Accessing the Quickest Route Service” on page 31 “Checking the Status of the Quickest Route Service” on page 33 “Checking the settings of the Quickest Route Service” on page 41 “Recommending Units Based on Drive Time” on page 53 “Setting up the qrweburl application parameter” on page 57 “Setting up the qrdtrad application parameter” on page 59 “Setting up the qrznstat application parameter” on page 60 Creating an Administration Security file To access the Quickest Route Service administration settings, a user name and password must be set up. To create a user name and password for the Quickest Route administration settings: 1.Open the startup directory for the Quickest Route Service. 2.Create a text file named users.txt. This file stores the usernames and passwords of those users allowed to access the Quickest Route Service. 3.Save the text file to the following location: %PROGRAMDATA%\Spillman\QuickestRoute\ 4.Open the users.txt file. 5.At the text line, enter a user name and password in the following format: username=password For example, if a user name is dgordon and the password is gordon15, then enter dgordon=gordon15. Spillman Quickest Route Manual 31 Administrator Information 2Setting Up the Quickest Route Service To enter multiple users, start a new text line for each user. Comments can be added to the text file, but are not necessary. Comment text lines must be preceded by a hash mark (#) to denote them as such, as shown in the following example: #users.txt file # Enter a line for each user in the format: # username=password dgordon=gordon15 Since the actual username and password text line is not a comment, it does not use a hash mark. 6.Click Save. Accessing the Quickest Route Service The Quickest Route Service can be opened by either clicking the Quickest Route icon, or accessing the service manually. To access the Quickest Route Service manually: 1.Open your browser. 2.At the address bar, enter the path to the server using the following format: http://hostname:port/ where hostname is the name of your server. For example, http://arcengine:888/. NOTE At least one password must be set up to access the Quickest Route Service Settings screen. TIP If your browser is set up to remember your user name and password, credentials do not have to be re-entered after the first time. 32 Spillman Quickest Route Manual 2 Administrator Information Setting Up the Quickest Route Service The Quickest Route Service server screen opens, and a snapshot of server information displays on the left side of the screen. 3.In the User Name field, enter your user name. 4.In the Password field, enter your password. 5.Click Sign In. By default, the Status screen opens. Spillman Quickest Route Manual 33 Administrator Information 2Navigating the Quickest Route Service Navigating the Quickest Route Service Once logged into the Quickest Route Service, the following information displays in the upper-right corner of the screen: General Information area. Displays your user name, and the Help and Sign Out links. –Click the Help link to view help options. –Click the Sign Out link to exit the Quickest Route Service server. Status button. Click to view the Status screen of the Quickest Route Service. For more information, see “Checking the Status of the Quickest Route Service” on page 33. Admin button. Click to view and modify the Settings screen of the Quickest Route Service. For more information, see “Checking the settings of the Quickest Route Service” on page 41. Checking the Status of the Quickest Route Service The Status screen displays information on the server status, properties defined in the Properties file, HTTP settings, and user sessions of the Quickest Route Service, and is divided into four corresponding areas. To check the status of the Quickest Route Service: 1.Log on to the Quickest Route Service. For more information, see “Accessing the Quickest Route Service” on page 31. General Information area Status button Admin button 34 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service The Status screen opens by default. Status button Server Status area Properties area HTTP area Session area Spillman Quickest Route Manual 35 Administrator Information 2Navigating the Quickest Route Service For information on each setting area, see “Status area settings” on page 35. 2.To navigate back to the Status screen from any other screen, click the Status button. Status area settings The following tables list the settings displayed in each status area on the Status screen. NOTE In the Properties area of the Status screen, displayed properties are dependent on the configuration selected in the Quickest Route Service Settings screen. Values for the displayed properties are defined in the Properties file. For more information, see “Understanding the Properties file” on page 44. SERVER STATUS area Setting Description Uptime Indicates the cumulative time the Quickest Route Service has been running since the last time the service was started. user.dir Indicates the directory that Java considers to be its home directory. This status is specific to the Java Virtual machine. Hits The number of requests received. Session Manager This value is for Spillman Technologies. Current Interactive Sessions This value is for Spillman Technologies. ArcEngine The status of the ArcGIS Engine class. The following values are valid: •Ready •Error •Disabled Startup Directory The directory containing the SpillmanQuickestRouteService .properties file. Allow Automatic Network Dataset Changes Determines whether the auto-dataset changes the current dataset. Current Network Dataset Specifies the Network Dataset currently in use. 36 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service Console Logging Indicates whether logging messages are sent directly to the screen. Logging Level Displays the current logging level. Logging File Indicates the location where the log file is being written. Click the available link in this field to see the Log screen and view the log file. Click the Refresh Log link on the Log screen to refresh the log file. Invalid POST Requests The number of received POST requests that are not formed properly. Invalid GET Requests The number of received GET requests that are not formed properly. Invalid Methods The number of invalid methods located. Exceptions The number of discovered internal errors. PROPERTIES area Property Description Directory Indicates the directory the Quickest Route Service considers to be its home directory. SchemaName The name of the current dataset being used. Workspace The path to the network dataset file. Specifies the path to the folder containing the dataset, and not the actual dataset file. For example, if the network dataset file is located at data/GBSTREET_ND, the workspace is data. Workspace Type Specifies the type of workspace containing the Network Dataset. The following values are valid: •ShapFiles •Personal •File FeatureDataset Specifies the name of the feature dataset containing the Network Dataset, and is required for Personal and File geodatabase workspace types. SERVER STATUS area Setting Description Spillman Quickest Route Manual 37 Administrator Information 2Navigating the Quickest Route Service NetworkDataset The Network Dataset file. For example, Gbstreet_ND. Directions Determines whether the software calculates directions for routes: •If the value is True, the software calculates directions for routes. •If the value is False, the software does not calculate directions for routes. Set the value to False to increase the performance speed of the Quickest Route Service. However, route directions will not be viewable. SnapTolerance Determines the distance the call or unit can be from the street to have the software snap the unit or call to the street. The unit of distance the software uses is determined by the value entered in the SnapUnits property. Points beyond this distance are not included in the quickest route solve, and are considered off the street network. MaxSnapTolerance Specifies the maximum distance (in SnapUnits) a point can be from a street and still snap to a street segment. This property is optional. If nothing is found within the SnapTolerance value, the search tolerance is doubled until a network location is found or the MaxSnapTolerance value is reached. PROPERTIES area Property Description 38 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service SnapUnits Determines the unit of measure the SnapTolerance property uses to determine the snap tolerance. Use one of the following values: •Inches •Points •Feet •Yards •Miles •Nautical Miles •Millimeters •Centimeters •Meters •Kilometers •Decimal Degrees •Decimeters DefaultCutoff The cutoff value for the Impedance attribute. For example, if the Impedance attribute is set to minutes, and you want the software to locate only those routes that can be driven in five minutes or under, set the default cutoff to 5. •If there is not a unit within the default cutoff driving time, the software does not display a quickest route. •If the default cutoff time is set to 0, the software searches all data for the quickest route. Be aware, this setting will slow down the process of finding the quickest route. DefaultTargetFacilityCount The number of units desired to include in the search set. For example, if the default target facility count is set to 10, the software locates the ten closest units and lists the drive time for each unit in the Drive column on the Recommended Units List window. For all other units, the software lists the drive time as 99.9. ImpedanceAttributeName The primary value the software uses to calculate the quickest route. For the Quickest Route Service to work properly, set this value to minutes. PROPERTIES area Property Description Spillman Quickest Route Manual 39 Administrator Information 2Navigating the Quickest Route Service AccumulateAttributeNames Additional attribute values the software uses when determining the quickest route. If more than one attribute is entered, separate each attribute with a comma. In CAD Mapping, if the ToolTip is used for a route, it displays the Impedance value and the values for each of the Accumulate attributes listed for this property. RestrictionAttributeNames Attribute values the software uses to restrict the network dataset. For example, if your agency wants to restrict the software from using one-way streets, enter the attribute for one-way streets. If you enter more than one attribute, separate each attribute with a comma. BarriersWorkspace Specifies the full-path location of the barrier workspace, and is optional. For shapes files, the location will be a folder. For personal geodatabases, the location will be a .mdb file. For geodatabases, the location will be a .gdb file. Use forward slashes (/) in the path name. If unspecified, the Workspace location of the Network Dataset is used. BarriersWorkspaceType Specifies the type of workspace containing the barrier feature class, and is optional. If unspecified, the WorkspaceType of the Network Dataset is used. The following values are valid: •ShapeFiles •Personal •File BarriersFeatureDataset Defines the name of the feature dataset containing the barrier feature class, and is optional. This setting is not used for ShapeFile workspace types. If unspecified, and BarriersWorkspace is the same as Workspace, the FeatureDataset of the Network Dataset is used. Placing barriers in the same feature dataset as the Network Dataset is not recommended. PROPERTIES area Property Description 40 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service PointBarriersFeatureClass Specifies the name of a point feature class to use as barriers on the Network Dataset, and is optional. Points can act as barriers, or add more cost to the time necessary to travel over the point. Specifically named attributes are required to take advantage of some barrier properties. For more information, see ESRI’s documentation. LineBarriersFeatureClass Specifies the name of a line feature class used to place barriers on the Network Dataset, and is optional. Lines can act as barriers, or scale the cost of the time necessary to travel over the affected segment. Specifically named attributes are required to take advantage of some barrier properties. For more information, see ESRI’s documentation. PolygonBarriersFeatureClass Specifies the name of a polygon feature class used to place barriers on the Network Dataset, and is optional. Polygons can act as barriers, or scale the cost of the time necessary to travel over the affected segments. Specifically named attributes are required to take advantage of some barrier properties. For more information, see ESRI’s documentation. HTTP area (Hypertext Transfer Protocol) Setting Description Client HTTP Host string Indicates the name of the host, per the HTTP, as well as the host value in the browser header string. HTTP Headers The HTTP client headers. PROPERTIES area Property Description Spillman Quickest Route Manual 41 Administrator Information 2Navigating the Quickest Route Service Checking the settings of the Quickest Route Service To check the settings of the Quickest Route Service: 1.Log on to the Quickest Route Service. For more information, see “Accessing the Quickest Route Service” on page 31. 2.Click the Admin button. SESSION area (each user has their own session) Setting Description Created Indicates the time and date the user first connected for this session. Last Access Indicates the time and date the user received the most recent web-page from the server. Token Each session has a unique token identifier that cannot be determined by looking at other users’ tokens. IsValid If the session is inactive for 15 minutes, the server automatically exits the session. 42 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service The Quickest Route Service Settings screen opens. Items highlighted in blue indicate the current setting for a particular field. 3.In the Logging Level field, select the level at which the software logs error messages. For each level, the software logs the specified error type and all errors in lower logging levels. –OFF: Disables the logging feature. This is the lowest logging level. –FATAL: Logs fatal errors only. Fatal errors prevent the service from being used. –ERROR: Logs general errors that prevent the current operation or task from being completed. –WARN: Logs all warning errors. –INFO: Logs information errors. This level is recommended. –DEBUG: Logs tracking errors. This is the highest logging level and stores an extreme amount of information. Do not use this level unless instructed by Spillman Technologies. 4.In the Logging File field, click the Logging File link to open the Log screen and view the log file, if necessary. The log file is located Spillman Quickest Route Manual 43 Administrator Information 2Navigating the Quickest Route Service on the same server as Quickest Route. To refresh the log file, click the Refresh Log link on the Log screen. 5.In the Properties field, click the Properties link to view and modify the SpillmanQuickestRouteService.properties file, if necessary. To implement any changes, the file must be saved and the service restarted. For more information, see “Modifying the Properties file” on page 46. 6.In the Allow Automatic Configuration Changes field, determine whether to allow the service to switch to a different route configuration automatically. For example, if route patterns regularly change at 5 pm due to traffic, then the service can be set up to automatically change over to a different configuration at that time. Select one of the following options: –NO: Denies automatic configuration changes. Any changes will need to be made manually. –YES: Allows automatic configuration changes. This is the default setting. 7.In the Configuration field, all configurations created display. Select the configuration to use. 8.Click Restart the Service to restart the Quickest Route Service when necessary. If the Properties file has been modified, the service must be restarted to implement the changes. NOTE The log is a set number of rotating files, where a new log file is created when the maximum log size is reached. The default value for the log size is 1 MB, and the default value for the maximum number of files to keep is 100. To change the default value settings for the log file, contact Spillman Support. To view the log files, use the following path to the log folder: %PROGRAMDATA%\Spillman\QuickestRoute\Logs NOTE To manually switch from one configuration to another, select a different configuration from the Configuration field. Restart the service to utilize the new configuration. 44 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service A blank page opens, displaying the following message: Service is restarting... Do not click any buttons while the service is restarting. After fifteen seconds, the software redirects back to the Quickest Route Service Settings screen page. Understanding the Properties file The Properties file contains the properties and configurations that allow the Quickest Route module to properly use the network datasets created for your agency. The Properties file is split into the following two sections: Profiles. Profiles contain information specific to a property. Each property has a profile, and is listed in the first half of the Properties file. For more information, see “Profiles” on page 45. Configurations. Configurations contain the group of default properties listed in the Profiles section, with each group modified to create a new configuration. Therefore, modifying the Properties file essentially means to modify or add configurations within the Properties file. For more information, see “Configurations” on page 46. NOTE Quickest Route is unavailable while the service restarts. Changes made to the Properties file will not take effect until the service is restarted. CAUTION Do not alter any information in the Profiles section. Spillman Quickest Route Manual 45 Administrator Information 2Navigating the Quickest Route Service Profiles Each default property is listed in the first half of the file with information specific to that property, called a profile. Each profile gives a summary of the property, including its requirement type, description, and valid values. Below the summary is the property itself, written in the following formula: propertysetting=propertyvalue where the propertysetting is the name of the property, and the propertyvalue is the value assigned to the property. Profile Summary Setting Value Property 46 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service Configurations Below the Profiles section are listed any configurations that have been created for the Quickest Route, including the Default configuration, which contains all of the default properties listed in the Profiles section, as shown in the following example. Multiple configurations can be created to suit your agency’s needs. To add a configuration to the Properties file, see “Adding a configuration to the Properties file” on page 47. Modifying the Properties file To modify the Quickest Route Service Properties file: 1.Log on to the Quickest Route Service. For more information, see “Accessing the Quickest Route Service” on page 31. 2.Click the Admin button. The Quickest Route Service Settings screen opens. 3.In the Properties field, click the Properties link. The Edit Properties File screen opens. 4.Edit the file as necessary. Do not alter the Profiles section. For more information, see “Understanding the Properties file” on page 44 or “Adding a configuration to the Properties file” on page 47. Default configuration CAUTION To protect the functionality of the Quickest Route Service, create a new configuration to test your changes. For more information, see “Adding a configuration to the Properties file” on page 47. Spillman Quickest Route Manual 47 Administrator Information 2Navigating the Quickest Route Service 5.Click Save Changes. 6.Click the Admin button to return to the Quickest Route Service Settings screen. 7.Click Restart the Service to restart the Quickest Route Service and implement your changes. A blank page opens, displaying the following message: Service is restarting... Do not click any buttons while the service is restarting. After fifteen seconds, the software redirects back to the Quickest Route Service Settings screen page. Adding a configuration to the Properties file To add a configuration to the Properties file: 1.Open the Properties file. For more information, see “Modifying the Properties file” on page 46. 2.Scroll to the Configurations section, and then click inside the edit window to begin typing. Make sure there are two line spaces between any configuration created in the file. 3.For each applicable property, at a new text line, enter the new configuration name and a period, followed by the property (setting and value) in the following format: configurationname.propertysetting=propertyvalue NOTE Quickest Route is unavailable while the service restarts. Changes made to the Properties file or logging directory will not take effect until the service is restarted. 48 Spillman Quickest Route Manual 2 Administrator Information Navigating the Quickest Route Service For example, to add the property WorkspaceType to the new configuration named Test, enter Test.WorkspaceType=File. The following example shows all properties for the configuration Test. 4.When finished, click Save Changes. 5.Click the Admin button to return to the Quickest Route Service Settings screen. 6.Click Restart the Service to restart the Quickest Route Service and implement your changes. If additional configurations are added to the Properties file, repeat steps 4–6. TIP Instead of manually entering each property for a new configuration, copy and paste the properties of the Default configuration, and then modify the values of each property as necessary. Remember to add the new configuration name and a period for each property listed. Test configuration NOTE Since the configuration Test is an example only, each property line starts with a hash mark (#) to denote the information as a comment to be ignored by the software. Actual entries for a configuration should not be preceded by a hash mark. Spillman Quickest Route Manual 49 Administrator Information 2Navigating the Quickest Route Service A blank page opens, displaying the following message: Service is restarting... Do not click any buttons while the service is restarting. After fifteen seconds, the software redirects back to the Quickest Route Service Settings screen page. NOTE Quickest Route is unavailable while the service restarts. Changes made to the Properties file will not take effect until the service is restarted. 50 Spillman Quickest Route Manual 2 Administrator Information Using and Selecting Multiple Datasets Using and Selecting Multiple Datasets Creating multiple datasets for special conditions can improve the accuracy of recommended units and add flexibility to the Quickest Route module. Scheduled and non-scheduled datasets can be set up. A scheduled dataset is a dataset that applies to events that can be scheduled, such as school zone speed limit changes or rush hour. The dataset can be changed to reflect the conditions during that particular time. For example, the speed limit for certain streets or areas can be lowered. A non-scheduled dataset is a dataset that applies to events that cannot be scheduled, such as a heavy winter storm. However, all speed limits could be lowered due to road conditions. To use multiple datasets, do one of the following based on the platform your agency uses: For UNIX, create a UNIX cron task to run the datasets for scheduled data fluctuations, such as daily rush hour, weekends, and holidays. The following example shows a UNIX cron-drive dataset. For Windows, create a Windows AT task to run the datasets for scheduled data fluctuations, such as daily rush hour, weekends, and holidays. The following example shows a Windows scheduled dataset: AT 07:30 /EVERY:M,T,W,Th,F “C:\Program Files (x86)\Spillman\Quickest Route Service\wget\wget.exe http://myserver:888/opt?autodataSet=MorningRushHour” AT 09:00 /EVERY:M,T,W,Th,F “C:\Program Files (x86)\Spillman\Quickest Route Service\wget\wget.exe http://myserver:888/opt?autodataSet=Daytime” Spillman Quickest Route Manual 51 Administrator Information 2Using and Selecting Multiple Datasets The AT command schedules commands and programs to run on a computer at a specified time and date. The Schedule service must be running to use the AT command. The following example shows the AT command format and a table describing each portion of the format. AT [\\computername] [ [id] [/DELETE] | /DELETE [/YES]] AT [\\computername] time [/INTERACTIVE] [ /EVERY:date[,...] | /NEXT:date[,...]] “command” To manually switch from one configuration to another, see page 43. AT command format Command function \\computername Specifies a remote computer. Commands are scheduled on the local computer if this parameter is omitted. id An identification number assigned to a scheduled command. /delete Cancels a scheduled command. If id is omitted, all scheduled commands on the computer are deleted. /yes Used with the cancel all jobs command when no further confirmation is desired. time Specifies the time when the command is to run. /interactive Allows the job to interact with the desktop of the user who is logged on at the time the job runs. /every:date[,...]Runs the command on each specified day(s) of the week or month. If date is omitted, the current day of the month is assumed. /next:date[,...]Runs the specified command on the next occurrence of the day. For example, next Thursday. If date is omitted, the current day of the month is assumed. “command”Specifies the command or program to run, which must be enclosed in quotations marks (““). 52 Spillman Quickest Route Manual 2 Administrator Information Determining the Drive Time Delay Determining the Drive Time Delay Depending on its status, a unit’s dispatch availability might have an associated drive time delay. For example, if a fire occurs while the fire station crew are conducting training exercises, they may require extra time to get ENRT. To determine a drive time delay: 1.At the Spillman command line, enter tb10code. The Unit Status Ten-Codes screen opens. 2.Search for the Unit Status record needing a drive time delay. If the Unit Status record does not exist, create a new one. 3.In the Drive Time Delay in Minutes field, enter the drive time delay (in minutes). The value may range from 0 to 999. 4.Click Accept. 5.Click Exit. For more information on defining ten-codes, see the Spillman Mobile Administration Manual. Spillman Quickest Route Manual 53 Administrator Information 2Recommending Units Based on Drive Time Recommending Units Based on Drive Time Quickest Route can be used with the DRIVE recommended unit sort criterion, which sorts units from the quickest drive time to the longest drive time when dispatching a call. The software determines the drive time based on how your agency sets up the ESRI Network Analyst software. To use the Drive sort criteria, add it as a value to the lawsort, firesort, emssort, and miscsort application parameters. The Drive criteria is applied in conjunction with the following existing sort criteria: AGEN (agency) KIND (alias kind) or KIND2 (alias kind) STN (station) ZONE (zone) STS (status) DRIVE (quickest driving route) PROX (proximity) COST (unit operation cost) TIME (time since the last status change) If the DRIVE feature is included in the sort, then a Drive column displays on the Recommended Units list screen, showing the calculated drive time (in minutes) for each unit. For more information on sorting the Recommended Units list, see the Spillman Application Setup and Maintenance Manual. Drive column NOTE If the software cannot find a valid route value, then it returns a drive time value of 99.9m. For example, this can happen if the drive time is over 99 minutes, or streets are not snapped together and the software cannot find a route. 54 Spillman Quickest Route Manual 2 Administrator Information Viewing Route Directions in Mobile Viewing Route Directions in Mobile Route directions are available only in Mobile. For users to view route directions, the following properties must be defined in the Mobile Options file: <DistanceWindowMin>70</DistanceWindowMin> Determines the size (in pixels) at which the software displays the directions in the Directions pane one line at a time. <DistanceWindowMax>120</DistanceWindowMax> Determines the size (in pixels) at which the software displays the directions in the Directions pane several lines at a time. For more information on defining properties in Mobile, see the Spillman Mobile Manual. NOTE Server AVL (formerly known as Direct AVL) does not work with Quickest Route. For more information, see the Spillman Mobile Manual. Spillman Quickest Route Manual 55 Administrator Information 2Recommendations for Setting Up ESRI Network Analyst Datasets Recommendations for Setting Up ESRI Network Analyst Datasets To use the Quickest Route Service, ArcGIS is required and a network dataset must be created using the Network Analyst Extension. For Quickest Route to work properly, an attribute for travel time must be defined. Information will be more accurate if one-way streets are also defined. In addition, defining distance allows users to easily view the route distance. The following example shows how these attributes might be set up in a network dataset. Use the following guidelines when setting up the Network Analyst: Define the travel time (Impedance value in Network Analyst) in minutes. –The following example shows a Visual Basic script using a speed limit attribute in conjunction with the line segment distance (in feet) to define an Impedance value in minutes. spd=25 if [ SPD_LIMIT] > 0 then spd = [ SPD_LIMIT] end if mins = (60 * [ SHAPE_len]) / (5280 * spd) Set up one-way streets. To model one-way streets, create a field called Oneway to specify one-way data, and then enter one of the following values to specify a valid travel direction: –FT. Indicates the street segment allows travel only in the digitized direction of the segment (from-to) 56 Spillman Quickest Route Manual 2 Administrator Information Recommendations for Setting Up ESRI Network Analyst Datasets –TF. Indicates the street segment allows travel only against the digitized direction of the segment (to-from) –Blank. A blank field indicates that travel is allowed in both directions. The New Network Dataset wizard will recognize the Oneway field and automatically create evaluators that properly interpret the specified values. Make sure all street segments are snapped. Sometimes segments can appear snapped, when in fact they are not. Street segments must be properly snapped together for Quickest Route to function correctly. For information on verifying snapped street segments, see the ArcGIS documentation. Test your network datasets in ESRI ArcMap prior to using them in Quickest Route. Spillman Quickest Route Manual 57 Administrator Information 2Setting Up Quickest Route Application Parameters Setting Up Quickest Route Application Parameters To use Quickest Route, the following application parameters must be set up: qrweburl qrdtrad qrznstat Setting up the qrweburl application parameter The qrweburl application parameter is used to activate Quickest Route and set up the path Spillman and Mobile will use to send route requests to the Quickest Route Service. Once set, users can log into CAD and Mobile with access to Quickest Route Service requests. If qrweburl is not set up, CAD and Mobile will not attempt to use the Quickest Route Service. To set up the qrweburl application parameter: 1.At the Spillman command line, enter apparam. The Application Parameter Table screen opens. NOTE If your agency uses Quickest Route for Mobile, then the following must be done after setting up the Quickest Route application parameters: –The Mobile server must be restarted from the Daemon Manager screen (sydaemon). For more information, see the Spillman Application Setup and Maintenance Manual. –Mobile users must re-log and accept any updates to download the new settings. 58 Spillman Quickest Route Manual 2 Administrator Information Setting Up Quickest Route Application Parameters 2.Search for the qrweburl record, as shown in the following example. If the record does not exist, create it by clicking Add. 3.In the Application Paremeter Name field, enter qrweburl. 4.In the Parameter Description field, enter Quickest Route web service URL. If the record exists, this is the default description. 5.In the Application Parameter Value field, enter the host and port for the quickest route web service URL using the following format: http://hostname:port {timeout value} For example, http://arcengine:888. 6.Click Accept. Once the Quickest Route module has been installed and activated in Spillman, the Quickest Route icon displays on the Spillman Application Server home screen, and can be used as a link to access your agency’s Quickest Route Server. If the icon is not enabled, contact the Spillman Support department. TIP A time-out value (in seconds) can be added after the port in the Application Parameter Value field. The time-out value indicates how many seconds the software will wait for the Quickest Route service to respond. For example, to add a time-out value of three seconds, enter http://arcengine:888 3. If a time-out value is not specified, the software defaults to two seconds. NOTE The Quickest Route icon will display even if the path entered in the Application Parameter Value field is not a valid path to the server. Spillman Quickest Route Manual 59 Administrator Information 2Setting Up Quickest Route Application Parameters Setting up the qrdtrad application parameter The qrdtrad application parameter instructs the software to use one drive time for all units located within a specified radius. Setting the radius in the qrdtrad application parameter improves performance. For example, if five units are all parked at a store and each unit has different latitude/longitude values based on their AVL, but all units fall within the specified radius range, then the software sends the quickest driving time request for one unit and uses the returned drive time for all five units. To set the qrdtrad application parameter: 1.At the Spillman command line, enter apparam. The Application Parameter Table screen opens. 2.Search for the qrdtrad record, as shown in the following example. If the record does not exist, create it by clicking Add. 3.In the Application Parameter Name field, enter qrdtrad. 4.In the Parameter Description field, enter Radius for same unit drv time. If the record exists, this is the default description. 5.In the Application Parameter Value field, enter the value in geobase units that your agency uses. The default value is 1500, and equates to 548 feet if gbsfact is set to 1 million. 6.Click Accept. NOTE The qrdtrad application parameter is dependant on the gbsfact application parameter. 60 Spillman Quickest Route Manual 2 Administrator Information Setting Up Quickest Route Application Parameters Setting up the qrznstat application parameter Increase the performance of Quickest Route by identifying those unit statuses in which all units within that status are likely to be at the station. For example, if multiple fire engines are located at the same station and each fire engine has a status code of INSRV, then the qrznstat parameter can be set to INSRV. The software uses the x- and y-coordinates of the zone center instead of the unit for all units with the INSRV status. The software queries only one vehicle for each status listed in the qrznstat application parameter, and then uses the drive time for all units with the same status. To set up the qrznstat application parameter: 1.At the Spillman command line, enter apparam. The Application Parameter Table screen opens. 2.Search for the qrznstat record, as shown in the following example. If the record does not exist, create it by clicking Add. 3.In the Application Parameter Name field, enter qrznstat. 4.In the Paramenter Description field, enter STAT uses zn X/Y not unit X/Y. If the record exists, then this is the default description. 5.In the Application Parameter Value field, enter in the unit status. For example, INSRV. Separate multiple statuses with a comma. 6.Click Accept. Spillman Quickest Route Manual 61 Administrator Information 2Understanding Barrier Layers on the Map Understanding Barrier Layers on the Map Barriers are feature classes in Network Analysis layers that restrict or alter impedances of the underlying edges and junctions of the associated network dataset. Barriers are designed to model temporary changes to the network, and are split into the following three geometry types: Point. See “Using a Point barrier layer” on page 62. Line. See “Using a Line barrier layer” on page 64. Polygon. See “Using a Polygon barrier layer” on page 67. To use barrier layers, complete the following tasks: “Creating an input feature class” on page 61 “Using barriers on the map” on page 62 “Troubleshooting the barrier layer” on page 68 For more information on barriers, see the ESRI documentation. Creating an input feature class When Quickest Route loads a barrier feature class, it needs to map fields in the input feature class to fields in the corresponding network analyst barrier class. To work properly, certain fields are required for each geometry type. An input feature class with the required Attributes table fields can be created manually or in ArcMap. The process for creating an input feature class is the same for each geometry type. To create an input feature class: 1.In ArcGIS, open the network dataset. 2.From the Utility Network Analyst toolbar, click the Solve button to create a new solver. For example, New OD Cost Matrix. 3.From the Network Analyst toolbar, toggle the Show/Hide Network Analyst window to make sure the Network Analyst window is open. 4.In the Network Analyst window, right-click the desired geometry type, such as Point Barriers. 5.Select Attribute Table. All of the necessary fields can be viewed from the Attributes table. 6.To add barriers to this feature class, verify that the desired geometry type, such as Point Barriers, is selected. 62 Spillman Quickest Route Manual 2 Administrator Information Understanding Barrier Layers on the Map 7.From the Network Analyst toolbar, select the Create Network Location tool. 8.On the map, click the area to add the barrier type to. For more information, see “Creating Network Analysis Objects Using the Create Network Location Tool” and “Loading Network Analysis Objects in ArcMap” in ESRI’s documentation. 9.In the Network Analyst window, right-click the desired geometry type, such as Point Barriers, and then select Export Data from the context menu. Using barriers on the map To use barriers on the map: 1.Create and save your Point, Line, or Polygon barrier layer in your Network Dataset. 2.Open the Properties file. For more information, see “Modifying the Properties file” on page 46. 3.In the Properties file, in the Configurations section, each barrier type to be used must be defined under the configuration for which it is being included. Configure the following settings in each configuration that barriers will be applied to: –BarriersWorkspace= –BarriersWorkspaceType= –BarriersFeatureDataset= –PointBarrierFeatureClass= –LineBarrierFeatureClass= –PolygonBarrierFeatureClass= For more information on each barrier setting, see property descriptions on page 39. Property summaries can also be viewed in the Profiles section of the Properties file. Do not alter the Properties section. For more information, see “Understanding the Properties file” on page 44. Using a Point barrier layer There are two types of Point barriers: Restriction. Prevents travel through the barrier. Spillman Quickest Route Manual 63 Administrator Information 2Understanding Barrier Layers on the Map Added Cost. Allows travel, but incurs a fee. The following are the required Attributes table fields and their descriptions for the Point barrier layer. Object ID The system-managed ID field. Name The name of the network analysis object. BarrierType Specifies whether the point barrier restricts travel completely or adds impedance when it is crossed by using the following options: Restriction (0): Prohibits traveling through the barrier. This is the default value. Added Cost (2): Allows traveling through the barrier, but increases the network cost by the amount specified in the Attr_[Impedance] property value. FullEdge Specific to Restriction Point barriers on edge elements, using the following values: False: Permits travel on the edge up to the barrier, but not through it. This is the default value. True: Restricts travel anywhere on the associated edge. Attr_[Impedance] Specific to Added Cost barriers, and is limited to values that are greater than or equal to zero. This field indicates how much network impedance is added when the barrier is traversed. SourceID, SourceOID, PosAlong, SideOfEdge These four network location fields describe the point on the network where the object is located. For more information, see Network Locations in the ESRI Help documentation. 64 Spillman Quickest Route Manual 2 Administrator Information Understanding Barrier Layers on the Map CurbApproach Specifies the direction of traffic that is affected by the barrier. If a barrier is on an edge, then the following actions result according to how its curb property is set: Either side of vehicle (0): The barrier affects travel over the edge in both directions. Right side of vehicle (1): The barrier only affects vehicles traveling in such a way that the barrier is on their right side. Vehicles that traverse the same edge, but approach the barrier on their left side are not affected. Left side of vehicle (2): The barrier only affects vehicles traveling in such a way that the barrier is on their left side. Vehicles that traverse the same edge, but approach the barrier on their right side are not affected. The following example is of an Attributes table for a Point barrier layer. Using a Line barrier layer There are two types of Line barriers: Restriction. Prohibits travel anywhere the barrier intersects the network. Scale Cost. Scales the cost of traversing covered edges and junctions by a factor specified in the Attr_[Impedance] field. For example, a factor of 0.25 means travel is expected to be four times faster. The following are the required Attributes table fields and their descriptions for the Line barrier layer. NOTE For the Scale Cost to work correctly, a line barrier must be placed exactly on the desired segment. Spillman Quickest Route Manual 65 Administrator Information 2Understanding Barrier Layers on the Map Object ID The system-managed ID field. Name The name of the network analysis object. BarrierType Specifies whether the line barrier restricts travel completely or scales the cost of traveling through it by using the following options: Restriction (0): Prohibits traveling through any part of the barrier. This is the default value. Added Cost (1): Scales the impedance of underlying edges by multiplying the value specified in the Attr_[Impedance] property value. If edges are partially covered by the barrier, then the impedance is apportioned and multiplied. Attr_[Impedance] Specific to Scale Cost barriers, and is the factor by which the impedance of edges underlying the barrier is multiplied. For example, Attr_Minutes, where Minutes is the impedance for the network. Field values must be zero (0) or greater. However, if the value is set to 0, then solves will likely return nonsensical results, since the underlying edge costs become free to traverse. Therefore, using values greater than 0 is recommended. The following example is of an Attributes table for a Line barrier layer. 66 Spillman Quickest Route Manual 2 Administrator Information Understanding Barrier Layers on the Map Using a Scaled Cost Line barrier layer Line barriers that scale drive times need to intersect a span of one or more roads to have any scaling effect. That is, a Scaled Cost Line barrier that intersects a street at a point cannot scale drive times because the overlapping length would be zero, as shown in the following example Even if a line barrier is created that extends along a road, how the line is created must be considered to ensure the desired results are obtained. For example, digitizing a Scaled Cost Line barrier along a street will likely result in an ineffective barrier that intersects the road at several points because the snap feature is unavailable with the tool. Also, a line that is digitized on top of another line at one scale may appear as coincident, but zooming in reveals the lines only intersect at points. In the following example, the barrier intersects at two points. Therefore, it does not scale drive times. To create a Scaled Cost Line barrier, select the underlying street features where the barrier should be located, and then load the selected streets into the barriers class. Another option is to create a route along the streets where the barrier will be, and then load the route feature as a barrier. Doing so will result in barriers that are truly coincident with the underlying streets. If the purpose of the line barrier is to cut across network elements and block travel where the barrier intersects edges and junctions, then use the Create Network Location tool. Alternatively, if the purpose is to restrict a span along an edge, then create a line feature in an edit session and load it into the line barriers class. An easier option is to create a polygon barrier. However, if a line barrier is still needed, then use the Trace tool in ArcMap. The Trace tool creates a line that allows for more control than the Create Network Location tool, and ensures that the line barrier is coincident with the network source features. Spillman Quickest Route Manual 67 Administrator Information 2Understanding Barrier Layers on the Map Creating a Scaled Cost Line barrier layer To create a Scaled Cost Line barrier layer using the Trace tool: 1.In ArcMap, from the Editor toolbar, click Start Editing. 2.Click the Edit tool. 3.In the Create Features window, verify that the line barrier feature class is selected. Also, be sure the desired layer is in the list of Selectable Layers. 4.Select the features to trace. 5.Click Trace tool. 6.Click on the map to start tracing. 7.Click on the map again to stop tracing. 8.When finished, double click on the map to complete the sketch. 9.From the Editor toolbar, click Stop Editing. 10.Click Save. Using a Polygon barrier layer There are two types of polygon barriers: Restriction. Prohibits travel anywhere the barrier intersects the network. Scaled Cost. Scales the cost of traversing covered streets and junctions by a factor specified in the Attr_[Impedance] field. For example, a factor of 2.0 means travel is expected to take twice as long. The following are the required Attributes table fields and their descriptions for the Polygon barrier layer. Object ID The system-managed ID field. Name The name of the network analysis object. BarrierType Specifies whether the line barrier restricts travel completely or scales the cost of traveling through it by using the following options: 68 Spillman Quickest Route Manual 2 Administrator Information Understanding Barrier Layers on the Map Restriction (0): Prohibits traveling through any part of the barrier. This is the default value. Added Cost (1): Scales the impedance of underlying edges by multiplying the value specified in the Attr_[Impedance] property value. If edges are partially covered by the barrier, then the impedance is apportioned and multiplied. Attr_[Impedance] Specific to Scale Cost barriers, and is the factor by which the impedance of edges underlying the barrier is multiplied. For example, Attr_Minutes, where Minutes is the impedance for the network. Field values must be zero (0) or greater. However, if the value is set to 0, then solves will likely return nonsensical results, since the underlying edge costs become free to traverse. Therefore, using values greater than 0 is recommended. The following example is of an Attributes table for a Polygon barrier layer Troubleshooting the barrier layer The following table lists common problems related to creating barrier layers. Problem Cause and solution Routes do not appear, and no error messages are given. For example, mapping pins drop, but results do not show on the map. Define which map layer is the Street layer. Schema locks in a geodatabase The geodatabase may have been put into a state where lock files are being left behind. Make sure processes are not using the geodatabase and delete all *.lock files, or use ArcCatalog to copy the geodatabase. When the geodatabase is copied, the lock files are not. Spillman Quickest Route Manual 69 Administrator Information 2Understanding Barrier Layers on the Map To troubleshoot the Network Analyst, see ESRI’s Help documentation. Solve is noticeably slow in the log at “Class Field Map” A barrier feature class does not have the correct columns for the software to automatically map to the columns specified in the required input fields. When starting the server, the following error message displays: Could not load native libraries. The Java libraries being used are set to 64-bit. In ArcGIS 10, Java libraries need to be 32-bit. Change the value accordingly. Problem Cause and solution 70 Spillman Quickest Route Manual 2 Administrator Information Understanding Barrier Layers on the Map