/
Configuring iShare Maps/GIS to use standard OS Maps API WMTS direct from the OS and WMS (for printing) via ADS

Configuring iShare Maps/GIS to use standard OS Maps API WMTS direct from the OS and WMS (for printing) via ADS

Please note that if you want to use the OS Maps API WMTS service directly from Ordance Survey, you will need to create separate keys for each domain of your sites to avoid a caching issue that OS currently produces when the WMTS GetCapabilities document is been requested. For example, you will need:

  • One API key for your LIVE Maps site

  • One API key for your TEST Maps site

  • One API key for your LIVE GIS site

  • One API key for your TEST GIS site

The same applies if you are using workspaces or if you have a Welsh and an English version of the sites.

  1. From the zip folder grab the MapFile called base_osmapsapi.map and place it under E:\iShareData\LIVE\_MapServerConfig\

  2. From the zip folder grab the OS Road MapSource called base_osmapsapi_road_direct.xml and place it under D:\Astun\iShareGIS\LIVE\WebApps\WebService\config\mapsources

  3. After placing the files into the correct destinations, open Studio and import the MapSource under the BaseMaps node:

    1. Right-click on the BaseMaps node and select Import MapSource

      mstsc_VBm2djSnzQ.png

       

    2. 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:

      mstsc_7aFfFqyTed.png
      mstsc_gvDHiyX8AM.png

       

  4. 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:

    1. Navigate to the Details node and examine the URI and the WMS URI fields. The URI field is pointing to the OS WMTS endpoint https://api.os.uk/maps/raster/v1/wmts?key=your-API-key-goes-here and the WMS URI is pointing to the WMS Astun Map Services endpoint https://map.services.astuntechnology.com/your-organisation-goes-here/osmaps/service?key=your-API-key-goes-here to enable the printing functionality. In those URIs, you will see three placeholders, two that say your-API-key-goes-here and one that says your-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.

      mstsc_oCdq2jZmT0.png

  5. Add the base map to a MyMaps MapSource, save and test that the base map is displaying correctly:

    mstsc_KBfrfCiAMr.png

     

    chrome_ah04CvpTL8.png

     

  6. Follow the same procedure for the rest of the direct basemap MapSources:

    1. base_osmapsapi_light_direct.xml

    2. base_osmapsapi_outdoor_direct.xml

Please note the below:

  • In the base_osmapsapi.map we have configured a file path for the MS_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 the MS_ERRORFILE with the correct path

  • Keep the Matrices section as is

  • The High DPI option should be disabled. Check out why here Astun Data Services - Frequently Asked Questions (FAQs)

  • Keep the Boundary Settings under Start up as is