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 stepsguides. 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 MapSourcesand 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 belowin the guides.
In the zip folder that is attached to the end of 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 called base_osmapsapi.map and place it under E:\iShareData\LIVE\_MapServerConfig\
...
From the zip folder MapSources V6 grab the OS Road MapSource called base_osmapsapi_road_direct.xml and place it under D:\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
BaseMapsnode 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
Detailsnode and examine theURIand theWMS URIfields. You will see three placeholders, two that sayyour-API-key-goes-hereand one that saysyour-organization-goes-here. Replace those placeholders with your actualAPIkey 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:
...
...
Below you will find two pages guiding you through how to set up the Basemaps via OS and the Basemaps via the Astun Map Services.