Authoring a web map for the Roadway Characteristics Editor—Help

Using a web map on ArcGIS.com
Copying a web map from ArcGIS.com as a local file
Using a web map as a local file on the web server

The Roadway Characteristics Editor gets its map definition of which layers to use from a web map. Web maps are maps that can be authored and hosted on ArcGIS.com. To clarify the basic deployment steps of the Roadway Characteristics Editor, a copy of a web map is placed into the Roadway Characteristics Editor web deployment folder.

Depending on the type of security infrastructure of the ArcGIS Server (public facing or behind a firewall) serving the data layers for the web map, the hosted location of the web map itself needs to be adjusted.

There are three options for hosting the web map:

Using a web map on ArcGIS.com

Web maps can be authored using ArcGIS.com. You can choose to add the data layers (map service) you intend to use, change the extent, select a basemap from the basemap gallery, include a description of the map, and save it as your own item for use within the Roadway Characteristics Editor.

Log in to the ArcGIS.com website.

When you log in to ArcGIS.com for the first time, you need to create an account.
Create a web map with linear referencing capability on ArcGIS.com.

Add at least one map service with linear referencing capability that contains the LRS Network layers and the event layers as one of the layers in the web map. Optionally, you can also add basemaps or any reference layers as layers in the web map.
Once you have created a web map and added all required layers, click Save.
Enter the following information for the web map:
- Title
- Tags
- Summary
Choose a folder in My Content to store the web map.
Click Save.

See Save maps for more information.
Make the web map publicly accessible.
1. Click Share.
2. Check the Share with everyone (public) check box. See Sharing items for more information.
  
  Although the web map is shared publicly, you can limit access to the map service with linear referencing capability by enabling ArcGIS Server security. If the ArcGIS Server exposing the map services is behind a firewall, consider copying the web map from ArcGIS.com to the web folder on the web server that hosts the Roadway Characteristics Editor web application as a JSON file.
After the web map is created, you need to know the web map ID because it will be used in the other steps of the Roadway Characteristics Editor deployment process.
1. Click My Content.
2. Click the title of the web map to open the item details.
  
  The URL for the item details web page will be in the following format: http://www.arcgis.com/home/item.html?id=<webmapID>. The web map ID is the 32-character string at the end of the URL.
  
  For example: http://www.arcgis.com/home/item.html?id=1dcf369089804329946e3b3abf385251

Copying a web map from ArcGIS.com as a local file

If you have an ArcGIS.com account and your organization restricts members from sharing items outside the organization, copying the web map onto the web server might be the best approach.

Open a web browser and enter the web map definition URL in the address bar. The URL for the web map definition should have the following syntax: http://www.arcgis.com/sharing/content/items/<your web map ID>/data?f=pjson.

For example, the following URL retrieves the web map definition for the New York sample data hosted on ArcGIS.com: http://www.arcgis.com/sharing/content/items/1dcf369089804329946e3b3abf385251/data?f=pjson.
Copy the entire contents of the web page and paste it into a text file.
Rename the text file to have a .json extension.

You can use any name for the .json file.
Copy the file to the web folder containing the Roadway Characteristics Editor web application on the web server.

For example, in Internet Information Services (IIS), the web folder may be located at C:\inetpub\wwwroot\RoadwayCharacteristics.

The actual location of the IIS wwwroot directory could differ on your server machine. Use the IIS Management Console to get the location of the IIS wwwroot directory.

Using a web map as a local file on the web server

As an alternative to authoring the web map using ArcGIS.com, you can author web maps directly by modifying the URL parameters in the sample web map that can be found within the Roadway Characteristics Editor web application.

Using Windows Explorer, browse to the sample web map at $INSTALL_DIR$\Server\Web\RoadwayCharacteristics\sample_webmap.json.

Using a text editor, open the sample web map (sample_webmap.json) file.

{
  "operationalLayers": [{
    "id": "LRS_map_service",
    "title": "LRS map",
    "url": "http://roadsandhighwayssample.esri.com/ArcGIS/rest/services/RoadsHighways/NewYork/MapServer",
    "visibleLayers": [ 0, 1, 2, 3 ]
  }],
  "baseMap": {
    "baseMapLayers": [
      {
        "id": "World_Light_Gray_Base",
        "url": "http://services.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer"
      },
      {
        "id": "World_Light_Gray_Reference",
        "isReference": true,
        "visibility": true,
        "url": "http://services.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Reference/MapServer"
      }
    ],
    "title": "Basemap"
  },
  "version": "1.6"
}

URL parameters allow you to define the contents of a map, for example, the basemap, operational layers, and extent.

At a minimum, some of the items within the operationalLayers configuration section need to be modified to use your data.
1. Change the url parameters to point to the URL of the map service with linear referencing capability that you have published.
2. Change the visibleLayers parameters to include the layer ID of the layers that you would like to be visible by default.
For more information on authoring a web map, see Using URL parameters.
Copy the file to the web folder containing the Roadway Characteristics Editor web application on the web server.

For example, in Internet Information Services (IIS), the web folder may be located at C:\inetpub\wwwroot\RoadwayCharacteristics.

The actual location of the IIS wwwroot directory could differ on your server machine. Use the IIS Management Console to get the location of the IIS wwwroot directory.