GeocodeRoute WebService Sample


Description:

This sample is a stand-alone application that shows how to programmatically perform point-to-point routing using the Network Analyst server extension connecting to a network anlaysis web service. This sample demonstrates some of the key programming patterns when using Network Analyst server objects such as:

  1. Connecting to the web service.
  2. Accessing solver properties from a Route analysis layer.
  3. Geocoding two addresses.
  4. Creating stop locations from the geocoded addresses.
  5. Solving to find the best route.
  6. Diplaying the map showing the route, and the total impedance of the route.

Data requirements:

  1. The Network Analyst sample data for the San Francisco region can be used to create the required server objects. To use your own data with this sample, refer to the documentation on designing and building a network dataset in the ArcGIS Desktop Help > Contents tab > Extensions > Network Analyst.
  2. The network dataset must be built with at least one cost attribute, likely based on distance. Optionally, you can add more cost attributes based on time units for example, add restrictions, or add direction information in order to generate driving directions.
  3. The map document must contain the network dataset, a Route analysis layer, and a point feature layer.

Products:
ArcView: C#, VB.NET
Engine: C#, VB.NET
Server: C#, VB.NET

Extension: Network Analyst

Platforms: Windows

Minimum ArcGIS Release: 9.2

How to use:
[NET, .NET, C#, VB.NET]
  1. Publish a network analysis service
    1. Open ArcCatalog
    2. Browse to [Your ArcGIS install folder]\DeveloperKit\SamplesNET\Server\data\SanFranciscoNetwork
    3. Right-click on SanFrancisco.mxd and click on "Publish to ArcGIS Server..."
    4. Enter 'SanFrancisco' as the Service Name
    5. Click Next
    6. Ensure "Network Analysis" is checked and click Next
    7. Click Finish
  2. Publish a geocoding service
    1. Right-click on SanFranciscoLocator and click on "Publish to ArcGIS Server..."
    2. Enter 'SanFranciscoLocator' as the Service Name and click Next
    3. Click Finish
    4. Close ArcCatalog
  3. Add a reference to the service
    1. Open GeocodeRoute_WebService.sln (VB.NET or C#)
    2. In the Solution Explorer, Right click on References, then select Add Web Reference
    3. Type in the URL "http://localhost/arcgis/services/SanFrancisco/MapServer/NAServer.agsx?wsdl" (change localhost if the ArcGIS server is on a different machine) and click Go
    4. Change the Web Reference Name from "localhost" to "WebService"
    5. Click Add Reference
    6. Save the solution
    7. Exit Visual Studio
  4. Merge WSDLs from NAServer and GeocodeServer
    1. Open a Visual Studio 2005 command prompt
    2. Change to the directory where the proxy stub file was generated: [Solution Folder]\Web References\WebService
    3. For C#, type in the following (change localhost if the ArcGIS server is on a different machine): "wsdl.exe /Language:cs /verbose /sharetypes /namespace:GeocodeRoute_WebService.WebService /out:Reference.cs http://localhost/arcgis/services/SanFrancisco/MapServer/NAServer.agsx?wsdl http://localhost/arcgis/services/SanFranciscoLocator/GeocodeServer?wsdl"
    4. For VBNet, type in the following (change localhost if the ArcGIS server is on a different machine): "wsdl.exe /Language:VB /verbose /sharetypes /namespace:GeocodeRoute_WebService.WebService /out:Reference.vb http://localhost/arcgis/services/SanFrancisco/MapServer/NAServer.agsx?wsdl http://localhost/arcgis/services/SanFranciscoLocator/GeocodeServer?wsdl"
  5. Run the sample
    1. Open GeocodeRoute_WebService.sln (VB.NET or C#)
    2. Build and run the project
    3. Choose the route solver options
    4. Click the Find Route button
    5. Click on the different tabs to get the solver results

Download the C# files
GeocodeRoute_WebServiceClass.cs
(view code)
C# form.
GeocodeRoute_WebService.csproj The project file.
GeocodeRoute_WebService.sln The solution file.
GeocodeRoute_WebService.resx A project file.
Download the VB.NET files
GeocodeRoute_WebServiceClass.vb
(view code)
VB.NET form.
GeocodeRoute_WebService.vbproj The project file.
GeocodeRoute_WebService.sln The solution file.
GeocodeRoute_WebService.resx A project file.

Download the files for all languages



Key Libraries: NetworkAnalyst
Key CoClasses:NAServer, NAServerRouteParams, NAServerRouteResults, NAStreetDirections
Key Interfaces: INAServer, INAServerSolverParams, INAServerSolverResults, INAServerRouteParams, INAServerRouteResults, INAStreetDirections
Key Members:INAServer::Solve, INAServer::GetNALayerNames, INAServerSolverParams::ReturnMap, INAServerSolverResults::SolveMessages, INAServerSolverResults::MapImage, INAServerRouteParams::Stops, INAServerRouteParams::ReturnDirections, INAServerRouteResults::Directions, INAServerRouteResults::Total_Impedances