{"_id":"59e66186fdf13a001a90c77f","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":"595412446ed4d9001b3e7b37","project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-06-28T20:32:04.415Z","from_sync":false,"order":3,"slug":"gbdx-data-sets-in-progress","title":"Data Sets on GBDX"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-17T20:01:10.942Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"# Overview\nLandsat is a joint NASA/USGS program provides the longest continuous space-based record of Earth’s land in existence. Landsat 8 imagery is included in the GBDX catalog, and is available for processing on the GBDX platform.\n\n\n####Spectral Bands\n[block:embed]\n{\n  \"html\": false,\n  \"url\": \"https://landsat.gsfc.nasa.gov/landsat-8/landsat-8-bands/\",\n  \"title\": \"Landsat 8 Bands\",\n  \"favicon\": \"https://landsat.gsfc.nasa.gov/wp-content/uploads/2014/06/icon_32x32.jpg\",\n  \"image\": \"https://landsat.gsfc.nasa.gov/wp-content/uploads/2013/06/truecolor.jpg\"\n}\n[/block]\n####Date Range\n2013 to present\n\nFor more information about LANDSAT-8 imagery on GBDX, see [LANDSAT Data](https://platform.digitalglobe.com/gbdx/data-sets/#landsat8).\n[block:embed]\n{\n  \"html\": false,\n  \"url\": \"https://aws.amazon.com/public-datasets/landsat/\",\n  \"title\": \"Landsat on AWS\",\n  \"favicon\": \"https://a0.awsstatic.com/main/images/site/fav/favicon.ico\",\n  \"image\": \"https://a0.awsstatic.com/main/images/logos/aws_logo_smile_1200x630.png\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/cf72c9a-landsat-8-data-post.jpeg\",\n        \"landsat-8-data-post.jpeg\",\n        879,\n        485,\n        \"#25563e\"\n      ],\n      \"caption\": \"Landsat imagery courtesy of NASA Goddard Space Flight Center and U.S. Geological Survey or USGS/NASA Landsat\"\n    }\n  ]\n}\n[/block]\n# Search \n\nUsing the GBDX Catalog API, search by \"types\" to find LANDSAT-8 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a LANDSAT record. \n\n\n## Catalog V2 API Request\n\nSend a ```POST``` request to ```https://geobigdata.io/catalog/v2/search``` with a request body. \n\nFor gbdxtools, see  <a href=\"http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview\">Catalog Search Overview</a>\n\n## Search Example 1: Search by Types\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" {\\n   \\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\\\",\\n   \\t\\\"startDate\\\": \\\"2015-03-01T00:00:00.000Z\\\",\\n   \\t\\\"endDate\\\": \\\"2016-03-01T23:59:59.999Z\\\",\\n   \\t\\\"types\\\": [\\\"Landsat8\\\"]\\n   }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## Search Result Example \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"stats\\\": {\\n        \\\"recordsReturned\\\": 88,\\n        \\\"totalRecords\\\": 88,\\n        \\\"typeCounts\\\": {\\n            \\\"GBDXCatalogRecord\\\": 88,\\n            \\\"LandsatAcquisition\\\": 88,\\n            \\\"Acquisition\\\": 88,\\n            \\\"Landsat8\\\": 88\\n        }\\n    },\\n    \\\"results\\\": [\\n        {\\n            \\\"identifier\\\": \\\"LC80340332014295LGN00\\\",\\n            \\\"type\\\": [\\n                \\\"GBDXCatalogRecord\\\",\\n                \\\"Acquisition\\\",\\n                \\\"Landsat8\\\",\\n                \\\"LandsatAcquisition\\\"\\n            ],\\n            \\\"properties\\\": {\\n                \\\"vendor\\\": \\\"Landsat\\\",\\n                \\\"browseURL\\\": \\\"https://s3-us-west-2.amazonaws.com/landsat-pds/L8/034/033/LC80340332014295LGN00/LC80340332014295LGN00_thumb_large.jpg\\\",\\n                \\\"timestamp\\\": \\\"2014-10-22T17:44:06.383Z\\\",\\n                \\\"bucketPrefix\\\": \\\"L8/034/033/LC80340332014295LGN00\\\",\\n                \\\"footprintWkt\\\": \\\"MULTIPOLYGON(((-107.61854 37.80661, -107.61854 39.94828, -104.88295 39.94828, -104.88295 37.80661, -107.61854 37.80661)))\\\",\\n                \\\"cloudCover\\\": 42,\\n                \\\"catalogID\\\": \\\"LC80340332014295LGN00\\\",\\n                \\\"bucketName\\\": \\\"landsat-pds\\\",\\n                \\\"path\\\": 34,\\n                \\\"sensorPlatformName\\\": \\\"LANDSAT08\\\",\\n                \\\"multiResolution\\\": 30,\\n                \\\"row\\\": 33,\\n                \\\"platformName\\\": \\\"LANDSAT08\\\",\\n                \\\"panResolution\\\": 15\\n            }\\n        },\\n      truncated results set showing one LANDSAT-8 acquisition\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n# Types\n\nThere are four \"types\" associated with Landsat records. \n\nType | Definition\n--- | ---\nGBDXCatalogRecord | The parent type for all GBDX catalog records\nAcquisition | All Acquisitions\nLandsat8 | All Landsat-8 records\nLandsatAcquisition | All Landsat-8 acquisitions\n\n* The GBDX catalog stores records for all Landsat-8 acquisitions available in the [Landsat public feed on AWS](https://aws.amazon.com/public-datasets/landsat/).\n\n* For LANDSAT, there are no products. All LANDSAT records are cataloged as acquisitions. Searching by type for Landsat8 or LandsatAcqusition will return the same results sets.\n\n\n\n# Catalog ID\nThe Catalog ID is the product ID assigned by the vendor. This is an example of a Landsat-8 catalog ID. Landsat refers to this as a \"scene number\". \n\n```LC80330322014336LGN00```\n\nFor more information, see [Landsat File Naming Convention](http://gisgeography.com/landsat-file-naming-convention/).\n\n# S3 location\nThe s3 location for Landsat data is the bucketName and bucketPrefix.\n\nFor example:\n\nBucket name: landsat-pds\nBucketPrefix: L8/034/033/LC80340332014359LGN0\nS3 location: s3://landsat-pds/L8/034/033/LC80340332014359LGN0","excerpt":"","slug":"landsat-8","type":"basic","title":"LANDSAT-8"}
# Overview Landsat is a joint NASA/USGS program provides the longest continuous space-based record of Earth’s land in existence. Landsat 8 imagery is included in the GBDX catalog, and is available for processing on the GBDX platform. ####Spectral Bands [block:embed] { "html": false, "url": "https://landsat.gsfc.nasa.gov/landsat-8/landsat-8-bands/", "title": "Landsat 8 Bands", "favicon": "https://landsat.gsfc.nasa.gov/wp-content/uploads/2014/06/icon_32x32.jpg", "image": "https://landsat.gsfc.nasa.gov/wp-content/uploads/2013/06/truecolor.jpg" } [/block] ####Date Range 2013 to present For more information about LANDSAT-8 imagery on GBDX, see [LANDSAT Data](https://platform.digitalglobe.com/gbdx/data-sets/#landsat8). [block:embed] { "html": false, "url": "https://aws.amazon.com/public-datasets/landsat/", "title": "Landsat on AWS", "favicon": "https://a0.awsstatic.com/main/images/site/fav/favicon.ico", "image": "https://a0.awsstatic.com/main/images/logos/aws_logo_smile_1200x630.png" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/cf72c9a-landsat-8-data-post.jpeg", "landsat-8-data-post.jpeg", 879, 485, "#25563e" ], "caption": "Landsat imagery courtesy of NASA Goddard Space Flight Center and U.S. Geological Survey or USGS/NASA Landsat" } ] } [/block] # Search Using the GBDX Catalog API, search by "types" to find LANDSAT-8 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a LANDSAT record. ## Catalog V2 API Request Send a ```POST``` request to ```https://geobigdata.io/catalog/v2/search``` with a request body. For gbdxtools, see <a href="http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview">Catalog Search Overview</a> ## Search Example 1: Search by Types [block:code] { "codes": [ { "code": " {\n \t\"searchAreaWkt\": \"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\",\n \t\"startDate\": \"2015-03-01T00:00:00.000Z\",\n \t\"endDate\": \"2016-03-01T23:59:59.999Z\",\n \t\"types\": [\"Landsat8\"]\n }", "language": "json" } ] } [/block] ## Search Result Example [block:code] { "codes": [ { "code": "{\n \"stats\": {\n \"recordsReturned\": 88,\n \"totalRecords\": 88,\n \"typeCounts\": {\n \"GBDXCatalogRecord\": 88,\n \"LandsatAcquisition\": 88,\n \"Acquisition\": 88,\n \"Landsat8\": 88\n }\n },\n \"results\": [\n {\n \"identifier\": \"LC80340332014295LGN00\",\n \"type\": [\n \"GBDXCatalogRecord\",\n \"Acquisition\",\n \"Landsat8\",\n \"LandsatAcquisition\"\n ],\n \"properties\": {\n \"vendor\": \"Landsat\",\n \"browseURL\": \"https://s3-us-west-2.amazonaws.com/landsat-pds/L8/034/033/LC80340332014295LGN00/LC80340332014295LGN00_thumb_large.jpg\",\n \"timestamp\": \"2014-10-22T17:44:06.383Z\",\n \"bucketPrefix\": \"L8/034/033/LC80340332014295LGN00\",\n \"footprintWkt\": \"MULTIPOLYGON(((-107.61854 37.80661, -107.61854 39.94828, -104.88295 39.94828, -104.88295 37.80661, -107.61854 37.80661)))\",\n \"cloudCover\": 42,\n \"catalogID\": \"LC80340332014295LGN00\",\n \"bucketName\": \"landsat-pds\",\n \"path\": 34,\n \"sensorPlatformName\": \"LANDSAT08\",\n \"multiResolution\": 30,\n \"row\": 33,\n \"platformName\": \"LANDSAT08\",\n \"panResolution\": 15\n }\n },\n truncated results set showing one LANDSAT-8 acquisition", "language": "json" } ] } [/block] # Types There are four "types" associated with Landsat records. Type | Definition --- | --- GBDXCatalogRecord | The parent type for all GBDX catalog records Acquisition | All Acquisitions Landsat8 | All Landsat-8 records LandsatAcquisition | All Landsat-8 acquisitions * The GBDX catalog stores records for all Landsat-8 acquisitions available in the [Landsat public feed on AWS](https://aws.amazon.com/public-datasets/landsat/). * For LANDSAT, there are no products. All LANDSAT records are cataloged as acquisitions. Searching by type for Landsat8 or LandsatAcqusition will return the same results sets. # Catalog ID The Catalog ID is the product ID assigned by the vendor. This is an example of a Landsat-8 catalog ID. Landsat refers to this as a "scene number". ```LC80330322014336LGN00``` For more information, see [Landsat File Naming Convention](http://gisgeography.com/landsat-file-naming-convention/). # S3 location The s3 location for Landsat data is the bucketName and bucketPrefix. For example: Bucket name: landsat-pds BucketPrefix: L8/034/033/LC80340332014359LGN0 S3 location: s3://landsat-pds/L8/034/033/LC80340332014359LGN0