Configuring iShare Maps/GIS to use standard OS Maps API WMTS direct from the OS and WMS (for printing) via ADS
From the zip folder grab the MapFile called
base_osmapsapi.map
and place it underE:\iShareData\LIVE\_MapServerConfig\
From the zip folder grab the OS Road MapSource called
base_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 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
and theWMS URI
fields. TheURI
field is pointing to the OS WMTS endpointhttps://api.os.uk/maps/raster/v1/wmts?key=your-API-key-goes-here
and theWMS URI
is pointing to the WMS Astun Map Services endpointhttps://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 sayyour-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_light_direct.xml
base_osmapsapi_outdoor_direct.xml
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 pathKeep the Matrices section as is
The High DPI option should be disabled. Check out why here Why not to print OS Maps API basemaps in High DPI
Keep the Boundary Settings under Start up as is