{"_id":"56e2f687f1ad030e00e72f80","user":"55eea68fc93e8c17008a109c","version":{"_id":"55e06495a44fae0d002146ad","project":"55e06494a44fae0d002146aa","__v":54,"createdAt":"2015-08-28T13:39:33.907Z","releaseDate":"2015-08-28T13:39:33.907Z","categories":["55e06496a44fae0d002146ae","55e06997a44fae0d002146c2","55e06a6958c5460d0076aa0c","55e06ae66bad670d0081f25c","55e06cc1a44fae0d002146cb","55e06ddda44fae0d002146cd","55e95f261fd7e82300ef359f","55e95fe47fc27b2d00d32cfa","55e96eef358d923700be984d","55e96ef6358d923700be984e","55e96efda7ca823900ad547e","55e96f04a7ca823900ad547f","55e970cc358d923700be9853","55e973f4358d923700be9858","55e973f9a7ca823900ad548c","55e977bf358d923700be985d","55e9780f8b72bb3700b1d5bd","55e97815a7ca823900ad5493","55e9781c358d923700be985f","55e97821461e2a390050f23b","55f963c23bb4bb0d0022d18c","5624c67406e8040d005ed6b2","5624dcf25a86b423009462e8","5625f229d0f87e190014c4ed","5627819fe2ce610d004e3ec8","562781b23a4c6b0d00c4556b","5627837166c62617009d17e2","5627851efcbbc621004ebff1","5627860044c87f0d00fe6491","562e3c6d54a5be0d00070c3e","564c955aae6cb82100dc137a","5652e22abbe7110d00dba748","5652f25523d4262d00b21c58","5652fdad51e4e81900bf2452","5652fdcbb60abb1700bafadc","5654494f65bec717007e0293","565da11a77f0090d005818ff","565f063f413e06170093de18","565f06fb413e06170093de21","56dd6773efaca42900e5f58e","56dd68630c3bb41700b0b037","56dd7d24d5419f170075dfb3","56dd9448c117291700015b60","56dd9454c117291700015b61","577a6f8b9748b80e00ef3f45","577a6f969748b80e00ef3f46","577bba7f6e5f301900fada99","57a9cc8e5b1ace0e00de743f","58aab134c50c33250046b8f8","58aab146aecc3e2500573d4c","58aab1628f862f250076f92e","58aab1938f862f250076f92f","58aab3e5aecc3e2500573d56","58aab3f2aecc3e2500573d57"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55e973f9a7ca823900ad548c","pages":["5625ea78a96b420d00fe102e","5625ea8dd0f87e190014c4e4","5626054ad0f87e190014c50f","564b4587ee12850d00958626","56bb10c57bc138170015f2bf","56e2f687f1ad030e00e72f80"],"project":"55e06494a44fae0d002146aa","__v":6,"version":"55e06495a44fae0d002146ad","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-04T10:35:37.629Z","from_sync":false,"order":4,"slug":"guides-1","title":"guides"},"__v":18,"parentDoc":null,"project":"55e06494a44fae0d002146aa","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-11T16:47:03.232Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"ArcMap 10.1+ Setup\"\n}\n[/block]\nArcMap introduced WMTS support in version 10.1 onwards. This page will demonstrate how to successfully add OS Maps API as a data layer into ArcMap.\n\nThis capability allows content from OS Maps API to be used as a background in ArcMap versions 10.1+. The following step by step instructions describe how to do this:-\n\n1.\tIf you haven’t done so already, sign-up for access to OS Maps to obtain a valid API key.\n2.\tStartup your version of ArcMap.\n3.     Drop down the 'File' menu and chose the options to 'Add Data' and then again 'Add Data'.\n4.\tIn the browsing window that pops up double click the option to 'Add WMTS Server'.\n5.\tIn the 'URL' box add the API URL with the API key appended to the end via the API key parameter.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"API Keys\",\n  \"body\": \"Our API services all provide security through our API keys which are embedded into the call. Your API key is unique to your account and you will have to add this manually. \\n\\ne.g.\\nhttps://api2.ordnancesurvey.co.uk/mapping_api/v1/service/wmts?key=**YOUR_APP_KEY**' \\n\\nWhen adding a layer you may be prompted to provide a username and password. Cancel out of these requests as they are a legacy from previous authentication methods.\"\n}\n[/block]\n6.\tA popup box \"GIS Server Connection\" will appear, asking for a username and password. Click cancel. \n7.\tThere will be a number of different styles to choose from:\n\n    * Leisure\n    * Light\n    * Night\n    * Outdoor\n    * Road\n \nThere is also the choice between the coordinate systems EPSG:27700 (British National Grid) and     EPSG:3857(Web Mercator) for each style. Only EPSG:27700 is supported within ArcMap.\n\n8.\tSelect \"Add\" to add the zoom stack to the data layer. \n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Zooming\",\n  \"body\": \"Currently there is a bug in ArcMap which zooms out to approximately 1:60,000,000 when you initially add the layer. We are currently working with ESRI to resolve this issue.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"10.2.2 Patch\"\n}\n[/block]\nThere is a bug that has been encountered while using OS Maps API in ArcMap 10.2.2 that prevents the user from viewing any layers of a scale greater than 1:1000. As a result of this, two layers of Mastermap Topography are not displayed.\n\nIf you are unsure which ArcGIS products are installed on your local machine, there are various patch finder utilities available which will list all products, hot fixes and patches installed on your local machine.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"ArcMap 10.2.2\",\n  \"body\": \"The patch for the bug can be found here:\\nhttp://support.esri.com/en/downloads/patches-servicepacks/view/productid/160/metaid/2148\"\n}\n[/block]\nThis quick guide will walk you through the implementation of this patch. The patch corrects inconsistencies in the download of tiles for the WMTS service layer in scales greater than 1:1000.\n\n1.\tIf you haven’t done so already, sign-up for access to OS Maps to obtain a valid API key.\n2.\tMake sure you have write access to your AcrGIS installation location.\n3.\tDownload the patch from [here](http://support.esri.com/en/downloads/patches-servicepacks/view/productid/160/metaid/2148) and download the patch.\n4.     Open the MSP by right clicking and run the installation wizard as an administrator.\n5.\tOpen up ArcMap.\n6.\tRemove your WMTS layers and re add it. Once this is done save.","excerpt":"","slug":"os-maps-api-in-arcmap-101","type":"basic","title":"OS Maps API in ArcMap 10.1+"}

OS Maps API in ArcMap 10.1+


[block:api-header] { "type": "basic", "title": "ArcMap 10.1+ Setup" } [/block] ArcMap introduced WMTS support in version 10.1 onwards. This page will demonstrate how to successfully add OS Maps API as a data layer into ArcMap. This capability allows content from OS Maps API to be used as a background in ArcMap versions 10.1+. The following step by step instructions describe how to do this:- 1. If you haven’t done so already, sign-up for access to OS Maps to obtain a valid API key. 2. Startup your version of ArcMap. 3. Drop down the 'File' menu and chose the options to 'Add Data' and then again 'Add Data'. 4. In the browsing window that pops up double click the option to 'Add WMTS Server'. 5. In the 'URL' box add the API URL with the API key appended to the end via the API key parameter. [block:callout] { "type": "info", "title": "API Keys", "body": "Our API services all provide security through our API keys which are embedded into the call. Your API key is unique to your account and you will have to add this manually. \n\ne.g.\nhttps://api2.ordnancesurvey.co.uk/mapping_api/v1/service/wmts?key=**YOUR_APP_KEY**' \n\nWhen adding a layer you may be prompted to provide a username and password. Cancel out of these requests as they are a legacy from previous authentication methods." } [/block] 6. A popup box "GIS Server Connection" will appear, asking for a username and password. Click cancel. 7. There will be a number of different styles to choose from: * Leisure * Light * Night * Outdoor * Road There is also the choice between the coordinate systems EPSG:27700 (British National Grid) and EPSG:3857(Web Mercator) for each style. Only EPSG:27700 is supported within ArcMap. 8. Select "Add" to add the zoom stack to the data layer. [block:callout] { "type": "warning", "title": "Zooming", "body": "Currently there is a bug in ArcMap which zooms out to approximately 1:60,000,000 when you initially add the layer. We are currently working with ESRI to resolve this issue." } [/block] [block:api-header] { "type": "basic", "title": "10.2.2 Patch" } [/block] There is a bug that has been encountered while using OS Maps API in ArcMap 10.2.2 that prevents the user from viewing any layers of a scale greater than 1:1000. As a result of this, two layers of Mastermap Topography are not displayed. If you are unsure which ArcGIS products are installed on your local machine, there are various patch finder utilities available which will list all products, hot fixes and patches installed on your local machine. [block:callout] { "type": "info", "title": "ArcMap 10.2.2", "body": "The patch for the bug can be found here:\nhttp://support.esri.com/en/downloads/patches-servicepacks/view/productid/160/metaid/2148" } [/block] This quick guide will walk you through the implementation of this patch. The patch corrects inconsistencies in the download of tiles for the WMTS service layer in scales greater than 1:1000. 1. If you haven’t done so already, sign-up for access to OS Maps to obtain a valid API key. 2. Make sure you have write access to your AcrGIS installation location. 3. Download the patch from [here](http://support.esri.com/en/downloads/patches-servicepacks/view/productid/160/metaid/2148) and download the patch. 4. Open the MSP by right clicking and run the installation wizard as an administrator. 5. Open up ArcMap. 6. Remove your WMTS layers and re add it. Once this is done save.