Searching for Imagery
Albedo's catalog API provides several ways to search our offline archive and online library. We strive to make it fast and easy to find our imagery and imagery assets through the following API operations:
- Get Item using an image ID
- Search using geometry: point, bounding box
Note: We've omitted the authorization information from these urls. Please refer to our API Documentation to see fully functional examples that include authorization information.
Get Item By imageId
imageIdOnce the order has been successfully collected, the Retrieve a Tasking Order response should include an imageId, similar to the response below (truncated for brevity):
{
"id": "760",
"aoi": "POLYGON ((-86.94236658277757 21.230097788365455, -86.77757166090257 21.230097788365455, -86.77757166090257 21.086658056680328, -86.94236658277757 21.086658056680328, -86.94236658277757 21.230097788365455))",
"status": "COLLECTED",
"images": [
{
"imag_id": "484677",
"extent": "POLYGON ((-75.173297 39.92081, -75.173297 39.920718, -75.173297 39.920626, -75.173296 39.920534, -75.173296 39.920442, -75.173296 39.920349, -75.173295 39.920257, -75.173295 39.920165, -75.173295 39.920073, -75.173295 39.919981, -75.173294 39.919889, -75.173294 39.919796, -75.173294 39.919704, -75.173293 39.919612, -75.173293 39.91952, -75.173293 39.919428, -75.173292 39.919335, -75.173292 39.919243, -75.173292 39.919151, -75.173292 39.919059, -75.173291 39.918967, -75.173291 39.918875, -75.173291 39.918782, -75.17329 39.91869, -75.17329 39.918598, -75.17329 39.918506, -75.17329 39.918414, -75.173289 39.918322, -75.173289 39.91823, -75.173289 39.918137, -75.173288 39.918045, -75.173288 39.917953, -75.173288 39.917861, -75.173288 39.917769, -75.173287 39.917677, -75.173287 39.917584, -75.173287 39.917492, -75.173286 39.9174, -75.173286 39.917308, -75.173286 39.917216, -75.173286 39.917124, -75.173285 39.917031, -75.173285 39.916939, -75.173285 39.916847, -75.173284 39.916755, -75.173284 39.916663, -75.173284 39.916571, -75.173284 39.916479, -75.173283 39.916386, -75.173283 39.916294, -75.173283 39.916202, -75.173282 39.91611, -75.173282 39.916018, -75.173282 39.915926, -75.173282 39.915834, -75.173281 39.915742, -75.173281 39.91565, -75.173281 39.915557, -75.173281 39.915465, -75.17328 39.915373, -75.17328 39.915281, -75.17328 39.915189, -75.173279 39.915097, -75.173279 39.915005, -75.173279 39.914913, -75.173279 39.914821, -75.173278 39.914729, -75.173278 39.914636, -75.173278 39.914544, -75.173277 39.914452, -75.173277 39.91436, -75.173277 39.914268, -75.173277 39.914176, -75.173276 39.914084, -75.173276 39.913992, -75.173276 39.9139, -75.173276 39.913808, -75.173275 39.913716, -75.173275 39.913624, -75.173275 39.913531, -75.173274 39.913439, -75.173274 39.913347, -75.173274 39.913255, -75.173274 39.913163, -75.173273 39.913071, -75.173273 39.912979, -75.173273 39.912887, -75.173272 39.912795, -75.173272 39.912703, -75.173272 39.912611, -75.173272 39.912519, -75.173271 39.912427, -75.173271 39.912335, -75.173271 39.912242, -75.173271 39.91215, -75.17327 39.912058, -75.17327 39.911966, -75.17327 39.911874, -75.173269 39.911782, -75.173269 39.91169, -75.173269 39.911598, -75.173269 39.911506, -75.173268 39.911414, -75.173268 39.911322, -75.173268 39.91123, -75.173268 39.911138, -75.173267 39.911046, -75.173267 39.910954, -75.173267 39.910862, -75.173266 39.91077, -75.173266 39.910678, -75.173266 39.910586, -75.173266 39.910494, -75.173265 39.910402, -75.173265 39.91031, -75.173265 39.910218, -75.173265 39.910126, -75.173264 39.910034, -75.173264 39.909942, -75.173264 39.909849, -75.173264 39.909757, -75.173263 39.909665, -75.173263 39.909573, -75.173263 39.909481, -75.173262 39.909389, -75.173262 39.909297, -75.173262 39.909205, -75.173262 39.909113, -75.173261 39.909021, -75.173261 39.908929, -75.173261 39.908837, -75.173261 39.908745, -75.17326 39.908653, -75.17326 39.908561, -75.17326 39.908469, -75.17326 39.908377, -75.173259 39.908285, -75.173259 39.908193, -75.173259 39.908101, -75.173258 39.908009, -75.173258 39.907917, -75.173258 39.907825, -75.173258 39.907733, -75.173257 39.907641, -75.173257 39.907549, -75.173257 39.907457, -75.173257 39.907365, -75.173256 39.907273, -75.173256 39.907181, -75.173256 39.907089, -75.173256 39.906997, -75.173255 39.906905, -75.173255 39.906813, -75.173255 39.906721, -75.173255 39.906629, -75.173254 39.906537, -75.173254 39.906445, -75.173254 39.906353, -75.173253 39.906261, -75.173253 39.906169, -75.173253 39.906077, -75.173253 39.905985, -75.173252 39.905893, -75.173252 39.905801, -75.173252 39.905709, -75.173252 39.905617, -75.173251 39.905525, -75.173251 39.905433, -75.173251 39.905341, -75.173251 39.905249, -75.17325 39.905157, -75.17325 39.905065, -75.17325 39.904973, -75.17325 39.904881, -75.173249 39.904789, -75.173249 39.904697, -75.173249 39.904605, -75.173249 39.904513, -75.173248 39.904421, -75.173248 39.904329, -75.173248 39.904237, -75.173248 39.904145, -75.173247 39.904053, -75.173247 39.903961, -75.173247 39.903869, -75.173247 39.903777, -75.173246 39.903685, -75.173246 39.903593, -75.173246 39.903501, -75.173245 39.903409, -75.173245 39.903317, -75.173245 39.903225, -75.173245 39.903133, -75.173244 39.903041, -75.173244 39.902949, -75.173244 39.902857, -75.173244 39.902765, -75.173243 39.902673, -75.173243 39.902581, -75.173243 39.902489, -75.173243 39.902397, -75.173242 39.902305, -75.173242 39.902213, -75.173242 39.902121, -75.173242 39.902029, -75.173241 39.901937, -75.173241 39.901845, -75.173241 39.901753, -75.173241 39.901661, -75.17324 39.901569, -75.17324 39.901477, -75.17324 39.901385, -75.17324 39.901293, -75.173239 39.901201, -75.173239 39.901109, -75.173239 39.901017, -75.173239 39.900925, -75.173238 39.900833, -75.173238 39.900741, -75.173238 39.900649, -75.173238 39.900557, -75.173237 39.900465, -75.173237 39.900373, -75.173237 39.900281, -75.173237 39.900189, -75.173236 39.900097, -75.173236 39.900005, -75.173236 39.899913, -75.173236 39.899821, -75.173235 39.899729, -75.173235 39.899637, -75.173235 39.899545, -75.173235 39.899453, -75.173235 39.899361, -75.173234 39.899269, -75.173234 39.899177, -75.173234 39.899085, -75.173234 39.898993, -75.173233 39.898901, -75.173233 39.898809, -75.173233 39.898717, -75.173233 39.898625, -75.173232 39.898533, -75.173232 39.898441, -75.173232 39.898349, -75.173232 39.898257, -75.173231 39.898165, -75.173231 39.898073, -75.173231 39.897981, -75.173231 39.897889, -75.17323 39.897797, -75.17323 39.897705, -75.17323 39.897613, -75.17323 39.897521, -75.173229 39.897429, -75.173229 39.897337, -75.173229 39.897245, -75.173229 39.897153, -75.173228 39.897061, -75.173228 39.896969, -75.173228 39.896877, -75.173228 39.896785, -75.173227 39.896693, -75.173227 39.896601, -75.173227 39.896509, -75.173227 39.896417, -75.173227 39.896325, -75.173226 39.896233, -75.173226 39.896141, -75.173226 39.896049, -75.173226 39.895957, -75.173225 39.895865, -75.173225 39.895773, -75.173225 39.895681, -75.173225 39.895589, -75.173224 39.895497, -75.173224 39.895405, -75.173224 39.895313, -75.173224 39.895221, -75.173223 39.895129, -75.173223 39.895037, -75.173223 39.894945, -75.173223 39.894853, -75.173222 39.894761, -75.173222 39.894669, -75.173222 39.894577, -75.173222 39.894485, -75.173222 39.894393, -75.173221 39.894301, -75.173221 39.894209, -75.173221 39.894117, -75.173221 39.894025, -75.17322 39.893933, -75.17322 39.893841, -75.17322 39.893749, -75.17322 39.893657, -75.173219 39.893565, -75.173219 39.893473, -75.173219 39.893381, -75.173219 39.893289, -75.173219 39.893197, -75.173218 39.893105, -75.173218 39.893013, -75.173218 39.892921, -75.173218 39.892829, -75.173217 39.892737, -75.173217 39.892645, -75.173217 39.892553, -75.173217 39.892461, -75.173216 39.892369, -75.173216 39.892277, -75.173216 39.892185, -75.173216 39.892093, -75.173216 39.892001, -75.173215 39.891909, -75.173215 39.891817, -75.173215 39.891725, -75.173215 39.891633, -75.173214 39.89154, -75.173214 39.891448, -75.173214 39.891357, -75.173214 39.891264, -75.173213 39.891172, -75.173213 39.89108, -75.173213 39.890988, -75.173213 39.890896, -75.173213 39.890804, -75.173212 39.890712, -75.173212 39.89062, -75.173212 39.890528, -75.173212 39.890436, -75.173211 39.890344, -75.173211 39.890252, -75.173211 39.89016, -75.173211 39.890068, -75.173211 39.889976, -75.17321 39.889884, -75.17321 39.889792, -75.17321 39.8897, -75.17321 39.889608, -75.173209 39.889516, -75.173209 39.889424, -75.173209 39.889332, -75.173209 39.88924, -75.173209 39.889148, -75.173208 39.889056, -75.173208 39.888964, -75.173208 39.888872, -75.173208 39.88878, -75.173207 39.888687, -75.173207 39.888595, -75.173207 39.888503, -75.173207 39.888411, -75.173207 39.888319, -75.173206 39.888227, -75.173206 39.888135, -75.173206 39.888043, -75.173206 39.887951, -75.173205 39.887859, -75.173205 39.887767, -75.173205 39.887675, -75.173205 39.887583, -75.173205 39.887491, -75.173204 39.887399, -75.173204 39.887307, -75.173204 39.887215, -75.173204 39.887123, -75.173203 39.887031, -75.173203 39.886939, -75.173203 39.886846, -75.173203 39.886754, -75.173203 39.886662, -75.173202 39.88657, -75.173202 39.886478, -75.173202 39.886386, -75.173202 39.886294, -75.173201 39.886202, -75.173201 39.88611, -75.173201 39.886018, -75.173201 39.885926, -75.173201 39.885834, -75.1732 39.885742, -75.1732 39.88565, -75.1732 39.885557, -75.1732 39.885465, -75.1732 39.885373, -75.173199 39.885281, -75.173199 39.885189, -75.173199 39.885097, -75.173199 39.885005, -75.173198 39.884913, -75.173198 39.884821, -75.173198 39.884729, -75.173198 39.884637, -75.173198 39.8846, -75.173078 39.8846, -75.172958 39.8846, -75.172839 39.8846, -75.172719 39.884601, -75.172599 39.884601, -75.17248 39.884601, -75.17236 39.884601, -75.17224 39.884602, -75.172121 39.884602, -75.172001 39.884602, -75.171881 39.884602, -75.171762 39.884602, -75.171642 39.884603, -75.171522 39.884603, -75.171403 39.884603, -75.171283 39.884603, -75.171163 39.884604, -75.171043 39.884604, -75.170924 39.884604, -75.170804 39.884604, -75.170684 39.884604, -75.170565 39.884605, -75.170445 39.884605, -75.170325 39.884605, -75.170206 39.884605, -75.170086 39.884605, -75.169966 39.884606, -75.169847 39.884606, -75.169727 39.884606, -75.169607 39.884606, -75.169488 39.884607, -75.169368 39.884607, -75.169248 39.884607, -75.169129 39.884607, -75.169009 39.884607, -75.168889 39.884608, -75.16877 39.884608, -75.16865 39.884608, -75.16853 39.884608, -75.168411 39.884608, -75.168291 39.884609, -75.168171 39.884609, -75.168051 39.884609, -75.167932 39.884609, -75.167812 39.88461, -75.167692 39.88461, -75.167573 39.88461, -75.167453 39.88461, -75.167333 39.88461, -75.167214 39.884611, -75.167094 39.884611, -75.166974 39.884611, -75.166855 39.884611, -75.166735 39.884611, -75.166615 39.884612, -75.166496 39.884612, -75.166376 39.884612, -75.166256 39.884612, -75.166137 39.884613, -75.166017 39.884613, -75.165897 39.884613, -75.165778 39.884613, -75.165658 39.884613, -75.165538 39.884614, -75.165419 39.884614, -75.165299 39.884614, -75.165179 39.884614, -75.16506 39.884614, -75.16494 39.884615, -75.16482 39.884615, -75.164701 39.884615, -75.164581 39.884615, -75.164461 39.884615, -75.164342 39.884616, -75.164222 39.884616, -75.164102 39.884616, -75.163983 39.884616, -75.163863 39.884616, -75.163743 39.884617, -75.163624 39.884617, -75.163504 39.884617, -75.163384 39.884617, -75.163265 39.884618, -75.163145 39.884618, -75.163025 39.884618, -75.162906 39.884618, -75.162786 39.884618, -75.162666 39.884619, -75.162547 39.884619, -75.162427 39.884619, -75.162307 39.884619, -75.162187 39.884619, -75.162068 39.88462, -75.161948 39.88462, -75.161828 39.88462, -75.161709 39.88462, -75.161589 39.88462, -75.161469 39.884621, -75.16135 39.884621, -75.16123 39.884621, -75.16111 39.884621, -75.160991 39.884621, -75.160871 39.884622, -75.160751 39.884622, -75.160632 39.884622, -75.160512 39.884622, -75.160392 39.884623, -75.160273 39.884623, -75.160153 39.884623, -75.160033 39.884623, -75.159914 39.884623, -75.159794 39.884624, -75.159674 39.884624, -75.159555 39.884624, -75.159435 39.884624, -75.159315 39.884624, -75.159196 39.884625, -75.159076 39.884625, -75.158956 39.884625, -75.158838 39.884625, -75.158838 39.884717, -75.158839 39.884809, -75.158839 39.884901, -75.158839 39.884993, -75.158839 39.885085, -75.15884 39.885177, -75.15884 39.885269, -75.15884 39.885361, -75.158841 39.885453, -75.158841 39.885545, -75.158841 39.885638, -75.158841 39.88573, -75.158842 39.885822, -75.158842 39.885914, -75.158842 39.886006, -75.158843 39.886098, -75.158843 39.88619, -75.158843 39.886282, -75.158843 39.886374, -75.158844 39.886466, -75.158844 39.886558, -75.158844 39.88665, -75.158845 39.886742, -75.158845 39.886834, -75.158845 39.886926, -75.158845 39.887018, -75.158846 39.88711, -75.158846 39.887202, -75.158846 39.887294, -75.158846 39.887386, -75.158847 39.887478, -75.158847 39.88757, -75.158847 39.887662, -75.158848 39.887754, -75.158848 39.887846, -75.158848 39.887938, -75.158848 39.88803, -75.158849 39.888122, -75.158849 39.888214, -75.158849 39.888306, -75.158849 39.888398, -75.15885 39.88849, -75.15885 39.888582, -75.15885 39.888674, -75.158851 39.888766, -75.158851 39.888858, -75.158851 39.88895, -75.158851 39.889042, -75.158852 39.889134, -75.158852 39.889226, -75.158852 39.889318, -75.158852 39.88941, -75.158853 39.889502, -75.158853 39.889594, -75.158853 39.889686, -75.158854 39.889778, -75.158854 39.88987, -75.158854 39.889962, -75.158854 39.890054, -75.158855 39.890146, -75.158855 39.890238, -75.158855 39.89033, -75.158855 39.890422, -75.158856 39.890514, -75.158856 39.890606, -75.158856 39.890698, -75.158856 39.89079, -75.158857 39.890882, -75.158857 39.890974, -75.158857 39.891066, -75.158858 39.891158, -75.158858 39.89125, -75.158858 39.891342, -75.158858 39.891434, -75.158859 39.891526, -75.158859 39.891618, -75.158859 39.89171, -75.158859 39.891802, -75.15886 39.891894, -75.15886 39.891986, -75.15886 39.892078, -75.15886 39.89217, -75.158861 39.892262, -75.158861 39.892354, -75.158861 39.892446, -75.158862 39.892538, -75.158862 39.89263, -75.158862 39.892722, -75.158862 39.892814, -75.158863 39.892906, -75.158863 39.892998, -75.158863 39.89309, -75.158863 39.893182, -75.158864 39.893274, -75.158864 39.893366, -75.158864 39.893458, -75.158864 39.89355, -75.158865 39.893642, -75.158865 39.893734, -75.158865 39.893826, -75.158865 39.893918, -75.158866 39.89401, -75.158866 39.894102, -75.158866 39.894194, -75.158866 39.894286, -75.158867 39.894378, -75.158867 39.89447, -75.158867 39.894562, -75.158867 39.894654, -75.158868 39.894746, -75.158868 39.894838, -75.158868 39.89493, -75.158868 39.895021, -75.158869 39.895113, -75.158869 39.895205, -75.158869 39.895297, -75.158869 39.895389, -75.15887 39.895481, -75.15887 39.895573, -75.15887 39.895665, -75.15887 39.895758, -75.158871 39.89585, -75.158871 39.895942, -75.158871 39.896034, -75.158871 39.896126, -75.158872 39.896218, -75.158872 39.89631, -75.158872 39.896401, -75.158872 39.896493, -75.158873 39.896585, -75.158873 39.896677, -75.158873 39.896769, -75.158873 39.896861, -75.158874 39.896953, -75.158874 39.897045, -75.158874 39.897137, -75.158874 39.897229, -75.158875 39.897321, -75.158875 39.897413, -75.158875 39.897505, -75.158875 39.897597, -75.158876 39.897689, -75.158876 39.897781, -75.158876 39.897873, -75.158876 39.897965, -75.158877 39.898057, -75.158877 39.898149, -75.158877 39.898241, -75.158877 39.898333, -75.158878 39.898425, -75.158878 39.898517, -75.158878 39.898609, -75.158878 39.898701, -75.158879 39.898793, -75.158879 39.898885, -75.158879 39.898977, -75.158879 39.899069, -75.15888 39.899161, -75.15888 39.899253, -75.15888 39.899345, -75.15888 39.899437, -75.15888 39.899529, -75.158881 39.899621, -75.158881 39.899712, -75.158881 39.899804, -75.158881 39.899896, -75.158882 39.899988, -75.158882 39.90008, -75.158882 39.900172, -75.158882 39.900264, -75.158883 39.900356, -75.158883 39.900448, -75.158883 39.900541, -75.158883 39.900633, -75.158884 39.900725, -75.158884 39.900816, -75.158884 39.900909, -75.158884 39.901, -75.158885 39.901093, -75.158885 39.901185, -75.158885 39.901277, -75.158885 39.901369, -75.158885 39.90146, -75.158886 39.901552, -75.158886 39.901644, -75.158886 39.901736, -75.158886 39.901828, -75.158887 39.901921, -75.158887 39.902012, -75.158887 39.902105, -75.158887 39.902197, -75.158888 39.902289, -75.158888 39.902381, -75.158888 39.902473, -75.158888 39.902565, -75.158888 39.902657, -75.158889 39.902749, -75.158889 39.902841, -75.158889 39.902933, -75.158889 39.903024, -75.15889 39.903117, -75.15889 39.903209, -75.15889 39.903301, -75.15889 39.903393, -75.15889 39.903485, -75.158891 39.903576, -75.158891 39.903668, -75.158891 39.90376, -75.158891 39.903852, -75.158892 39.903944, -75.158892 39.904037, -75.158892 39.904129, -75.158892 39.904221, -75.158893 39.904313, -75.158893 39.904405, -75.158893 39.904497, -75.158893 39.904589, -75.158893 39.904681, -75.158894 39.904773, -75.158894 39.904865, -75.158894 39.904957, -75.158894 39.905049, -75.158895 39.905141, -75.158895 39.905233, -75.158895 39.905325, -75.158895 39.905417, -75.158895 39.905509, -75.158896 39.905601, -75.158896 39.905693, -75.158896 39.905785, -75.158896 39.905877, -75.158896 39.905969, -75.158897 39.906061, -75.158897 39.906153, -75.158897 39.906245, -75.158897 39.906337, -75.158898 39.906429, -75.158898 39.906521, -75.158898 39.906613, -75.158898 39.906705, -75.158898 39.906797, -75.158899 39.906889, -75.158899 39.906981, -75.158899 39.907073, -75.158899 39.907165, -75.1589 39.907257, -75.1589 39.907349, -75.1589 39.907441, -75.1589 39.907534, -75.1589 39.907626, -75.158901 39.907718, -75.158901 39.907809, -75.158901 39.907902, -75.158901 39.907994, -75.158901 39.908086, -75.158902 39.908178, -75.158902 39.90827, -75.158902 39.908362, -75.158902 39.908454, -75.158902 39.908546, -75.158903 39.908638, -75.158903 39.90873, -75.158903 39.908822, -75.158903 39.908914, -75.158904 39.909006, -75.158904 39.909098, -75.158904 39.90919, -75.158904 39.909282, -75.158904 39.909374, -75.158905 39.909466, -75.158905 39.909558, -75.158905 39.90965, -75.158905 39.909742, -75.158905 39.909834, -75.158906 39.909926, -75.158906 39.910018, -75.158906 39.91011, -75.158906 39.910202, -75.158906 39.910295, -75.158907 39.910387, -75.158907 39.910479, -75.158907 39.910571, -75.158907 39.910663, -75.158907 39.910755, -75.158908 39.910847, -75.158908 39.910939, -75.158908 39.911031, -75.158908 39.911123, -75.158908 39.911215, -75.158909 39.911307, -75.158909 39.911399, -75.158909 39.911491, -75.158909 39.911583, -75.158909 39.911675, -75.15891 39.911768, -75.15891 39.91186, -75.15891 39.911952, -75.15891 39.912044, -75.15891 39.912136, -75.158911 39.912228, -75.158911 39.91232, -75.158911 39.912412, -75.158911 39.912504, -75.158911 39.912596, -75.158912 39.912688, -75.158912 39.912781, -75.158912 39.912873, -75.158912 39.912965, -75.158912 39.913057, -75.158913 39.913149, -75.158913 39.913241, -75.158913 39.913333, -75.158913 39.913425, -75.158913 39.913517, -75.158914 39.91361, -75.158914 39.913702, -75.158914 39.913794, -75.158914 39.913886, -75.158914 39.913978, -75.158915 39.91407, -75.158915 39.914162, -75.158915 39.914254, -75.158915 39.914346, -75.158915 39.914439, -75.158916 39.914531, -75.158916 39.914623, -75.158916 39.914715, -75.158916 39.914807, -75.158916 39.914899, -75.158917 39.914991, -75.158917 39.915083, -75.158917 39.915176, -75.158917 39.915268, -75.158917 39.91536, -75.158917 39.915452, -75.158918 39.915544, -75.158918 39.915636, -75.158918 39.915728, -75.158918 39.915821, -75.158918 39.915913, -75.158919 39.916005, -75.158919 39.916097, -75.158919 39.916189, -75.158919 39.916281, -75.158919 39.916374, -75.15892 39.916466, -75.15892 39.916558, -75.15892 39.91665, -75.15892 39.916742, -75.15892 39.916834, -75.15892 39.916927, -75.158921 39.917019, -75.158921 39.917111, -75.158921 39.917203, -75.158921 39.917295, -75.158921 39.917388, -75.158922 39.91748, -75.158922 39.917572, -75.158922 39.917664, -75.158922 39.917756, -75.158922 39.917849, -75.158922 39.917941, -75.158923 39.918033, -75.158923 39.918125, -75.158923 39.918218, -75.158923 39.91831, -75.158923 39.918402, -75.158924 39.918494, -75.158924 39.918586, -75.158924 39.918679, -75.158924 39.918771, -75.158924 39.918863, -75.158924 39.918955, -75.158925 39.919047, -75.158925 39.91914, -75.158925 39.919232, -75.158925 39.919324, -75.158925 39.919416, -75.158925 39.919509, -75.158926 39.919601, -75.158926 39.919693, -75.158926 39.919785, -75.158926 39.919877, -75.158926 39.91997, -75.158927 39.920062, -75.158927 39.920154, -75.158927 39.920246, -75.158927 39.920339, -75.158927 39.920431, -75.158927 39.920523, -75.158928 39.920615, -75.158928 39.920707, -75.158928 39.9208, -75.158928 39.920837, -75.159048 39.920836, -75.159168 39.920836, -75.159287 39.920836, -75.159407 39.920836, -75.159527 39.920836, -75.159647 39.920835, -75.159766 39.920835, -75.159886 39.920835, -75.160006 39.920835, -75.160126 39.920834, -75.160245 39.920834, -75.160365 39.920834, -75.160485 39.920834, -75.160605 39.920834, -75.160724 39.920833, -75.160844 39.920833, -75.160964 39.920833, -75.161084 39.920833, -75.161203 39.920833, -75.161323 39.920832, -75.161443 39.920832, -75.161563 39.920832, -75.161683 39.920832, -75.161802 39.920831, -75.161922 39.920831, -75.162042 39.920831, -75.162162 39.920831, -75.162281 39.920831, -75.162401 39.92083, -75.162521 39.92083, -75.162641 39.92083, -75.16276 39.92083, -75.16288 39.92083, -75.163 39.920829, -75.16312 39.920829, -75.163239 39.920829, -75.163359 39.920829, -75.163479 39.920828, -75.163599 39.920828, -75.163718 39.920828, -75.163838 39.920828, -75.163958 39.920828, -75.164078 39.920827, -75.164197 39.920827, -75.164317 39.920827, -75.164437 39.920827, -75.164557 39.920826, -75.164676 39.920826, -75.164796 39.920826, -75.164916 39.920826, -75.165036 39.920826, -75.165155 39.920825, -75.165275 39.920825, -75.165395 39.920825, -75.165515 39.920825, -75.165635 39.920825, -75.165754 39.920824, -75.165874 39.920824, -75.165994 39.920824, -75.166114 39.920824, -75.166233 39.920823, -75.166353 39.920823, -75.166473 39.920823, -75.166593 39.920823, -75.166712 39.920823, -75.166832 39.920822, -75.166952 39.920822, -75.167072 39.920822, -75.167191 39.920822, -75.167311 39.920821, -75.167431 39.920821, -75.167551 39.920821, -75.16767 39.920821, -75.16779 39.920821, -75.16791 39.92082, -75.16803 39.92082, -75.168149 39.92082, -75.168269 39.92082, -75.168389 39.920819, -75.168509 39.920819, -75.168628 39.920819, -75.168748 39.920819, -75.168868 39.920819, -75.168988 39.920818, -75.169107 39.920818, -75.169227 39.920818, -75.169347 39.920818, -75.169467 39.920817, -75.169586 39.920817, -75.169706 39.920817, -75.169826 39.920817, -75.169946 39.920817, -75.170065 39.920816, -75.170185 39.920816, -75.170305 39.920816, -75.170424 39.920816, -75.170544 39.920815, -75.170664 39.920815, -75.170784 39.920815, -75.170903 39.920815, -75.171023 39.920815, -75.171143 39.920814, -75.171263 39.920814, -75.171382 39.920814, -75.171502 39.920814, -75.171622 39.920813, -75.171742 39.920813, -75.171861 39.920813, -75.171981 39.920813, -75.172101 39.920813, -75.172221 39.920812, -75.17234 39.920812, -75.17246 39.920812, -75.17258 39.920812, -75.1727 39.920811, -75.172819 39.920811, -75.172939 39.920811, -75.173059 39.920811, -75.173179 39.92081, -75.173297 39.92081))",
"status": "PROCESSED",
"collection_start_time": "2023-01-30T20:57:10.000+00:00",
"collection_end_time": "2023-01-30T20:57:50.000+00:00",
"stac_item_url": "https://rest-api.albedodev.com/catalog/484677"
}
]
}
With this image ID, the user can access the imagery directly with a request similar to:
https://rest-api.albedodev.com/catalog/484677
The response is a STAC Item result, where imagery products or assets can be accessed at the associated URLs:
{
"type": "Feature",
"stac_version": "1.0.0",
"id": "system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3",
"properties": {
"eo:cloud_cover": 0.004127630685675492,
"proj:epsg": 4326,
"proj:projjson": {
"$schema": "https://proj.org/schemas/v0.4/projjson.schema.json",
"type": "GeographicCRS",
"name": "WGS 84",
"datum_ensemble": {
"name": "World Geodetic System 1984 ensemble",
"members": [
{
"name": "World Geodetic System 1984 (Transit)",
"id": {
"authority": "EPSG",
"code": 1166
}
},
{
"name": "World Geodetic System 1984 (G730)",
"id": {
"authority": "EPSG",
"code": 1152
}
},
{
"name": "World Geodetic System 1984 (G873)",
"id": {
"authority": "EPSG",
"code": 1153
}
},
{
"name": "World Geodetic System 1984 (G1150)",
"id": {
"authority": "EPSG",
"code": 1154
}
},
{
"name": "World Geodetic System 1984 (G1674)",
"id": {
"authority": "EPSG",
"code": 1155
}
},
{
"name": "World Geodetic System 1984 (G1762)",
"id": {
"authority": "EPSG",
"code": 1156
}
},
{
"name": "World Geodetic System 1984 (G2139)",
"id": {
"authority": "EPSG",
"code": 1309
}
}
],
"ellipsoid": {
"name": "WGS 84",
"semi_major_axis": 6378137,
"inverse_flattening": 298.257223563
},
"accuracy": "2.0",
"id": {
"authority": "EPSG",
"code": 6326
}
},
"coordinate_system": {
"subtype": "ellipsoidal",
"axis": [
{
"name": "Geodetic latitude",
"abbreviation": "Lat",
"direction": "north",
"unit": "degree"
},
{
"name": "Geodetic longitude",
"abbreviation": "Lon",
"direction": "east",
"unit": "degree"
}
]
},
"scope": "Horizontal component of 3D system.",
"area": "World.",
"bbox": {
"south_latitude": -90,
"west_longitude": -180,
"north_latitude": 90,
"east_longitude": 180
},
"id": {
"authority": "EPSG",
"code": 4326
}
},
"proj:bbox": [
39.88459981359635,
-75.1732971512854,
39.920836609897734,
-75.15883800416786
],
"proj:wkt2": "POLYGON ((-75.1732971512854 39.920810242668395, -75.17329423527825 39.91988850440374, -75.17329133956571 39.91896682352007, -75.17328846415194 39.91804519743818, -75.17328560896243 39.91712362337573, -75.17328277434909 39.91620220716602, -75.17327996070426 39.915281130603525, -75.17327716763317 39.914360215614614, -75.17327439480472 39.91343936315473, -75.17327164258843 39.91251868149622, -75.17326891078756 39.911598121118814, -75.17326619986989 39.91067785730468, -75.1732635088532 39.90975749728172, -75.17326083876155 39.908837458862806, -75.17325818824395 39.90791720425058, -75.17325555835731 39.906997134814425, -75.17325294830387 39.906076954513225, -75.17325035848778 39.90515682160184, -75.17324778917691 39.9042368364591, -75.1732452398531 39.903316798725534, -75.17324271087327 39.90239684394589, -75.17324020145945 39.90147667654704, -75.17323771277225 39.90055673725413, -75.17323524376464 39.89963663054795, -75.17323279559477 39.898716802051865, -75.17323036756017 39.897796984921186, -75.17322795890558 39.89687688638828, -75.17322557158285 39.89595724522013, -75.17322320282167 39.895036998831344, -75.17322085492431 39.89411705000966, -75.17321852674566 39.89319694349538, -75.17321621841529 39.89227672882431, -75.1732139302321 39.8913565258196, -75.17321166153147 39.890436070258424, -75.17320941371833 39.88951593142182, -75.17320718494224 39.88859536132168, -75.17320497659215 39.887674923207896, -75.17320278813828 39.886754396052844, -75.17320061946539 39.88583374408247, -75.17319847030565 39.8849128566984, -75.17319774433516 39.88459981359635, -75.17200091357078 39.88460199607212, -75.17080409851815 39.88460416583651, -75.16960729915624 39.88460632289003, -75.16841051546406 39.884608467233214, -75.16721374742059 39.884610598866615, -75.16601699500484 39.88461271779077, -75.16482025819579 39.88461482400622, -75.1636235369725 39.88461691751347, -75.1624268313139 39.88461899831309, -75.16123014119903 39.88462106640558, -75.1600334666069 39.8846231217915, -75.15883800416786 39.88462516243502, -75.15884084769563 39.88554543477208, -75.15884366259074 39.88646584423392, -75.15884644712816 39.88738571323692, -75.15884920328367 39.888305836011185, -75.15885193101857 39.88922622371424, -75.15885462824811 39.890145984479226, -75.15885729700824 39.891065982443045, -75.15885993670457 39.891985968918874, -75.15886254727002 39.89290591058888, -75.15886512895767 39.893825912574854, -75.15886768079002 39.894745560974584, -75.1588702042367 39.89566549548866, -75.15887269811645 39.89658520451835, -75.15887516312544 39.89750497264391, -75.15887759924678 39.89842481223983, -75.15888000645555 39.899344706668586, -75.15888238415502 39.90026439051359, -75.1588847338772 39.90118453988844, -75.15888705420026 39.902104552402236, -75.15888934538124 39.90302449806527, -75.15889160753824 39.90394447029909, -75.15889384111458 39.904864633564095, -75.1588960459513 39.90578493746767, -75.15889822140025 39.90670510035437, -75.15890036857635 39.90762560952933, -75.15890248616564 39.9085458878562, -75.15890457414889 39.90946591238037, -75.15890663467253 39.910386649948244, -75.15890866584343 39.9113072572862, -75.1589106681866 39.912227982836754, -75.1589126418622 39.91314888053218, -75.15891458725888 39.91407012868601, -75.15891650348614 39.91499132859715, -75.15891839101168 39.91591271351821, -75.15892025030966 39.91683447318117, -75.15892208106979 39.91775648795039, -75.15892388292745 39.91867858331637, -75.15892565589014 39.919600761163416, -75.15892739991648 39.92052302069803, -75.1589279863147 39.920836609897734, -75.16012562318451 39.9208344781601, -75.16132324058884 39.92083233447146, -75.1625208385489 39.92083017883237, -75.16371841708593 39.92082801124336, -75.16491597622117 39.92082583170497, -75.1661135159758 39.92082364021774, -75.16731103637107 39.92082143678224, -75.16850853742822 39.92081922139898, -75.16970601916844 39.920816994068524, -75.17090348161295 39.920814754791394, -75.17210092478297 39.92081250356813, -75.1732971512854 39.920810242668395))",
"proj:geometry": {
"type": "Polygon",
"coordinates": [
[
[
-75.173297,
39.92081
],
[
-75.173294,
39.919889
]
]
]
},
"proj:shape": [
39341,
12000
],
"proj:centroid": {
"lat": 39.90271821174704,
"lon": -75.16606757772664
},
"proj:transform": [
-75.1732971512854,
0.0000012049289264612166,
0,
39.920836609897734,
0,
-9.210949467827709e-7
],
"datetime": "2023-09-14T11:30:42.581728Z",
"created": "2023-09-14T11:33:02.371Z",
"updated": "2023-09-14T11:33:02.371Z"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-75.173297,
39.92081
],
[
-75.173294,
39.919889
]
]
]
},
"links": [
{
"rel": "self",
"type": "application/geo+json",
"href": "https://2rsb2v63t9.execute-api.us-west-2.amazonaws.com/dev/collections/albedo-archive/items/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3"
},
{
"rel": "parent",
"type": "application/json",
"href": "https://2rsb2v63t9.execute-api.us-west-2.amazonaws.com/dev/collections/albedo-archive"
},
{
"rel": "collection",
"type": "application/json",
"href": "https://2rsb2v63t9.execute-api.us-west-2.amazonaws.com/dev/collections/albedo-archive"
},
{
"rel": "root",
"type": "application/json",
"href": "https://2rsb2v63t9.execute-api.us-west-2.amazonaws.com/dev"
},
{
"rel": "thumbnail",
"href": "https://2rsb2v63t9.execute-api.us-west-2.amazonaws.com/dev/collections/albedo-archive/items/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/thumbnail"
}
],
"assets": {
"View Ready Tiles": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_tiles/{z}/{x}/{y}.png",
"type": "image/png",
"title": "View Ready Tiles"
},
"View Ready COG": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_cog/image.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "View Ready COG"
},
"View Ready COG Browse Image": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_cog/browse.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "View Ready COG Browse Image"
},
"View Ready WMTS": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_tiles/wmts/metadata.json",
"type": "application/json",
"title": "View Ready WMTS"
},
"View Ready Thermal COG": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_thermal_cog/image.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "View Ready Thermal COG"
},
"View Ready Thermal COG Browse": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_thermal_cog/browse.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "View Ready Thermal COG Browse Image"
},
"Panchromatic L1B TIFF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/pan_l1b_tif/image.tif",
"type": "image/tiff",
"title": "Panchromatic L1B TIFF"
},
"Multispectral L1B TIFF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/ms_l1b_tif/image.tif",
"type": "image/tiff",
"title": "Multispectral L1B TIFF"
},
"Cloud Mask": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/ms_l1b_tif/cloud_mask.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "Cloud Mask"
},
"Panchromatic L1B NITF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/pan_l1b_nitf/image.ntf",
"type": "image/nitf",
"title": "Panchromatic L1B NITF"
},
"Multispectral L1B NITF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/ms_l1b_nitf/image.ntf",
"type": "image/nitf",
"title": "Multispectral L1B NITF"
},
"View Ready CIR COG": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/view_ready_cir_cog/image.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "View Ready CIR COG"
},
"Thermal L1B TIFF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/thermal_1b_tif/image.tif",
"type": "image/tiff",
"title": "Thermal L1B TIFF"
},
"Thermal L1B NITF": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/thermal_1b_tif/image.ntf",
"type": "image/nitf",
"title": "Thermal L1B NITF"
},
"Panchromatic RPC": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/pan_l1b_tif/geolocation.rpb",
"type": "application/xml",
"title": "Pan Image Rational Polynomial Coefficients (RPCs)"
},
"Multispectral RPC": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/ms_l1b_tif/geolocation.rpb",
"type": "application/xml",
"title": "Multispectral Image Rational Polynomial Coefficients (RPCs)"
},
"Thermal RPC": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/thermal_1b_tif/geolocation.rpb",
"type": "application/xml",
"title": "Thermal Image Rational Polynomial Coefficients (RPCs)"
},
"Multispectral Analysis-ready Raw DNs": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/ms_analysis_ready_dn/image.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "Raw DN Analysis-ready Multispectral Ortho"
},
"Panchromatic Analysis-ready Raw DNs": {
"href": "/data/system-test-f2a8beb2-e1c2-4942-a16c-7054b19083e3/pan_analysis_ready_dn/image.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "Raw DN Analysis-ready Pan Ortho"
}
},
"bbox": [
39.88459981359635,
-75.1732971512854,
39.920836609897734,
-75.15883800416786
],
"stac_extensions": [
"https://stac-extensions.github.io/eo/v1.1.0/schema.json",
"https://stac-extensions.github.io/projection/v1.1.0/schema.json",
"https://stac-extensions.github.io/view/v1.0.0/schema.json"
],
"collection": "albedo-archive"
}
Search
By Latitude, Longitude Point
Searching by latitude, longitude point is the simplest way to search for imagery in our library.
Minimally, the user only needs the latitude and longitude of the location of the imagery. The URL for searching for a location within the penns_landing_test image would be:
https://rest-api.albedodev.com/catalog/searchByLatLonPoint?lat=39.917111&lon=-75.158921
Searches by geometry (point, bounding box, or polygon) can return more than one item. The response from the above query (again, truncated for brevity) is:
{
"catalog_records":[
{
"type":"Feature",
"stac_version":"1.0.0",
"id":"test_image",
"properties":{
"datetime":"2023-01-24T01:07:17.884070Z"
},
"geometry":{
"type":"Polygon",
"coordinates":[
[
...
]
]
},
"links":[
],
"assets":{
"View Ready Tiles":{
"href":"/data/penns_landing_test/view_ready_tiles/{z}/{x}/{y}.png",
"type":"image/png",
"title":"View Ready Tiles"
},
"View Ready COG":{
"href":"/data/penns_landing_test/view_ready_cog/image.tif",
"type":"image/tiff; application=geotiff; profile=cloud-optimized",
"title":"View Ready COG"
}
},
"bbox":[
39.88459981359635,
-75.1732971512854,
39.92083660989773,
-75.15883800416786
],
"stac_extensions":[
]
}
]
}
By Bounding Box
Users can search using a latitude, longitude bounding box in a similar manner to searching by a point.
An example URL that will return the same results as the latitude, longitude search above is:
https://rest-api.albedodev.com/catalog/searchByLatLonBbox?min_lat=39.8&max_lat=39.9&min_lon=-75.17&max_lon=-75.15
Updated over 1 year ago
What’s Next
Now that you know how to search the Data Access API, let's get to the Access piece!