Configuring iShare v5.8 to use the new base mapping services
Users on iShare v5.8 are eligible to use only the custom OS Maps API WMS base maps via ADS as iShare v5.8 does not support WMTS and OS Maps API is currently available only via WMTS.
To configure the available base maps in iShare (either Maps or GIS) you need to first obtain an API key from OS Data Hub. You can see how to do so here: How to create a Project and generate an API key in OS Data Hub.
Once you have your API key
You are now ready to configure the custom OS WMS base maps in Studio as described below. Please note that the process is the same whether you use Maps or GIS.
To make this process smoother for you we have already prepared the MapSources and a basic Mapfile ready to be loaded into iShare. All you need to do is place the MapSources and the corresponding MapFile in the correct directories, import the MapSources into Studio, and enter your customer name and API key in the appropriate places, which we have highlighted in the guide.
In the zip folder that is attached to this guide, you will find several MapSources and a Mapfile. Below you will find detailed steps on how to set up an OS Maps API WMS base map via the Astun Data Services as well as the zip folder at the end of the page.
Please notice that if you are using an earlier version of iShare than 5.8 you will need to add an & after your API key in the URI see step 4a
Steps
From the zip folder grab the MapFile called
base_osmapsapi.map
and place it underE:\iShareData\LIVE\_MapServerConfig\
From the zip folder
MapSources v5_8
grab the OS Road MapSource calledbase_osmapsapi_road_wms.xml
and place it underD:\Astun\iShareGIS\LIVE\WebApps\WebService\config\mapsources
After placing the files into the correct destinations, open Studio and import the MapSource under the
BaseMaps
node:Right-click on the
BaseMaps
node and selectImport MapSource
Â
Navigate to the directory in which you placed the OS Road MapSource, open it, and give it an appropriate name such as OS Road in Studio:
Â
After the import, you will notice that everything is prefilled for you. All you have to do is add your API key and your organisation's name in the correct places:
Navigate to the
Details
node and examine theURI
field. TheURI
field is pointing to the WMS Astun Data Services endpointhttps://map.services.astuntechnology.com/your-organisation-goes-here/osmaps/service?key=your-API-key-goes-here
. In the URI, you will see two placeholders, one that saysyour-API-key-goes-here
and one that saysyour-organization-goes-here
. Replace those placeholders with your alpha-numeric OS Data Hub Project API Key and organisation name, and don't forget to save your changes. If you are unsure of your organisation name, please contact us via support.
Add the base map to a MyMaps MapSource, save and test that the base map is displaying correctly:
Â
Follow the same procedure for the rest of the direct basemap MapSources:
base_osmapsapi_leisure_25k_wms.xml
base_osmapsapi_leisure_50k_wms.xml
base_osmapsapi_leisure_grayscale_wms.xml
base_osmapsapi_leisure_wms.xml
base_osmapsapi_light_grayscale_wms.xml
base_osmapsapi_light_wms.xml
base_osmapsapi_outdoor_grayscale_wms.xml
base_osmapsapi_outdoor_wms.xml
base_osmapsapi_road_grayscale_wms.xml
MapSources available here:
Please note the below:
In the
base_osmapsapi.map
we have configured a file path for theMS_ERRORFILE
parameter that is mostly common across installations. However, there is a possibility that you have a different file path configured for your MapServer logs. If you do please update theMS_ERRORFILE
with the correct pathLeave the Scales section unchanged.
The High DPI option should be disabled for all the base maps except the OS Leisure 50k & 25k. Check out why here Astun Data Services - Frequently Asked Questions (FAQs)
Keep the Boundary Settings under Start up as is.
Â
Â
Â