O V E R V I E W

Network Analysis services

Network Analysis services work with network datasets in a map service to generate network solutions.

Use network analysis services to:

• Perform routing

• Find the closest facility

• Generate service areas

WSDL syntax

http://<Web Server Hostname>/<ArcGIS Instance>/services/<ServiceName>/MapServer/NAServer?wsdl

 

Working with network analysis services
 

A network analysis service extends map service capabilities by enabling access to network datasets and functionality.  It is used in conjunction with various NAServerSolverParams and NAServerSolverResults objects.

The general pattern when working with a Network Analysis service is:

1. Use the NAServer proxy to reference the NAServer extension associated with a map service (see the WSDL access section below).

2. Call GetSolverParameters 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 (e.g., Stops) to use in the analysis.

5. Call Solve, passing in the NAServerSolverParams object.

6. Use the returned NAServerSolverResults object to get at the results of the analysis.

NAServerSolverParams is an abstract object which allows you to specify general properties such as MaxSnapTolerance, ReturnMap, and OutputSpatialReference. To define the network analysis operation, use a derived object NAServerClosestFacilityParams, NAServerRouteParams, and NAServerServiceAreaParams.

The network location properties on the various NAServerSolverParams object types (e.g., Stops, Barriers, Facilities, and Incidents) are of type NAServerLocations. The NAServerLocations abstract object is implemented by two objects: NAServerPropertySets and NAServerRecordSet.   NAServerPropertySets provides access to an array of PropertySet objects.   Each PropertySet represents a network location.  Each property name and value represent a field name and value.  NAServerRecordSet provides access to a RecordSet object representing network locations.

The Solve method performs network analysis based on the NAServerSolverParams object that was passed in and returns its output through an NAServerSolverResults object.  The NAServerSolverResults object can by of type NAServerRouteResults, NAServerClosestFacilityResults, NAServerServiceAreaResults, depending on the type of operation performed.   Use this object to retrieve the results of the network analysis operation. For example, there is a property to get the MapImage created if the NAServerSolverParams.ReturnMap property was set to true.

 

Methods