As we described in the Overview page Overview of base mapping available via ADS & OS Maps API, you can have access to Ordance Survey’s WMTS Basemaps in different styles directly through the OS Maps API and to the custom OS Maps API basemaps through the Astun Map Services. To configure the available basemaps 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. After you obtain your API key you are ready to configure the OS WMTS basemaps in Studio as described in the following steps. 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 API key in the appropriate places, which we have highlighted below.
In the zip folder that is attached to this guide, you will find several MapSources and a MapFile. The MapSources that have the prefix _direct
are those powered by OS Maps API directly and the MapSources that have the _wmts_ads
prefix are those powered by OS Maps API through the Astun Map Services. For example purposes, we are going to use the MapSource that holds the OS Road style on the GIS server.
From the zip folder
MapSources V6
grab the MapFile calledbase_osmapsapi.map
and place it underE:\iShareData\LIVE\_MapServerConfig\
From the zip folder
MapSources V6
grab the OS Road MapSource calledbase_osmapsapi_road_direct.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:
After the import, you will notice that everything is prefilled for you. All you have to do is add your API key and your organization’s/council’s name in the correct places:
Navigate to the
Details
node and examine theURI
and theWMS URI
fields. You will see three placeholders, two that sayyour-API-key-goes-here
and one that saysyour-organization-goes-here
. Replace those placeholders with your actualAPI
key and the council’s name, and don't forget to save your changes:
Load the Basemap into the profile you want it to display for your users, save and test that the basemap is displaying correctly:
Follow the same procedure