drewbo
5/22/2015 - 8:40 PM

landsatApiSearch.md

Let's make Landsat API have better search syntax

General Rules (replacing Lucene)

  • Instead of search?search=, let's just start adding params after search?
  • Instead of joining params with +AND+, let's use &
  • Instead of :, let's use =
  • Instead of using [X+TO+Y], let's use [X,Y] (and maybe sort them afterwards if they were flipped?)

Fields (many are empty, let's not document those)

New Field NameOld Name (if Different)TypeExample ValueNotes
acquisitionDatedatestring2013-12-12
sceneStartsceneStartTimedatetime2013:346:18:47:23.0605230
sceneStopsceneStopTimedatetime2013:346:18:47:54.8305190
sceneIDstringLC80440342013346LGN00
rowinteger34
pathinteger44
thumbnailbrowseURLstringhttp://earthexplorer.usgs.gov/browse/landsat_8/2013/044/034/LC80440342013346LGN00.jpg
cloudCovercloudCoverFullfloat0.76replaces old cloudCover which is always(?) empty
sunAzimuthfloat160.64830388
sunElevationfloat27.06930431
lrLonlowerRightCornerLongitudefloat-121.36425making shorter
lrLatlowerRightCornerLatitudefloat36.40613
llLonlowerLeftCornerLongitudefloat-123.43972
llLatlowerLeftCornerLatitudefloat36.80383
urLonupperRightCornerLongitudefloat-120.82587
urLatupperRightCornerLatitudefloat38.12929
ulLonupperLeftCornerLongitudefloat-122.94957
ulLatupperLeftCornerLatitudefloat38.52827
centerLonsceneCenterLongitudefloat-122.14336
centerLatsceneCenterLatitudefloat37.47448
dayOrNightstringDAY
receivingStationstringLGN
browseAvailablebooleanTrueNeed to convert bool to string
dateUpdateddateString2015-01-13
sensorstringOLI_TIRS

Other Fields that have values that I don't think we should document

  • cartURL
  • imageQuality1
  • GEOMETRIC_RMSE_MODEL_X
  • GEOMETRIC_RMSE_MODEL_Y
  • DATA_TYPE_L1
  • NADIR_OFFNADIR