{"_id":"57338f81adebd50e005720a6","user":"55fae9d4825d5f19001fa379","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":33,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"__v":79,"category":{"_id":"56ddf6df8a5ae10e008e3926","project":"55faeacad0e22017005b8265","pages":["56ddf8a4a6eb5c170042d72f"],"__v":1,"version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-07T21:47:11.224Z","from_sync":false,"order":19,"slug":"imagery","title":"IDAHO Guide"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-11T20:01:05.969Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"# ANNOUNCEMENT\nIDAHO users: HTTPS is now enabled for idaho.geobigdata.io.\n\nIf you are currently using http://idaho.geobigdata.io, please switch to https://idaho.geobigdata.io.\n\nhttp://idaho.geobigdata.io​ is now deprecated. We will support http for 60 days, but please update to https as soon as possible. The official End of Life (EOL) date is July 2, 2017.\n\nQuestions? Please contact gbdx-support:::at:::digitalglobe.com\n\n\n# IDAHO Course Overview\n\nIn this course, we'll explain the IDAHO image format and the services that use it. \n\nIDAHO is a work in progress. The environment we've provided is for demo purposes only. It's not a full-fledged production environment. If you're a GBDX customer, we invite you to to read our documentation, play around with the IDAHO browser, and try out our APIs and services. We ask that you let us know what you like, what doesn't work for you, and what you want to see more of.\n\nSend your feedback to gbdx-support@digitalglobe.com with IDAHO feedback in the subject line. We look forward to hearing from you.\n\n# What is IDAHO?\nIDAHO is a cloud-based, data storage format designed for high availability and real time access. The IDAHO format is a tile-based imagery format optimized for storage in cloud-based object stores. IDAHO is an acronym for the IPE Data Architecture Highly-available Object-store. \n\n# Why use IDAHO?\nIDAHO images consist of two file types; tiles and metadata files. Converting large footprint satellite imagery into the IDAHO format provides imagery-manipulating algorithms a tile-based access to the imagery. This significantly reduces load time and compute time through parallel processing.\n\n# IDAHO Image Format\n\nIDAHO images have two major components: tiles and metadata files. \n\n## Tiles\n\nIDAHO images are broken up into tiles. Each tile is stored as an image file. The metadata parameters for the tiles are specified in the image.json file.\n\n##Metadata files\nTo see the metadata files that are stored for an IDAHO image, see [IDAHO Metadata Files](doc:idaho-reference). Image profilesand vendor Dataset Identifier are also explained in this section. \n.\n# IDAHO Services\n\nWe offer a set of services that let you access and visualize IDAHO images. \n\nAll services require authentication, using GBDX platform authentication tokens. Please see the [Authentication Course](doc:authentication-course) for help.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Service\",\n    \"h-1\": \"Description\",\n    \"1-0\": \"TMS Service\",\n    \"1-1\": \"This service provides TMS (tiled map service) tiles and metadata for any IDAHO image.\",\n    \"2-0\": \"WMS Service\",\n    \"2-1\": \"This service provides WMS (web map service) images for any IDAHO image.\",\n    \"h-2\": \"API requests\",\n    \"1-2\": \"[GET metadata](doc:get-idaho-metadata-by-file) \\n[GET metadata by filename](doc:get-idaho-metadata-by-filename) \\n[GET a TMS Tile](doc:get-a-tms-tile) \\n[GET a BBox Chip](doc:get-a-bbox-chip) \\n[GET Centroid Chip](doc:get-tms-tile)\",\n    \"3-0\": \"IDAHO Layer QGIS Plugin\",\n    \"3-1\": \"This QGIS plugin lets you visualize IDAHO images served via the TMS service.\",\n    \"2-2\": \"\",\n    \"0-0\": \"Web-based TMS Service\",\n    \"0-1\": \"Our web-based TMS Service lets you search for IDAHO imagery by drawing a search area or searching by a one week date range. The results panel will display each image and its properties, and offers additional controls.\\n\\nGBDX customers, use your GBDX credentials to sign in to the  <a href=\\\"https://idaho.geobigdata.io\\\" target=\\\"_blank\\\">**IDAHO Explorer **</a>. Select the \\\"question mark\\\" icon in the top right for help.\",\n    \"0-2\": \"Not applicable\",\n    \"4-0\": \"IDAHO GDAL Driver\",\n    \"4-1\": \"**COMING SOON**\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n## TMS Service \n\nThis service provides TMS (tiled map service) tiles and metadata for any IDAHO image.\n\n### Resources: \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Resource Name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"TMS metadata\",\n    \"0-1\": \"Get IDAHO TMS metadata information\",\n    \"1-0\": \"TMS tile\",\n    \"1-1\": \"Get a TMS tile\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\n### TMS Service Requests\n[GET metadata](doc:get-idaho-metadata-by-file) \n[GET metadata by filename](doc:get-idaho-metadata-by-filename) \n[GET a TMS Tile](doc:get-a-tms-tile) \n[GET a BBox Chip](doc:get-a-bbox-chip) \n[GET Centroid Chip](doc:get-tms-tile) \n\n\n## WMS Service \n\nThis API provides services for retrieving WMS images for a given IDAHO image. The WMS service conforms to the WMS 1.3.0 specification. The WMS service is not a fully featured WMS service but provides sufficient features to view the IDAHO imagery.\n\nFor the WMS API, the GBDX authentication token is embedded in the URL path.\n\nThe URL path to the WMS service is formed using the bucket name, IDAHO ID,  and the user token in the following form:\n\nhttps://idaho.geobigdata.io/v1/wms/BUCKET_NAME/IDAHO_ID/USER_TOKEN/mapserv\n\n## IDAHO Layers QGIS Plugin\n\nThe IDAHO Layer plugin lets you easily visualize an IDAHO image with QGIS. With the IDAHO Layer Plugin, you can add GBDX IDAHO layers to your map canvas.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/RHLAbGbKQZq9eOdY3cO6_idaholoaded.png\",\n        \"idaholoaded.png\",\n        \"1689\",\n        \"1011\",\n        \"#73a7d0\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n[IDAHO Layer QGIS Plugin](doc:idaho-layers-qgis-plugin)\n\n## Examples\n\n### Leaflet Examples\nThese examples show how to create a Leaflet map using the IDAHO TMS service.\n[Leaflet map html example - basic](doc:leaflet-map-html-example-basic) \n[Leaflet map html example - advanced](doc:leaflet-map-html-example-advanced) \n\n### OpenLayers Examples\nThese examles show how to create an OpenLayers map using the IDAHO TMS service.\n[OpenLayers html example - basic](doc:openlayers-html-example-basic) \n[OpenLayers html example - advanced](doc:openlayers-html-example-advanced)","excerpt":"Overview documentation for IDAHO imagery.","slug":"idaho-course","type":"basic","title":"IDAHO Course"}

IDAHO Course

Overview documentation for IDAHO imagery.

# ANNOUNCEMENT IDAHO users: HTTPS is now enabled for idaho.geobigdata.io. If you are currently using http://idaho.geobigdata.io, please switch to https://idaho.geobigdata.io. http://idaho.geobigdata.io​ is now deprecated. We will support http for 60 days, but please update to https as soon as possible. The official End of Life (EOL) date is July 2, 2017. Questions? Please contact gbdx-support@digitalglobe.com # IDAHO Course Overview In this course, we'll explain the IDAHO image format and the services that use it. IDAHO is a work in progress. The environment we've provided is for demo purposes only. It's not a full-fledged production environment. If you're a GBDX customer, we invite you to to read our documentation, play around with the IDAHO browser, and try out our APIs and services. We ask that you let us know what you like, what doesn't work for you, and what you want to see more of. Send your feedback to gbdx-support@digitalglobe.com with IDAHO feedback in the subject line. We look forward to hearing from you. # What is IDAHO? IDAHO is a cloud-based, data storage format designed for high availability and real time access. The IDAHO format is a tile-based imagery format optimized for storage in cloud-based object stores. IDAHO is an acronym for the IPE Data Architecture Highly-available Object-store. # Why use IDAHO? IDAHO images consist of two file types; tiles and metadata files. Converting large footprint satellite imagery into the IDAHO format provides imagery-manipulating algorithms a tile-based access to the imagery. This significantly reduces load time and compute time through parallel processing. # IDAHO Image Format IDAHO images have two major components: tiles and metadata files. ## Tiles IDAHO images are broken up into tiles. Each tile is stored as an image file. The metadata parameters for the tiles are specified in the image.json file. ##Metadata files To see the metadata files that are stored for an IDAHO image, see [IDAHO Metadata Files](doc:idaho-reference). Image profilesand vendor Dataset Identifier are also explained in this section. . # IDAHO Services We offer a set of services that let you access and visualize IDAHO images. All services require authentication, using GBDX platform authentication tokens. Please see the [Authentication Course](doc:authentication-course) for help. [block:parameters] { "data": { "h-0": "Service", "h-1": "Description", "1-0": "TMS Service", "1-1": "This service provides TMS (tiled map service) tiles and metadata for any IDAHO image.", "2-0": "WMS Service", "2-1": "This service provides WMS (web map service) images for any IDAHO image.", "h-2": "API requests", "1-2": "[GET metadata](doc:get-idaho-metadata-by-file) \n[GET metadata by filename](doc:get-idaho-metadata-by-filename) \n[GET a TMS Tile](doc:get-a-tms-tile) \n[GET a BBox Chip](doc:get-a-bbox-chip) \n[GET Centroid Chip](doc:get-tms-tile)", "3-0": "IDAHO Layer QGIS Plugin", "3-1": "This QGIS plugin lets you visualize IDAHO images served via the TMS service.", "2-2": "", "0-0": "Web-based TMS Service", "0-1": "Our web-based TMS Service lets you search for IDAHO imagery by drawing a search area or searching by a one week date range. The results panel will display each image and its properties, and offers additional controls.\n\nGBDX customers, use your GBDX credentials to sign in to the <a href=\"https://idaho.geobigdata.io\" target=\"_blank\">**IDAHO Explorer **</a>. Select the \"question mark\" icon in the top right for help.", "0-2": "Not applicable", "4-0": "IDAHO GDAL Driver", "4-1": "**COMING SOON**" }, "cols": 2, "rows": 5 } [/block] ## TMS Service This service provides TMS (tiled map service) tiles and metadata for any IDAHO image. ### Resources: [block:parameters] { "data": { "h-0": "Resource Name", "h-1": "Description", "0-0": "TMS metadata", "0-1": "Get IDAHO TMS metadata information", "1-0": "TMS tile", "1-1": "Get a TMS tile" }, "cols": 2, "rows": 2 } [/block] ### TMS Service Requests [GET metadata](doc:get-idaho-metadata-by-file) [GET metadata by filename](doc:get-idaho-metadata-by-filename) [GET a TMS Tile](doc:get-a-tms-tile) [GET a BBox Chip](doc:get-a-bbox-chip) [GET Centroid Chip](doc:get-tms-tile) ## WMS Service This API provides services for retrieving WMS images for a given IDAHO image. The WMS service conforms to the WMS 1.3.0 specification. The WMS service is not a fully featured WMS service but provides sufficient features to view the IDAHO imagery. For the WMS API, the GBDX authentication token is embedded in the URL path. The URL path to the WMS service is formed using the bucket name, IDAHO ID, and the user token in the following form: https://idaho.geobigdata.io/v1/wms/BUCKET_NAME/IDAHO_ID/USER_TOKEN/mapserv ## IDAHO Layers QGIS Plugin The IDAHO Layer plugin lets you easily visualize an IDAHO image with QGIS. With the IDAHO Layer Plugin, you can add GBDX IDAHO layers to your map canvas. [block:image] { "images": [ { "image": [ "https://files.readme.io/RHLAbGbKQZq9eOdY3cO6_idaholoaded.png", "idaholoaded.png", "1689", "1011", "#73a7d0", "" ] } ] } [/block] [IDAHO Layer QGIS Plugin](doc:idaho-layers-qgis-plugin) ## Examples ### Leaflet Examples These examples show how to create a Leaflet map using the IDAHO TMS service. [Leaflet map html example - basic](doc:leaflet-map-html-example-basic) [Leaflet map html example - advanced](doc:leaflet-map-html-example-advanced) ### OpenLayers Examples These examles show how to create an OpenLayers map using the IDAHO TMS service. [OpenLayers html example - basic](doc:openlayers-html-example-basic) [OpenLayers html example - advanced](doc:openlayers-html-example-advanced)