{"_id":"586d8f521c014819000ea666","user":"56d62986b30acf150053be43","__v":0,"project":"56d629f02417921500c46716","version":{"_id":"586d8f511c014819000ea65d","project":"56d629f02417921500c46716","__v":2,"createdAt":"2017-01-05T00:12:01.865Z","releaseDate":"2017-01-05T00:12:01.865Z","categories":["586d8f511c014819000ea65e","586d8f511c014819000ea65f","586d8f511c014819000ea660","586d8f511c014819000ea661","586d8f511c014819000ea662","586d8f511c014819000ea663","586d8f511c014819000ea664","587977f57a58130f00303d4e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"adams","version_clean":"2.0.0","version":"2.0"},"category":{"_id":"586d8f511c014819000ea661","project":"56d629f02417921500c46716","version":"586d8f511c014819000ea65d","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-24T00:14:02.044Z","from_sync":false,"order":4,"slug":"access-tokens","title":"Map Services"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-03-24T20:12:50.237Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/OVPums5TpyUhfMrFYqDN_header-sanfran.png\",\n        \"header-sanfran.png\",\n        \"800\",\n        \"90\",\n        \"#918260\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Choosing the right Tiled Map helps ensure your application is efficient and performant.  \\n\\n  * **TMS** Web, jsgeo, software, mobile, most Esri environments and online portals\\n  * **GL** Primarily WebGL applications\\n  * **WMTS** QGIS, Esri Desktop and other GIS applications\",\n  \"title\": \"Unsure which Tiled Map type you should use?\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Developing with iOS or Android SDK?\",\n  \"body\": \"We recommend following Mapbox [iOS](https://www.mapbox.com/ios-sdk/) and [Android](https://www.mapbox.com/android-sdk/) SDK specifications.  More specifically, we recommend integrating *Custom Raster Styles* method using our [Map ID](doc:map-id)'s, as detailed [here](https://www.mapbox.com/ios-sdk/examples/raster-styles/) for iOS SDK and [here](https://www.mapbox.com/android-sdk/examples/custom-raster/) for Android SDK.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"TMS\"\n}\n[/block]\nMost web maps, jsgeo, software and online portals can read Tiled Map Services (**TMS**) and display many web map tiles together as one image inside the map. DigitalGlobe Maps API **TMS** endpoints are structured accordingly:\n   `https://api.mapbox.com/v4/Map.ID/{z}/{x}/{y}.png?access_token=your-access-token`\n* Specify the content **[Map ID](doc:map-id)** you wish to display, after `/v4/`\n* append your [Access Token](doc:access-tokens) after the `=`\n\nOur **TMS** endpoints deliver `256x256` tiles as standard. If you are working with retina displays, replace `.png` with `:::at:::2x.png` to request `512x512` map tiles.\nExample:\n   `https://api.mapbox.com/v4/digitalglobe.nal0g75k/{z}/{x}/{y}@2x.png?access_token=your-access-token`\n\nWith **TMS**, you can also **mashup multiple layers** into one endpoint simply by adding a `,` after your first [Map ID](doc:map-id) and then placing the second Map ID immediately following, without a space.  \nExample - *Recent Imagery with Transparent Vectors*:\n   `https://api.mapbox.com/v4/digitalglobe.nal0g75k,digitalglobe.nakolk5j/{z}/{x}/{y}.png?access_token=your-access-token` \n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Test our TMS\",\n  \"body\": \"You can test our TMS with your [access token](doc:access-tokens) and a web browser.  Just paste your access token, after the `=` below, into your favorite web browser.\\n`https://api.mapbox.com/v4/digitalglobe.nal0g75k/0/0/0.png?access_token=`\\n\\nYou should see a response that is a single image of the world.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"GL\"\n}\n[/block]\nDigitalGlobe Maps API **GL** Map Services display many web map tiles together as one image inside [WebGL/3D](https://www.khronos.org/webgl/)-enabled applications. Our **GL** endpoints are structured accordingly:\n   `https://api.mapbox.com/styles/v1/digitalglobe/MapStyle/tiles/{z}/{x}/{y}?access_token=`\n* Specify the content **[Map Style](doc:map-styles)** you wish to display\n* append your [Access Token](doc:access-tokens) after the `=`\n\nMost of our **GL** endpoints deliver `512x512` tiles as standard. If you are working with non-retina displays, you can add `256/` before `{z}` to request `256x256` map tiles.\n    `https://api.mapbox.com/styles/v1/digitalglobe/ciode6t5k0081aqm7k06dod4v/tiles/256/{z}/{x}/{y}?access_token=`\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"WMTS\"\n}\n[/block]\nIf you want to add DigitalGlobe Maps API imagery and basemap content to your **Esri,** **QGIS** or other **GIS** applications, our **WMTS** Map Services will display  many web map tiles together as one image inside the map.  DigitalGlobe Maps API **WMTS** endpoints are structured accordingly:\n   `http://api.mapbox.com/styles/v1/digitalglobe/MapStyle/wmts?access_token=`\n* Specify the content **[Map Style](doc:map-styles)** you wish to display\n* append your [Access Token](doc:access-tokens) after the `=`\n\nExample:\n   `https://api.mapbox.com/styles/v1/digitalglobe/ciode6t5k0081aqm7k06dod4v/wmts?access_token=`\n\nOur **WMTS** endpoints deliver `256x256` tiles as standard.\n\n\n \nQuestions? [Ask Them](http://mapsapidocs.digitalglobe.com/discuss) on our Q&A forum.","excerpt":"Tiled Map Services deliver pre-cached map content as web map tiles which can be viewed in all kinds of web, mobile, software and GIS applications. Our Tiled Map Services are hosted by [Mapbox](http://mapbox.com) and deliver:\n\n* 256x256 and 512x512 dimension image tiles\n* [EPSG:3857](https://epsg.io/3857) projection\n* Same tiling scheme as Mapbox, Bing Maps, Esri and Google Maps.\n \nNeed more detail on [how Tile Map Services work](https://www.mapbox.com/help/how-web-maps-work/)?","slug":"tiles","type":"basic","title":"Tiled Maps"}

Tiled Maps

Tiled Map Services deliver pre-cached map content as web map tiles which can be viewed in all kinds of web, mobile, software and GIS applications. Our Tiled Map Services are hosted by [Mapbox](http://mapbox.com) and deliver: * 256x256 and 512x512 dimension image tiles * [EPSG:3857](https://epsg.io/3857) projection * Same tiling scheme as Mapbox, Bing Maps, Esri and Google Maps.   Need more detail on [how Tile Map Services work](https://www.mapbox.com/help/how-web-maps-work/)?

[block:image] { "images": [ { "image": [ "https://files.readme.io/OVPums5TpyUhfMrFYqDN_header-sanfran.png", "header-sanfran.png", "800", "90", "#918260", "" ] } ] } [/block] [block:callout] { "type": "info", "body": "Choosing the right Tiled Map helps ensure your application is efficient and performant. \n\n * **TMS** Web, jsgeo, software, mobile, most Esri environments and online portals\n * **GL** Primarily WebGL applications\n * **WMTS** QGIS, Esri Desktop and other GIS applications", "title": "Unsure which Tiled Map type you should use?" } [/block] [block:callout] { "type": "danger", "title": "Developing with iOS or Android SDK?", "body": "We recommend following Mapbox [iOS](https://www.mapbox.com/ios-sdk/) and [Android](https://www.mapbox.com/android-sdk/) SDK specifications. More specifically, we recommend integrating *Custom Raster Styles* method using our [Map ID](doc:map-id)'s, as detailed [here](https://www.mapbox.com/ios-sdk/examples/raster-styles/) for iOS SDK and [here](https://www.mapbox.com/android-sdk/examples/custom-raster/) for Android SDK." } [/block] [block:api-header] { "type": "basic", "title": "TMS" } [/block] Most web maps, jsgeo, software and online portals can read Tiled Map Services (**TMS**) and display many web map tiles together as one image inside the map. DigitalGlobe Maps API **TMS** endpoints are structured accordingly:    `https://api.mapbox.com/v4/Map.ID/{z}/{x}/{y}.png?access_token=your-access-token` * Specify the content **[Map ID](doc:map-id)** you wish to display, after `/v4/` * append your [Access Token](doc:access-tokens) after the `=` Our **TMS** endpoints deliver `256x256` tiles as standard. If you are working with retina displays, replace `.png` with `@2x.png` to request `512x512` map tiles. Example:    `https://api.mapbox.com/v4/digitalglobe.nal0g75k/{z}/{x}/{y}@2x.png?access_token=your-access-token` With **TMS**, you can also **mashup multiple layers** into one endpoint simply by adding a `,` after your first [Map ID](doc:map-id) and then placing the second Map ID immediately following, without a space. Example - *Recent Imagery with Transparent Vectors*:    `https://api.mapbox.com/v4/digitalglobe.nal0g75k,digitalglobe.nakolk5j/{z}/{x}/{y}.png?access_token=your-access-token` [block:callout] { "type": "success", "title": "Test our TMS", "body": "You can test our TMS with your [access token](doc:access-tokens) and a web browser. Just paste your access token, after the `=` below, into your favorite web browser.\n`https://api.mapbox.com/v4/digitalglobe.nal0g75k/0/0/0.png?access_token=`\n\nYou should see a response that is a single image of the world." } [/block] [block:api-header] { "type": "basic", "title": "GL" } [/block] DigitalGlobe Maps API **GL** Map Services display many web map tiles together as one image inside [WebGL/3D](https://www.khronos.org/webgl/)-enabled applications. Our **GL** endpoints are structured accordingly:    `https://api.mapbox.com/styles/v1/digitalglobe/MapStyle/tiles/{z}/{x}/{y}?access_token=` * Specify the content **[Map Style](doc:map-styles)** you wish to display * append your [Access Token](doc:access-tokens) after the `=` Most of our **GL** endpoints deliver `512x512` tiles as standard. If you are working with non-retina displays, you can add `256/` before `{z}` to request `256x256` map tiles.     `https://api.mapbox.com/styles/v1/digitalglobe/ciode6t5k0081aqm7k06dod4v/tiles/256/{z}/{x}/{y}?access_token=` [block:api-header] { "type": "basic", "title": "WMTS" } [/block] If you want to add DigitalGlobe Maps API imagery and basemap content to your **Esri,** **QGIS** or other **GIS** applications, our **WMTS** Map Services will display many web map tiles together as one image inside the map. DigitalGlobe Maps API **WMTS** endpoints are structured accordingly:    `http://api.mapbox.com/styles/v1/digitalglobe/MapStyle/wmts?access_token=` * Specify the content **[Map Style](doc:map-styles)** you wish to display * append your [Access Token](doc:access-tokens) after the `=` Example:    `https://api.mapbox.com/styles/v1/digitalglobe/ciode6t5k0081aqm7k06dod4v/wmts?access_token=` Our **WMTS** endpoints deliver `256x256` tiles as standard.   Questions? [Ask Them](http://mapsapidocs.digitalglobe.com/discuss) on our Q&A forum.