Programming with the ArcGIS Network Analyst extension

In this topic

• Setting goals
• Automating ArcGIS Network Analyst extension workflows
• Performing network analysis
• Extending the ArcMap user interface
• Writing a new solver into the ArcGIS Network Analyst extension framework
• Working with network datasets
• Working with geometric networks
• Determining the proximity from one location to another
• Working with street directions
• Extending the network dataset through custom evaluators
• Loading data into a network analysis layer
• Working with the results of a completed analysis
• Using the ArcGIS Network Analyst extension in ArcGIS for Server
  • REST
  • REST and Web APIs
  • SOAP

Setting goals

Automating ArcGIS Network Analyst extension workflows

• Geoprocessing—Automate your workflow by utilizing the ArcGIS Network Analyst extension geoprocessing tools.
• Server—For information on how to develop with each of the server application programming interfaces (APIs), see the section on Using the ArcGIS Network Analyst extension in ArcGIS for Server. For information on ArcGIS Network Analyst extension Server ArcObjects, see the following:
  • esriNetworkAnalyst—The server portion of the NetworkAnalyst library to access the public API for the ArcGIS Server API for ArcGIS Network Analyst extension.
• ArcObjects—For information about programming against the ArcGIS Network Analyst extension API and specific components, see the NetworkAnalyst library overview. For ArcGIS Network Analyst extension ArcObjects information, see the following:
  • esriNetworkAnalyst—See the previously mentioned ArcGIS Network Analyst extension library overview to access the public API for ArcGIS Network Analyst extension solvers, NAClasses, NALayers, street direction agents, locators, and so on. The ArcGIS Server API for the ArcGIS Network Analyst extension is also located in this library.
  • esriNetworkAnalystUI—See the NetworkAnalystUI library overview to understand how to access the ArcGIS Network Analyst extension user interface (UI) in ArcMap.
  • esriGeodatabase—See the Geodatabase library overview to find out how to programmatically access the network dataset.
  • esriNetworkAnalysis—This library is not used by the ArcGIS Network Analyst extension. It contains components to use with the geometric networks used in utility and natural resource networks.

Performing network analysis

• ArcMap—To accomplish these tasks use the ArcGIS Network Analyst extension solvers Route, Closest Facility, Service Area, Origin-Destination Cost Matrix, Vehicle Routing Problem (VRP) Solver, or Location-Allocation Solver to analyze a street network with ArcMap. See Types of network analyses to explore conceptual information about each solver.
• Geoprocessing—To automate your work, use the geoprocessing tools applicable to each of the solvers.
• ArcObjects—You can also program against the previously mentioned ArcGIS Network Analyst extension library overview within ArcObjects to create a stand-alone application.

Extending the ArcMap user interface

• ArcObjects—To programmatically access components such as the NAWindow and the ArcGIS Network Analyst extension, see the previously mentioned ArcGIS Network Analyst extension UI library overview, which contains helpful information, as well as code snippets.
• Adding buttons to the NAWindow Context menu—See the sample, Export any network analysis class to a text file, to add a button to the right-click context menu for a class in the NAWindow.

Writing a new solver into the ArcGIS Network Analyst extension framework

• ArcObjects—Use C++ to create a solver. The large number of calls to the network dataset via the .NET interop can generate a significant performance hit. The Connectivity Solver sample in the C++ software development kit (SDK) is a good resource to write your solver. For code concerning the use of the network dataset API in writing your solver algorithm, see How to programmatically traverse a street network. For information about programming against the ArcGIS Network Analyst extension API, see the ArcGIS Network Analyst extension library overview.

Working with network datasets

• General concepts—The ArcGIS Network Analyst extension works on street networks in the form of network datasets. To get started, see What is the ArcGIS Network Analyst extension?. For more information, see the Help section about network datasets.
• ArcObjects—To program against network datasets, see the network dataset section of the Geodatabase library overview, which has links to other topics and code samples.
• Creating a network dataset—Use ArcMap to create a network dataset that has a creation wizard to help step you through the process. To programmatically create a network dataset, see the previously mentioned Geodatabase library overview, which includes links to network dataset samples and topics about programmatically creating a network dataset.
• Opening a network dataset—See How to open a network dataset.

Working with geometric networks

• General concepts—The ArcGIS Network Analyst extension does not work with the directed flow networks necessary to model utility and natural resource networks. See the section on geometric networks in the previously mentioned Geodatabase library overview.

Determine the proximity from one location to another

• Geoprocessing—The ArcGIS Network Analyst extension can help you find the network distance between locations. For non-network spatial distances, straight line (Euclidian) distance between two points can be determined by using the Point Distance Geoprocessing tool. Straight line closest facility analysis can be done using the Near Geoprocessing tool. A buffer polygon, instead of network service areas, can be determined using the Buffer and Multiple Ring Buffer tools. A cost table, instead of the origin-destination cost matrix, can be calculated with the Generate Near Table tool.
  
  See the following table with links to specific geoprocessing tools:

Working with street directions

• General concepts—See the conceptual information about setting directions.
• ArcObjects—To programmatically work with directions, see How to generate directions.

Extending the network dataset through custom evaluators

• General concepts—To fully understand network evaluators, first read about the types of evaluators used by a network.
• ArcObjects—The Subset network evaluators sample contains two network evaluators that can be plugged into a network dataset and used by the ArcGIS Network Analyst extension.

Loading data into a network analysis layer

• General concepts—For conceptual information, start with the introduction section concerning network analysis objects.
• ArcObjects—For information about the different types of loading done via .NET and the ArcGIS Network Analyst extension API, see How to load data into a network analysis problem.

Working with the results of a completed analysis

• General concepts—To understand the resulting output classes after a solve, see the previously listed conceptual help sections for each solver.
• ArcObjects:
  • Getting the streets resulting from an analysis—You can use the Add a traversal result to the map sample to see how to access the network elements and the underlying source features that make up a network path.
  • Reusing VRP and OD results on subsequent solves—See How to speed up VRP solves.
  • Adding traversal results to the map—Use the geoprocessing tool Copy Traversed Source Features to work with this valuable functionality.

Using the ArcGIS Network Analyst extension in ArcGIS for Server

• Publishing a network analysis service—See the Server Help system for more information about network analysis services, including a tutorial on publishing the service.
• Performing network analysis in ArcGIS for Server—There are two main ways to use remote network analysis: through the REST and SOAP APIs.

REST

1. Set properties that are different from the default.
2. Set network locations.
3. Make an Hypertext Transfer Protocol (HTTP) request to the /Solve endpoint.
4. Use the returned JavaScript Object Notation (JSON) object to get the results of the analysis.

REST and Web APIs

• Flex:
  • Overview
  • Route Task
  • Closest Facility Task
  • Service Area Task
  • Live samples
• JavaScript:
  • Overview
  • Route Task
  • Closest Facility Task
  • Service Area Task
  • Live samples
• Silverlight:
  • Overview
  • Solve Route
  • Solve Closest Facility
  • Solve Service Area
  • Live samples

SOAP

1. Get a reference to an NAServer object either through a MapServer that has an NAServer extension loaded or through an NAServer Web service.
2. Call NAServer.GetSolverParameters2 to get the NAServerSolverParams object holding the default parameters.
3. Set properties on the NAServerSolverParams object to configure how you want the analysis to be performed.
4. Set network locations (for example, stops) to use in the analysis.
5. Call NAServer.Solve, passing in the NAServerSolverParams object.
6. Use the returned NAServerSolverResults object to get the results of the analysis.

See Also: