Wavepoint 1.4 – Configuration Guide

Configure Custom Basemaps (optional)

Including all Bing basemaps or all ArcGIS Online basemaps might not be preferable for your business. You have the option of configuring a subset of one or the other, both, or to provide your own fully custom basemap with such a subset.

Considerations while Building a Custom Basemap

Before starting the process of creating a custom basemap, consider these requirements:

  • You are allowed one projection for all basemaps. In other words, different basemaps cannot have different projections.

    • ArcGIS Online, Bing Maps, and Google Maps use WGS Web Mercator as their projection. Thus, if you intend to make these available to your users, then your custom basemap must also use WGS Web Mercator.

    • If your custom basemap uses a projection other than WGS Web Mercator, you must deactivate basemaps provided by ArcGIS Online, Bing Maps, Google Maps and any other services that do not match your projection.

  • Esri has retired support for raster tile basemaps. Thus, you may not include them in a custom basemap. Instead, you can include Esri ’s vector tile basemaps.

  • You must use cached tile services. It cannot draw dynamically from the data.

  • By default, the maximum zoom scale provided by the tiling scheme is 1:1,128. Most likely, your users need to zoom in beyond that. The easiest way to provide lower levels is to import the tiling scheme from an ArcGIS Online layer, then append additional scales.

  • If you want a feature to be visible at a certain scale, ensure it is actually turned on and visible at that scale in the published service. In other words, if you publish a service while buildings are turned off, they are not visible in the resulting service regardless of scale.

    IMPORTANT: For performance reasons, do not make all features visible at all scales. The actual tiles in the scheme become quite small and voluminous at very close scales. If your intent is to allow users to zoom in very close on the map (for example, to read a cross-section annotation), consider having a custom basemap for that exact purpose with only a few features turned on at that zoom level.

Create a Custom Basemap

Adding a custom basemap is a great way to help your users get the most out of Wavepoint . You have the opportunity to add specific features, control zoom levels, and make the map more recognizable and relatable for field crew.
  1. In ArcMap, add the features to include in the basemap.
  2. Set symbology and scale visibility for all features, as needed.
  3. Click File > Share As > Service to start the process.
  4. Click Publish a service, then click Next.
  5. Choose or establish your server connection, then click Next.
  6. Use an existing folder or create a new one, then click Continue. Notice the Service Editor dialog opens.
  7. In the Service Editor dialog, set Capabilities:
    1. The only required capability for a basemap is Mapping.

    2. Uncheck KML, if necessary.
    3. In the left-hand pane, click Mapping.
    4. The only Mapping operation required is Map.

  8. In the left-hand pane, click Caching.
  9. For Draw this map service, choose Using tiles from a cache.

  10. If a maximum scale level of 1:1,128 is acceptable, you can simply use the tiling scheme from ArcGIS Online/Bing Maps/Google Maps.

  11. To append additional zoom scales:
    1. Change the Tiling Scheme to An existing cached map/image service.

    2. In the Load Tiling Scheme dialog, connect to ArcGIS Online, load an existing scheme such as World_Street_Map, then click Add.

      TIP: If you have never connected to ArcGIS Online before, you first need to add the URL. Under GIS Servers, click Add ArcGIS Server. Then, choose Use GIS Services, and use the Server URL https://services.arcgisonline.com/arcgis/rest/services
    3. In the left-hand pane, click Advanced Settings.
    4. Type in a desired scale, then click Add. Repeat as needed.

      TIP: Do not worry about the initial Disk Space displayed. These caches are large, but not that large. For example, in the image above, the scale of 1:500 displays a Disk Space of 7.22 TB. To see the actual disk space, the easiest way is in the left-hand pane, click Caching, then click back on Advanced Settings. This refreshes the dialog, and you can then see the actual Disk Space calculated.
    5. While here, you can also delete scales that you do not need. There are likely some “continent-wide” scales that are not that beneficial for users.
  12. Proceed through the remaining steps to Publish the service.
    IMPORTANT:

    Publishing this tile cache produces a warning about size.

    Click OK to ignore the warning and proceed to publish.

  13. It takes some time to cache the tile service. To check the progress:
    1. In ArcCatalog navigate to your new basemap.
    2. Right-click the basemap name and choose View Cache Status

    3. Refresh the Cache Status dialog to see the current progress.

    4. When the Summary is at 100% present, the process is finished.
  14. Once the tiling cache is complete, you can add the custom basemap to the Web.config file. Continue to the next section to complete this step.

basemap.x

In the Web.config, use this key to specify custom basemaps. The x in basemap.x can be anything you want as long as it is unique among each basemap.x entry in the Web.config.

The Web.config provides an example that is commented out by default. Copy this example, populate the information below, then un-comment it to activate the basemap.

Each basemap.x key contains the following five elements:

  • title: In the Select your basemap window in Wavepoint , this required element controls the label beneath the basemap thumbnail image.

  • url: This is only for custom basemaps. For custom basemaps, this specifies the location of the basemap service. To find the URL:

    1. Sign into ArcGIS Server Manager.

    2. On the Service pane, click your map service.

    3. Under Capabilities, copy the Rest URL.

  • type: For Bing basemaps, this value specifies the basemap. For ArcGIS and Image Service basemaps, you must specify the type and a key. For custom basemaps, you can leave this empty.

    • Bing basemap types:

      • BingMapsRoad

      • BingMapsAerial

      • BingMapsHybrid

    • ArcGIS Tiled Service basemap type:

      • ArcGISTiledMapServiceLayer

    • ArcGIS Image Service basemap type:

      • ArcGISImageServiceLayer

    • Vector Tile Service basemap type:

      • VectorTileLayer

  • key: This is required for all ArcGIS Online basemaps. Leave it blank for Bing basemaps. For each custom basemap, make this value a unique identifier, such as a GUID, that is also unique to this configuration file. This identifier is not the same as the object GUID listed in the basemap service. Also, ensure the value you designate isn't a duplicate of any of the keys listed below.

    ArcGIS Online basemap keys:

    Imagery

    86de95d4e0244cba80f0fa2c9403a7b2

    Imagery with labels

    413fd05bbd7342f5991d5ec96f4f8b18

    Light Gray Canvas

    8b3b470883a744aeb60e5fff0a319ce7

    National Geographic

    509e2d6b034246d692a461724ae2d62c

    Oceans

    48b8cec7ebf04b5fbdcaf70d09daff21

    Streets

    d8855ee4d3d74413babfb0f41203b168

    Terrain with Labels

    aab054ab883c4a4094c72e949566ad40

    Topographic

    6e03e8c26aad4b9c92a87c1063ddb0e3

  • thumbnail: In the Select your basemap window in Wavepoint , this is the URL that controls the basemap's thumbnail image. This is not required for any type of basemap. Bing provides its own thumbnail. For custom basemaps, you may leave this empty or provide your own URL, perhaps from your company’s image directory. If you do not provide a thumbnail URL, the application uses a default icon instead.

Example: 

<add key="basemap.1" value="{title:'My Streets', url:'', type:'BingMapsRoad', key:'', thumbnail:''}" />
<add key="basemap.2" value="{title:'Hybrid', url:'', type:'BingMapsHybrid', key:'', thumbnail:''}" />
<add key="basemap.3" value="{title:'Parcels and Buildings', url:'https://server.domain.com:6080/arcgis/rest/services/WavepointBasemap/MapServer',
   type:'', key:'GUID#', thumbnail:'https://exampleutilitycompany.com/parcel77x33.png'}" />


After saving the Web.config, open Wavepoint to test your new basemap.

Examples

Display a particular Bing basemap 

<add key="basemap.1" value="{title:'Bing Roads', url:'', type:'BingMapsRoad', key:'', thumbnail:''}"/>

Display a particular ArcGIS Online basemap 

<add key="basemap.2" value="{title:'Light Gray', url:'https://services.arcgisonline.com/arcgis/rest/services/Canvas/World_Light_Gray_Base/MapServer', type:'', key:'8b3b470883a744aeb60e5fff0a319ce7', thumbnail:''}" />

Display OpenStreetMap 

<add key="basemap.3" value="{title:'Open Street Map', url:'', type:'OpenStreetMap', key:'', thumbnail:''}"/>

Display a custom basemap that uses an ArcGIS Server Image Service 

<add key="basemap.4" value="{title:'YOUR_TITLE', url:'https://YOUR_ARCGIS_SERVER/arcgis/rest/services/YOUR_IMAGE_SERVICE/ImageServer', type:'ArcGISImageServiceLayer', key:'1234567', thumbnail:'https://YourThumbnail.png'}" />
IMPORTANT: Using the type parameter (type=’ArcGISImageServiceLayer’) is imperative for this to succeed.

Display a custom basemap 

<add key="basemap.5" value="{title:'Custom', url:'https://My URL/MapServer', type:'', key:'123456789', thumbnail:''https://MyURL/thumbnail.png'}"/>
QR Code is a registered trademark of DENSO WAVE INCORPORATED in Japan and other countries.

Was this helpful?

Contact Information
Legal Information
Privacy Policy
Change your cookie settings