AERONET Web Service:
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3
The following tables and
examples show how to use the AERONET web data service for Version 3 products.
Table 1: Explanation
and Values for Mandatory and Optional Web Service Parameters
| Mandatory
Parameters |
Explanation |
Values |
| year,month,day |
Starting
time moment (year= 1992 to present), (month=1 to 12), (day = 1 to max num,
depends on month) |
Year: 1993
to present (must be 4-digits)
Month: 1
to 12
Day: 1 to
max_day_of_month |
| AVG |
Data Format |
All points: AVG=10
Daily average: AVG=20 |
| [data_type] |
Data Types (See Table 2) |
[data_type]=1 |
| Optional Parameters |
|
|
| year2,month2,day2 |
Ending time moment** |
Year: 1993 to present (must be 4-digits)
Month: 1 to 12
Day: 1 to max_day_of_month
**if year2,month2, and day2 are omitted, then the current day is assumed |
| hour, hour2 |
Specified beginning (hour) and ending hour (hour2) |
Hour: 0 to 23
if not specified, then the hour is set to zero; time2 is incremented to next day and hour2=0 |
| site |
AERONET site name |
Exact match of AERONET database name
If none specified, then all sites are searched for data during the time interval specified
AERONET Site Name List |
| lat1,lon1,lat2,lon2 |
Bounding Box ** |
lat1,lon1 - Lower Left
lat2,lon2 - Upper Right
**values must be in decimal degrees (including the decimal) |
| lunar_merge |
Enable Lunar AOD Only Download |
0 - No Lunar
1 - Lunar Data |
ldp_year,
ldp_month,
ldp_day |
Request data records after user specified date based on the last processing date of the record ** |
Year: 1993 to present (must be 4-digits)
Month: 1 to 12
Day: 1 to max_day_of_month
** All Points format only |
| if_no_html |
Determine whether html formatting is printed |
0 - HTML formatting printed (default)
1 - No HTML formatting printed |
Table 2: Explanation
of Data Types for the Web Service
| Data
Types |
Explanation |
| AOD10 |
Aerosol Optical Depth
Level 1.0 |
| AOD15 |
Aerosol Optical Depth Level 1.5 |
| AOD20 |
Aerosol Optical Depth
Level 2.0 |
| SDA10 |
SDA Retrieval Level 1.0 |
| SDA15 |
SDA Retrieval Level 1.5 |
| SDA20 |
SDA Retrieval Level 2.0 |
| TOT10 |
Total Optical Depth based on AOD Level 1.0 (all points only) |
| TOT15 |
Total Optical Depth based on AOD Level 1.5 (all points only) |
| TOT20 |
Total Optical Depth based on AOD Level 2.0 (all points only) |
EXAMPLES
Level 1.0 data from the
"Cart_Site" for AOD daily averages
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?site=Cart_Site&
year=2000&month=6&day=1&year2=2000&month2=6&day2=14&
AOD10=1&AVG=20
Level 1.5 data from all sites with available data for all AOD points
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?
year=2000&month=6&day=1&year2=2000&month2=6&day2=14&
AOD15=1&AVG=10
Level 2.0 data from the "Cart_Site" for all AOD points
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?site=Cart_Site
&year=2000&month=6&day=1&year2=2000&month2=6&day2=14&
AOD20=1&AVG=10
Level 2.0 data from the "Cart_Site" for all SDA points
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?site=Cart_Site
&year=2000&month=6&day=1&year2=2000&month2=6&day2=14&
SDA20=1&AVG=10
Level 2.0 all AOD points from the "Tucson" site for the records with the last date processed (ldp) after January 1, 2022
https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?site=Tucson&year=2020&month=6&day=1&year2=2022&month2=6&day2=1
&AOD20=1&AVG=10&ldp_year=2022&ldp_month=1&ldp_day=1
Using Tools to Save Web Output as a File
Wget:
wget --no-check-certificate -q -O test.out
"https://aeronet.gsfc.nasa.gov/
cgi-bin/print_web_data_v3?site=Cart_Site&year=2000&
month=6&day=1&year2=2000&month2=6&day2=14&
AOD15=1&AVG=10"
Curl:
curl -s -k -o test.out "https://aeronet.gsfc.nasa.gov/cgi-bin/print_web_data_v3?site=Cart_Site&year=2000&month=6&
day=1&
year2=2000&month2=6&day2=14&AOD15=1&AVG=10" |
