How to create a multimodal network dataset—ArcObjects 10.4 Help for Java

Summary

This topic demonstrates how to create a multimodal network dataset from multiple feature classes in a geodatabase feature dataset. The procedure described in this topic constructs the network dataset exactly as it is constructed in Exercise 2 of the ArcGIS Network Analyst extension Tutorial (referenced in the See Also link at the end of this topic).

Specifying connectivity settings for the edge and junction source
Specifying directions settings for the edge source
Specifying global turns

Adding network attributes

Oneway network attribute
DriveTime network attribute
Meters network attribute
RoadClass network attribute
PedestrianTime network attribute

Specifying directions settings

General directions settings

Creating and building the network dataset

Creating a network dataset data element

The network dataset being created is based on the Paris.gdb file geodatabase data located in the ArcGIS Network Analyst extension tutorial. First, a network dataset data element will be created, the Transportation feature dataset will be opened, and its extent and spatial reference information copied to the data element. The network dataset will be named ParisMultimodal_ND.

This topic uses the geodatabase file, Paris.gdb, which is installed in the C:\arcgis\ArcTutor\Network_Analyst\Tutorial\Exercise02 folder. If you have the ArcGIS Tutorial Data installed, you can modify the openFromFile() call in the following code example to create the network dataset in that file geodatabase instead.

Do the following steps to create a network dataset data element:

Create an empty data element for a buildable network dataset.
Open the feature dataset and CType to the IGeoDataset interface.
Copy the feature dataset's extent and spatial reference to the network dataset data element.
Name the network dataset, ParisMultimodal_ND. See the following code example:

[Java]


        //Create an empty data element for a buildable network dataset.

IDENetworkDataset deND = new DENetworkDataset();
deND.setBuildable(true);

//Open the shapefile and cast to the IGeoDataset interface.
IWorkspaceFactory gdbWSF = new ShapefileWorkspaceFactory();
IFeatureWorkspace gdbFWS = new IFeatureWorkspaceProxy(gdbWSF.openFromFile(
    "C:\\Program Files\\ArcGIS\\DeveloperKit10.0\\SamplesNET\\data\\CreateNetworkDataset\\ParisMultimodal.gdb", 0));
IGeoDataset fdsGDS = new IGeoDatasetProxy(gdbFWS.openFeatureDataset(
    "Multimodal_Network"));

//Copy the feature dataset's extent and spatial reference to the network dataset data element.
IDEGeoDataset deGDS = (IDEGeoDataset)deND;
deGDS.setExtentByRef(fdsGDS.getExtent());
deGDS.setSpatialReferenceByRef(fdsGDS.getSpatialReference());

//Specify the name of the network dataset.
IDataElement dataElement = (IDataElement)deND;
dataElement.setName("ParisMultiNet");

Adding network sources

The network dataset will be created with six network sources, four line feature classes, and two point feature classes. The line feature classes become edge sources in the network dataset and the point feature classes become junction sources:

Sources:
Edge Sources:
    Metro_Lines
    Streets
    Transfer_Stations
    Transfer_Street_Station
Junction Sources:
    Metro_Entrances
    Metro_Stations

Specifying connectivity settings for the edge and junction source

The feature classes need to be an edge and a junction feature source in the network dataset with the appropriate connectivity and directions settings. The following is from the New Network Dataset wizard's summary for the source's connectivity settings:

Connectivity:
Group 1:
    Edge Connectivity:
      Metro_Lines (End Point)
      Transfer_Stations (End Point)
      Transfer_Street_Station (End Point)
    Junction Connectivity - Transfer Groups {2}:
      Metro_Entrances (Override) - Transfer Groups {2}
      Metro_Stations (Honor)
Group 2:
    Edge Connectivity:
      Streets (End Point)
    Junction Connectivity - Transfer Groups {1}:
      Metro_Entrances (Override) - Transfer Groups {1}

Use these connectivity settings when creating EdgeFeatureSource and JunctionFeatureSource objects. See the following code example:

[Java]


        //Create anEdgeFeatureSource object and point it to the Streets feature class.
INetworkSource streetsNetSource = new EdgeFeatureSource();
streetsNetSource.setName("Streets");
streetsNetSource.setElementType(esriNetworkElementType.esriNETEdge);

//Set the edge feature source's connectivity settings.
IEdgeFeatureSource edgeFS = (IEdgeFeatureSource)streetsNetSource;
edgeFS.setUsesSubtypes(false);
edgeFS.setClassConnectivityGroup(2);
edgeFS.setClassConnectivityPolicy
    (esriNetworkEdgeConnectivityPolicy.esriNECPEndVertex);

//Create an EdgeFeatureSource object and point it to the Metro_Lines feature class.
INetworkSource metroNetSource = new EdgeFeatureSource();
metroNetSource.setName("Metro_Lines");
metroNetSource.setElementType(esriNetworkElementType.esriNETEdge);

//Set the edge feature source's connectivity settings.
edgeFS = (IEdgeFeatureSource)metroNetSource;
edgeFS.setUsesSubtypes(false);
edgeFS.setClassConnectivityGroup(1);
edgeFS.setClassConnectivityPolicy
    (esriNetworkEdgeConnectivityPolicy.esriNECPEndVertex);

//Create an EdgeFeatureSource object and point it to the Transfer_Stations feature class.
INetworkSource tsNetSource = new EdgeFeatureSource();
tsNetSource.setName("Transfer_Stations");
tsNetSource.setElementType(esriNetworkElementType.esriNETEdge);

//Set the edge feature source's connectivity settings.
edgeFS = (IEdgeFeatureSource)tsNetSource;
edgeFS.setUsesSubtypes(false);
edgeFS.setClassConnectivityGroup(1);
edgeFS.setClassConnectivityPolicy
    (esriNetworkEdgeConnectivityPolicy.esriNECPEndVertex);

//Create an EdgeFeatureSource object and point it to the Transfer_Street_Station feature class.
INetworkSource tssNetSource = new EdgeFeatureSource();
tssNetSource.setName("Transfer_Street_Station");
tssNetSource.setElementType(esriNetworkElementType.esriNETEdge);

//Set the edge feature source's connectivity settings.
edgeFS = (IEdgeFeatureSource)tssNetSource;
edgeFS.setUsesSubtypes(false);
edgeFS.setClassConnectivityGroup(1);
edgeFS.setClassConnectivityPolicy
    (esriNetworkEdgeConnectivityPolicy.esriNECPEndVertex);

//Create a JunctionFeatureSource object and point it to the Metro_Stations feature class.
INetworkSource stationsNetSource = new JunctionFeatureSource();
stationsNetSource.setName("Metro_Stations");
stationsNetSource.setElementType(esriNetworkElementType.esriNETJunction);

//Set the junction feature source's connectivity settings.
IJunctionFeatureSource junctionFS = (IJunctionFeatureSource)stationsNetSource;
junctionFS.setUsesSubtypes(false);
junctionFS.removeAllClassConnectivityGroups();
junctionFS.addClassConnectivityGroup(1);
junctionFS.setClassConnectivityPolicy
    (esriNetworkJunctionConnectivityPolicy.esriNJCPHonor);

//Create a JunctionFeatureSource object and point it to the Metro_Entrances feature class.
INetworkSource entrancesNetSource = new JunctionFeatureSource();
entrancesNetSource.setName("Metro_Entrances");
entrancesNetSource.setElementType(esriNetworkElementType.esriNETJunction);

//Set the junction feature source's connectivity settings.
junctionFS = (IJunctionFeatureSource)entrancesNetSource;
junctionFS.setUsesSubtypes(false);
junctionFS.removeAllClassConnectivityGroups();
junctionFS.addClassConnectivityGroup(1);
junctionFS.addClassConnectivityGroup(2);
junctionFS.setClassConnectivityPolicy
    (esriNetworkJunctionConnectivityPolicy.esriNJCPOverride);

Specifying directions settings for the edge source

The edge source also has settings used when generating driving directions and identifying the fields that contain the street names. The following is from the New Network Dataset wizard's summary for the source's directions settings:

Source Directions:
    Metro_Lines:
      Street Name Fields:
        Primary:
          Name: NAME
    Streets:
      Street Name Fields:
        Primary:
          Name: FULL_NAME
    Transfer_Stations:
      Street Name Fields:
        Primary:
          Name: NAME

The previous settings are the ones to specify and the following code example shows how to implement these settings using ArcObjects:

[Java]


        //Create a StreetNameFields object and populate its settings for the Streets source.
IStreetNameFields snf = new StreetNameFields();
snf.setPriority(1); //Priority 1 indicates the primary street name.
snf.setStreetNameFieldName("FULL_NAME");

//Add the StreetNameFields object to a new NetworkSourceDirections object,
//then add it to the EdgeFeatureSource object created earlier.
INetworkSourceDirections nsd = new NetworkSourceDirections();
IArray snfArray = new Array();
snfArray.add(snf);
nsd.setStreetNameFieldsByRef(snfArray);
streetsNetSource.setNetworkSourceDirectionsByRef(nsd);

//Create a StreetNameFields object and populate its settings
//for the Metro_Lines and Transfer_Stations sources.
snf = new StreetNameFields();
snf.setPriority(1); //Priority 1 indicates the primary street name.
snf.setStreetNameFieldName("NAME");

//Add the StreetNameFields object to a new NetworkSourceDirections object,
//then add it to the EdgeFeatureSource object created earlier.
nsd = new NetworkSourceDirections();
snfArray = new Array();
snfArray.add(snf);
nsd.setStreetNameFieldsByRef(snfArray);
metroNetSource.setNetworkSourceDirectionsByRef(nsd);
tsNetSource.setNetworkSourceDirectionsByRef(nsd);

Now that all the source objects have been created, they can be added to the array, then the array can be added to the network dataset data element. See the following code example:

[Java]


        IArray sourceArray = new Array();
sourceArray.add(streetsNetSource);
sourceArray.add(metroNetSource);
sourceArray.add(tsNetSource);
sourceArray.add(tssNetSource);
sourceArray.add(stationsNetSource);
sourceArray.add(entrancesNetSource);

deND.setSourcesByRef(sourceArray);

Specifying global turns

The network dataset supports global turns, which will be set on the data element. See the following code example:

[Java]


        deND.setSupportsTurns(true);

Adding network attributes

The network dataset will be created with five network attributes:

Oneway network attribute
DriveTime network attribute
Meters network attribute
RoadClass network attribute
PedestrianTime network attribute

An empty array for the network attributes will be created, then each attribute will be created and added to the array. See the following code example:

[Java]


        IArray attrArray = new Array();

Oneway network attribute

The following is from the New Network Dataset wizard's summary for the Oneway network attribute:

Oneway:
    Usage Type: Restriction
    Data Type: Boolean
    Units Type: Unknown
    Use by Default: True
    Source Attribute Evaluators:
      Streets (From-To): Field -
          Prelogic:
            restricted = False
            Select Case UCase([Oneway])
              Case "N", "TF", "T": restricted = True
            End Select
          Expression: restricted
      Streets (To-From): Field -
          Prelogic:
            restricted = False
            Select Case UCase([Oneway])
              Case "N", "FT", "F": restricted = True
            End Select
          Expression: restricted
    Default Attribute Evaluators:
      Default Edges: Constant - Traversable
      Default Junctions: Constant - Traversable
      Default Turns: Constant - Traversable