{"_id":"58a5f712243dd30f00fd872d","category":{"_id":"58c81b5c6dc7140f003c3c46","__v":0,"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-03-14T16:33:32.348Z","from_sync":false,"order":5,"slug":"catalog-v2-guide","title":"Catalog V2 API Guide (New!)"},"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"},"parentDoc":null,"project":"55faeacad0e22017005b8265","user":"55fae9d4825d5f19001fa379","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-02-16T19:01:38.895Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"post","results":{"codes":[{"name":"","code":"{\n\t\"stats\": {\n\t\t\"recordsReturned\": 2,\n\t\t\"totalRecords\": 2,\n\t\t\"typeCounts\": {\n\t\t\t\"GBDXCatalogRecord\": 2,\n\t\t\t\"DigitalGlobeAcquisition\": 2,\n\t\t\t\"Acquisition\": 2,\n\t\t\t\"WV03_VNIR\": 2\n\t\t}\n\t},\n\t\"results\": [{\n\t\t\"identifier\": \"1040010029122000\",\n\t\t\"type\": [\n\t\t\t\"GBDXCatalogRecord\",\n\t\t\t\"Acquisition\",\n\t\t\t\"DigitalGlobeAcquisition\",\n\t\t\t\"WV03_VNIR\"\n\t\t],\n\t\t\"properties\": {\n\t\t\t\"bearing\": null,\n\t\t\t\"offNadirAngle_min\": 24.384682,\n\t\t\t\"offNadirAngle_start\": 27.307268,\n\t\t\t\"targetAzimuth_min\": 50.065426,\n\t\t\t\"multiResolution_min\": 1.4636024,\n\t\t\t\"cloudCover\": 0,\n\t\t\t\"sunAzimuth_max\": 165.70734,\n\t\t\t\"targetAzimuth\": 62.89924,\n\t\t\t\"multiResolution\": 1.4845809,\n\t\t\t\"catalogID\": \"1040010029122000\",\n\t\t\t\"panResolution_max\": 0.38099897,\n\t\t\t\"timestamp\": \"2017-02-12T19:32:44.000Z\",\n\t\t\t\"sunAzimuth_min\": 164.13196,\n\t\t\t\"browseURL\": \"https://geobigdata.io/thumbnails/v1/browse/1040010029122000.large.png\",\n\t\t\t\"targetAzimuth_max\": 76.27552,\n\t\t\t\"sunAzimuth\": 164.862,\n\t\t\t\"sunElevation_min\": 37.63985,\n\t\t\t\"offNadirAngle\": 25.381517,\n\t\t\t\"stereoPair\": null,\n\t\t\t\"platformName\": \"WORLDVIEW03_VNIR\",\n\t\t\t\"multiResolution_start\": 1.5244182,\n\t\t\t\"sunElevation\": 37.772,\n\t\t\t\"vendor\": \"DigitalGlobe\",\n\t\t\t\"scanDirection\": \"Reverse\",\n\t\t\t\"panResolution_end\": 0.36568117,\n\t\t\t\"panResolution_start\": 0.38099897,\n\t\t\t\"targetAzimuth_end\": 50.065426,\n\t\t\t\"panResolution_min\": 0.36568117,\n\t\t\t\"offNadirAngle_max\": 27.307268,\n\t\t\t\"multiResolution_end\": 1.4636024,\n\t\t\t\"multiResolution_max\": 1.5244182,\n\t\t\t\"sunElevation_max\": 37.91937,\n\t\t\t\"offNadirAngle_end\": 24.384682,\n\t\t\t\"panResolution\": 0.37088415,\n\t\t\t\"footprintWkt\": \"MULTIPOLYGON(((-121.1934767 37.7653955, -121.206815 37.62916906, -121.2529824 37.62953655, -121.2990735 37.62988607, -121.3448702 37.6302092, -121.3905498 37.6305018, -121.4364234 37.63072169, -121.4816279 37.63097667, -121.5265638 37.63128138, -121.5721427 37.63139424, -121.6175478 37.63146601, -121.6614027 37.6318972, -121.7046229 37.63243222, -121.7484866 37.63275506, -121.792149 37.63311735, -121.836571 37.63316243, -121.879175 37.63374235, -121.9243014 37.63343112, -121.9677336 37.63362407, -122.009993 37.63419316, -122.0517588 37.63492541, -122.0945785 37.63521744, -122.1373448 37.63546512, -122.1800286 37.635682, -122.2225843 37.63589689, -122.2650595 37.63610221, -122.3074288 37.63631069, -122.3496868 37.63652225, -122.391847 37.63670561, -122.4340693 37.63678634, -122.4764719 37.63670133, -122.5176373 37.63725328, -122.5592826 37.63741509, -122.5376038 37.77551776, -122.4966544 37.7749553, -122.4550341 37.77449698, -122.4128849 37.77430428, -122.3709193 37.77395281, -122.3289146 37.77356975, -122.2868117 37.77317458, -122.2446108 37.7727926, -122.2023761 37.77239443, -122.1605139 37.77178657, -122.1184669 37.77123655, -122.0759903 37.77084203, -122.0332705 37.77050103, -121.9901356 37.77030076, -121.9472035 37.76996523, -121.9040527 37.76966572, -121.8610476 37.76925949, -121.8180245 37.76884084, -121.7746266 37.76852165, -121.7310791 37.76818753, -121.6872587 37.76792714, -121.6428198 37.76782139, -121.5982098 37.76768046, -121.5536687 37.7674828, -121.5091113 37.76723029, -121.464549 37.76695229, -121.4198344 37.76671684, -121.3748812 37.76644974, -121.3298568 37.76618478, -121.2846419 37.76592338, -121.2391216 37.76565515, -121.1934767 37.7653955)))\",\n\t\t\t\"targetAzimuth_start\": 76.27552,\n\t\t\t\"imageBands\": \"PAN_MS1_MS2\",\n\t\t\t\"sensorPlatformName\": \"WORLDVIEW03_VNIR\"\n\t\t}\n\t}, {\n\t\t\"identifier\": \"1040010028531E00\",\n\t\t\"type\": [\n\t\t\t\"GBDXCatalogRecord\",\n\t\t\t\"Acquisition\",\n\t\t\t\"DigitalGlobeAcquisition\",\n\t\t\t\"WV03_VNIR\"\n\t\t],\n\t\t\"properties\": {\n\t\t\t\"bearing\": 90.4808912781491,\n\t\t\t\"offNadirAngle_min\": 23.532337,\n\t\t\t\"offNadirAngle_start\": 23.532337,\n\t\t\t\"targetAzimuth_min\": 19.996199,\n\t\t\t\"multiResolution_min\": 1.4422108,\n\t\t\t\"cloudCover\": 27,\n\t\t\t\"sunAzimuth_max\": 165.16954,\n\t\t\t\"targetAzimuth\": 33.152676,\n\t\t\t\"multiResolution\": 1.4703125,\n\t\t\t\"catalogID\": \"1040010028531E00\",\n\t\t\t\"panResolution_max\": 0.37804878,\n\t\t\t\"timestamp\": \"2017-01-24T19:26:36.000Z\",\n\t\t\t\"sunAzimuth_min\": 165.16954,\n\t\t\t\"browseURL\": \"https://geobigdata.io/thumbnails/v1/browse/1040010028531E00.large.png\",\n\t\t\t\"targetAzimuth_max\": 48.26697,\n\t\t\t\"sunAzimuth\": 165.16954,\n\t\t\t\"sunElevation_min\": 32.10846,\n\t\t\t\"offNadirAngle\": 24.724756,\n\t\t\t\"stereoPair\": null,\n\t\t\t\"platformName\": \"WORLDVIEW03_VNIR\",\n\t\t\t\"multiResolution_start\": 1.4422108,\n\t\t\t\"sunElevation\": 32.10846,\n\t\t\t\"vendor\": \"DigitalGlobe\",\n\t\t\t\"scanDirection\": \"Reverse\",\n\t\t\t\"panResolution_end\": 0.37804878,\n\t\t\t\"panResolution_start\": 0.36059642,\n\t\t\t\"targetAzimuth_end\": 19.996199,\n\t\t\t\"panResolution_min\": 0.36059642,\n\t\t\t\"offNadirAngle_max\": 26.634436,\n\t\t\t\"multiResolution_end\": 1.5125052,\n\t\t\t\"multiResolution_max\": 1.5125052,\n\t\t\t\"sunElevation_max\": 32.10846,\n\t\t\t\"offNadirAngle_end\": 26.634436,\n\t\t\t\"panResolution\": 0.36746687,\n\t\t\t\"footprintWkt\": \"MULTIPOLYGON(((-121.1903983 37.76645921, -121.2103061 37.62933927, -121.2513493 37.62948312, -121.2923356 37.62954912, -121.3332412 37.62962635, -121.3740742 37.62969291, -121.415125 37.62952177, -121.4564287 37.62909181, -121.4964274 37.62970406, -121.5372112 37.62957351, -121.5780407 37.62932193, -121.6192313 37.62870476, -121.6592606 37.62909948, -121.6989945 37.62974854, -121.7393017 37.62983537, -121.7793408 37.63018271, -121.8198784 37.62994878, -121.8597817 37.63036894, -121.9003939 37.62996809, -121.9409151 37.62960398, -121.9811401 37.62955461, -122.0206172 37.63045131, -122.0602101 37.63120775, -122.1003777 37.63123843, -122.1405139 37.63128209, -122.1806721 37.63129599, -122.220832 37.63130331, -122.2609773 37.63132194, -122.3011397 37.63132813, -122.3413159 37.63132479, -122.3814848 37.63131132, -122.4217315 37.63119967, -122.4623677 37.63037754, -122.5020925 37.63128568, -122.5423157 37.6312564, -122.5538629 37.63124383, -122.5365134 37.78326331, -122.5251015 37.78309747, -122.4847611 37.78227626, -122.4444109 37.78151937, -122.4038335 37.78124676, -122.363408 37.7807307, -122.3230527 37.78015701, -122.2827015 37.77958069, -122.2423665 37.77901725, -122.2021596 37.77829131, -122.1621959 37.77721576, -122.1219868 37.77656007, -122.0817995 37.77590787, -122.0416274 37.77523418, -122.0012906 37.77482971, -121.9607629 37.77464589, -121.9205319 37.77407728, -121.8805076 37.77325784, -121.840255 37.77270797, -121.7999685 37.77220046, -121.7599383 37.77139156, -121.7194837 37.77102446, -121.6787701 37.77091745, -121.6380832 37.77076961, -121.5973775 37.77058132, -121.5567439 37.77027312, -121.5161515 37.76992577, -121.4755799 37.7695106, -121.4349688 37.76904831, -121.3943408 37.76860197, -121.353657 37.76818638, -121.3129446 37.76775108, -121.272176 37.76731167, -121.2313289 37.7669062, -121.1903983 37.76645921)))\",\n\t\t\t\"targetAzimuth_start\": 48.26697,\n\t\t\t\"imageBands\": \"PAN_MS1_MS2\",\n\t\t\t\"sensorPlatformName\": \"WORLDVIEW03_VNIR\"\n\t\t}\n\t}\n ]\n}","language":"json","status":200},{"status":400,"name":"","code":"{\n  \"status\": \"404 Not Found\",\n  \"message\": \"Not Found\"\n}","language":"json"},{"language":"json","status":401,"code":"{\n  \"status\": \"401 Unauthorized\", \n  \"message\": \"Authentication Failed.\"\n}"}]},"settings":"56143e6a1a8caf0d00689482","examples":{"codes":[{"language":"json","name":"","code":"  {\n\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\"types\": [\n  \t\t\"Acquisition\"\n  \t],\n  \t\"startDate\": null,\n  \t\"endDate\": null,\n  \t\"limit\": 2\n\n  }"}]},"auth":"required","params":[],"url":"/catalog/v2/search"},"isReference":false,"order":2,"body":"This is an example of a spatial area search. This search would return all records over Denver. FOr this example, the search results were limited to two records. See [Catalog V2 API Course](doc:catalog-v2-course) for more information. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"You need a token to try this request.\",\n  \"body\": \"For more information, see the Authentication Guide.\"\n}\n[/block]","excerpt":"Search the Catalog by spatial area.","slug":"catalog-v2-search-by-spatial-area","type":"endpoint","title":"Catalog V2 Search by Spatial Area"}

postCatalog V2 Search by Spatial Area

Search the Catalog by spatial area.

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format


Documentation

This is an example of a spatial area search. This search would return all records over Denver. FOr this example, the search results were limited to two records. See [Catalog V2 API Course](doc:catalog-v2-course) for more information. [block:callout] { "type": "info", "title": "You need a token to try this request.", "body": "For more information, see the Authentication Guide." } [/block]

User Information

Try It Out


post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}