{"_id":"5ade3efa4ff9f300030748c5","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":36,"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","59e76ce41938310028037295","5a009de510890d001c2aabfe","5a96f89c89442e002041144b"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"category":{"_id":"561d588d8ca8b90d00210219","project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":7,"pages":["561d58cc8ca8b90d0021021a","561d58ea071cd60d000d3202","561d58f88ca8b90d0021021c","564e30acc475e017007ffb43","564e3524e964972100508e6a","564e37deae07512b00a87ddc","564e3a08c475e017007ffb58"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T19:16:29.547Z","from_sync":false,"order":15,"slug":"thumbnail-service-guide","title":"Thumbnail Service Guide (Deprecated)"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-04-23T20:15:54.826Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"# Summary\nGBDX Thumbnail Service users should migrate to DigitalGlobe's Discover API before the retirement date. All GBDX catalog records will be updated with Discover image paths once the Thumbnail Service is retired. Until then, the Thumbnail urls in the catalog records will redirect to the Discover API. \n\n\n# Deprecated API Requests\n\nAPI Request | URL\n--- | ---\nBrowse Mode | https://geobigdata.io/thumbnails/v1/browse/catid.dim.png\nMetadata Mode | https://geobigdata.io/thumbnails/v1/metadata/:catid.json\nJSON Mode | https://geobigdata.io/thumbnails/v1/get/:catid.:dim.png\nThumbnail Mode | https://geobigdata.io/thumbnails/v1/thumbnail/catid/dim?orientation=\n\n# Migration Instructions\n\n## DigitalGlobe's Discover API\nThe [Discover API's Reference Guide](https://discoverdigitalglobe.readme.io/v1.7/reference) provides cURL and Python examples for the following requests:\n\nRequest | Description\n--- | ---\n[Query the DigitalGlobe Image Catalog API](https://discoverdigitalglobe.readme.io/v1.7/reference#testinput) |  Search for imagery based on a specified set of search criteria. The ID and metadata associated with the image are returned in the JSON response body.\n[Export Catalog Browse Images](https://discoverdigitalglobe.readme.io/v1.7/reference#browse-image-request) | Export imagery based on a bounding box. Specify size, format, and other criteria. \n[Request Single Browse Image](https://discoverdigitalglobe.readme.io/v1.7/reference#request-single-browse-image) | Request a single browse image by catalog ID. \n\n## Request a Browse Image from the  DigitalGlobe Image Catalog API\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl --request GET \\\\\\n  --url https://api.discover.digitalglobe.com/show?id=10400100395C1100&f=jpeg\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\n### Query Parameters\n\nPARAM | Type | Description\n--- | --- | ---\nid | string | The DigitalGlobe identifier for the image. This is also the catalog ID for an acquisition.\nf | string | The output format for the image. Specify jpeg or png. If no value is specified for \"f\", the default is jpeg. \n\n### Example Returned Image\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/bc9fd6f-thumbnail_image_jpeg_example.jpeg\",\n        \"thumbnail image jpeg example.jpeg\",\n        1170,\n        936,\n        \"#474d44\"\n      ],\n      \"caption\": \"Example browse image in jpeg format\"\n    }\n  ]\n}\n[/block]\n## DigitalGlobe's Discover Web Application\n\nUse the DigitalGlobe Discover Application to search for DigitalGlobe satellite imagery. Draw an Area of Interest, and select imagery to download or share by email. The \"share by email\" feature sends the requested imagery files, along with the information provided in this example:\n\n[discover.digitalglobe.com](https://discover.digitalglobe.com/)\n\n```\nOrder Description: AOI 1\nCatalog IDs: 1030010079969600, 10300100612DE400, 1050010006396C00\nArea of Interest Size: 0 Km2\n```\n\n# Deprecation Schedule\nSee the [Deprecation Schedule](doc:deprecation-schedule) for all deprecated GBDX services and resources. \n\n# Contact Us\nContact [GBDX Support](mailto:gbdx-support:::at:::digitalglobe.com) if you have questions or need assistance.\n\nFor updates, follow us on [Twitter](https://twitter.com/GBDXReleaseLog) and subscribe to this incident on the [GBDX Status Page](http://status.geobigdata.io/incidents/n3g6wkkrc57j).","excerpt":"The GBDX Thumbnail Service has been deprecated and is scheduled for retirement.  This document provides resources for migrating to DigitalGlobe's Discover API. \n\n\n**Deprecation Date:** 05/23/2018\n**Retirement Date (end-of-life):** 07/23/2018\n**Document last updated:** 5/22/2018","slug":"thumbnail-service-deprecation-notice","type":"basic","title":"GBDX Thumbnail Service Deprecation Notice"}

GBDX Thumbnail Service Deprecation Notice

The GBDX Thumbnail Service has been deprecated and is scheduled for retirement. This document provides resources for migrating to DigitalGlobe's Discover API. **Deprecation Date:** 05/23/2018 **Retirement Date (end-of-life):** 07/23/2018 **Document last updated:** 5/22/2018

# Summary GBDX Thumbnail Service users should migrate to DigitalGlobe's Discover API before the retirement date. All GBDX catalog records will be updated with Discover image paths once the Thumbnail Service is retired. Until then, the Thumbnail urls in the catalog records will redirect to the Discover API. # Deprecated API Requests API Request | URL --- | --- Browse Mode | https://geobigdata.io/thumbnails/v1/browse/catid.dim.png Metadata Mode | https://geobigdata.io/thumbnails/v1/metadata/:catid.json JSON Mode | https://geobigdata.io/thumbnails/v1/get/:catid.:dim.png Thumbnail Mode | https://geobigdata.io/thumbnails/v1/thumbnail/catid/dim?orientation= # Migration Instructions ## DigitalGlobe's Discover API The [Discover API's Reference Guide](https://discoverdigitalglobe.readme.io/v1.7/reference) provides cURL and Python examples for the following requests: Request | Description --- | --- [Query the DigitalGlobe Image Catalog API](https://discoverdigitalglobe.readme.io/v1.7/reference#testinput) | Search for imagery based on a specified set of search criteria. The ID and metadata associated with the image are returned in the JSON response body. [Export Catalog Browse Images](https://discoverdigitalglobe.readme.io/v1.7/reference#browse-image-request) | Export imagery based on a bounding box. Specify size, format, and other criteria. [Request Single Browse Image](https://discoverdigitalglobe.readme.io/v1.7/reference#request-single-browse-image) | Request a single browse image by catalog ID. ## Request a Browse Image from the DigitalGlobe Image Catalog API [block:code] { "codes": [ { "code": "curl --request GET \\\n --url https://api.discover.digitalglobe.com/show?id=10400100395C1100&f=jpeg", "language": "curl" } ] } [/block] ### Query Parameters PARAM | Type | Description --- | --- | --- id | string | The DigitalGlobe identifier for the image. This is also the catalog ID for an acquisition. f | string | The output format for the image. Specify jpeg or png. If no value is specified for "f", the default is jpeg. ### Example Returned Image [block:image] { "images": [ { "image": [ "https://files.readme.io/bc9fd6f-thumbnail_image_jpeg_example.jpeg", "thumbnail image jpeg example.jpeg", 1170, 936, "#474d44" ], "caption": "Example browse image in jpeg format" } ] } [/block] ## DigitalGlobe's Discover Web Application Use the DigitalGlobe Discover Application to search for DigitalGlobe satellite imagery. Draw an Area of Interest, and select imagery to download or share by email. The "share by email" feature sends the requested imagery files, along with the information provided in this example: [discover.digitalglobe.com](https://discover.digitalglobe.com/) ``` Order Description: AOI 1 Catalog IDs: 1030010079969600, 10300100612DE400, 1050010006396C00 Area of Interest Size: 0 Km2 ``` # Deprecation Schedule See the [Deprecation Schedule](doc:deprecation-schedule) for all deprecated GBDX services and resources. # Contact Us Contact [GBDX Support](mailto:gbdx-support@digitalglobe.com) if you have questions or need assistance. For updates, follow us on [Twitter](https://twitter.com/GBDXReleaseLog) and subscribe to this incident on the [GBDX Status Page](http://status.geobigdata.io/incidents/n3g6wkkrc57j).