ROKMAPS™ R1 Configuration Instructions

To successfully configure ROKMAPS™, you must know the well-known REST URL endpoint from the ArcGIS© for Server REST Services Directory for the following:

1. Dynamic Map Service(s) (Required)
2. Printing Geoprocessing Service (Required)
3. Geometry Service (Required)
4. Tiled (Cached ) Map Service(s) (Optional)
5. Feature Layer Service(s) (Optional)

You will need to become familiar with the ArcGIS for Server Rest directory in order to access the services that you publish. If you are already familiar with ArcGIS for Server please proceed to the numbered list under "ROKMAPS™ Map Service Setup" below.

Working with the ArcGIS for Server REST Directory

For ArcGIS for Server, the default endpoint is formatted as follows:

https://<host>/<site>/rest/services/<folder>/<serviceName>/<serviceType>
where:

https://<host> is the ArcGIS for Server host name.
and

/<site> is the site name. (The default value is /arcgis).
ArcGIS for Server accepts a site name specified in a URL as lowercase (arcgis) or camel case (ArcGIS). Using an all lowercase site name is the recommended option.

rest/services indicates the REST services endpoint. You'll see a list of all services in the root directory along with any folders. This part of the URL is case sensitive and should be specified in all lowercase.

/<folder>: When the URL endpoint is a folder, you'll see a list of all services included in this folder. Folder names are case sensitive and should be specified in the case as it was created.
/<serviceName>/<serviceType> represents the name of the service and its type (for example, PopulationDensity/MapServer).
The service name is case sensitive and should be specified in the case it was created. The service type should always be specified in a mixed case format as defined for each service in the REST API reference (for example, MapServer, GeocodeServer, GPServer).

ROKMAPS™ Map Service Setup

1. Dynamic Map Services (Required)

ROKMAPS™ has the ability to consume up to four map services. The map service defines various application parameters such as field aliases and layer symbology. The map service is also used to draw mapping data dynamically and to query data.

An example of a map service URL:

https://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Census_USA/MapServer

Additional Help from Esri - https://server.arcgis.com/en/server/latest/get-started/windows/tutorial-publishing-a-map-service.htm

1. Any of the services can be used to create a total of 3 configurable searches--based on 3 different layers, with unlimited fields to search by for each.
2. All of the layers in the dynamic services will be available for searching in the Query Builder.
3. All of the layers in the dynamic services will be available for selecting using an Active Layer drop down.

2. A Printing Geoprocessing Service (Required)

Specify an ArcGIS for Server print template to be used in GoMaps to create map exports in various layouts and formats. You can also create custom print templates. The print service must be set up as a Synchronous Execution Type. An example REST URL for a Printing Geoprocessing Service is below:

https://sampleserver6.arcgisonline.com/arcgis/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task

3. A Geometry Service (Required)

GoMaps requires a Geometry Service as it has many measurement and geometric functions. You may need to go into your ArcGIS for Server manager or access ArcGIS for Server through ArcCatalog in order to start the Geometry Service if it is not running. The Geometry Service URL looks similar to your Dynamic Map Service URL.

An example of a map service URL:

https://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer

*Note - Make sure to use a Geometry Service from your own ArcGIS for Server and not the example above.

4. Tiled (Cached ) Map Service for Aerial Photography or other data

You may choose to enter the REST URL for a tiled map service. This service can contain any data you choose to put in an mxd and publish to ArcGIS for Server creating cache. One common dataset to create a tiled (cached) map service for is aerial photography. The service can be used as Basemap or can be added to the layerlist. The tiled (cached) map service cannot be a dynamic map service, the data frame needs to be in WGS 1984 Web Mercator Aux. Sphere, and the tiling scheme must match Esri's standard tiling scheme. See steps below from Esri for directions:

1. Open your source map document in ArcMap and set your data frame coordinate system to WGS 1984 Web Mercator. You don't have to re-project the source data, although this can make the cache load and run faster within the application. Some people even create a one-way replica of their geodatabase in the WGS 1984 Web Mercator coordinate system and use that replica just for caching.
   
   
2. Publish a map service.
   
   
3. Open the Service Properties and click the Caching tab. Choose to draw the map service using tiles from a cache you will define below.
   
   
4. Click Load tiling scheme from and select Google Maps / Microsoft Virtual Earth. Once the scales load, do not add or remove scales or change the tile size.
   
   

An example of a tiled (cached) map service URL:

https://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/

Additional Help from Esri - https://server.arcgis.com/en/server/latest/get-started/windows/tutorial-creating-a-cached-map-service.htm

5. Feature Layer Services

ROKMAPS™ has the ability to consume layers from a feature service. The feature service allows the user to query data and display the results in an infowindow. Make sure to include the LayerID in the URL input box as well as the Feature Service Layer ID input.

An example of a feature service URL:

https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/Landscape_Trees/FeatureServer/0