MPLNETThe NASA Micro-Pulse Lidar NetworkNational Aeronautics and
Space Administration
Goddard Space
Flight Center

MPLNET Web Services


The MPLNET project provides the following web services for application programming interfaces (API):

  • Download: download MPLNET data products
  • Plot: plot MPLNET data
  • Metadata: download MPLNET site metadata

    Click on a web service to learn more.


    Metadata Web Service

    This service provides an API to download MPLNET site metadata. Download formats include:

    • CSV
    • KML
    • WIGOS (planned)

     
    The metadata web service end point is:
    https://mplnet.gsfc.nasa.gov/operations/sites?api&

     
    The metadata parameters are format, sites, year, month, day. Format is the only required parameter.

    • format=value: where value is one of the following
      • csv: produces a CSV text file based on other search parameters
      • kml: produces a KML file based on other search parameters
      • wigos: produces a WIGOS XML file based on other search parameters (not operational yet)

    • sites=value: where value is one of the following
      • all: produces output file containing all sites (active and inactive). May also omit sites parameter if all sites are desired (this is a default)
      • active: produces output file containing only active sites (if year, month, or day are not set then uses today's date)
      • inactive: produces output file containing only inactive sites (if year, month, or day are not set then uses today's date)
      • active:inactive: produces output file containing both active and inactive sites (if year, month, or day are not set then uses today's date)
      • planned: produces output file containing only planned sites
      • Site Name: produces output file containing only requested site
      • collection;value: produces output file containing sites in pre-selected collections defined by value, where value is one of:
        • MPLCAN: Canadian sites in the MPLCAN sub-network of MPLNET
        • CAMPAIGNS;7SEAS: Field Campaign sites in the Seven South East Asian Studies (7-SEAS)
        • CAMPAIGNS;CAHN: Field Campaign sites in the Caribbean Aerosol Health Network (CAHN)
        • ICAP;NIOSEA: International Cooperative for Aerosol Prediction (ICAP) region of Northern Indian Ocean and South East Asia
        • ICAP;BYZANTIUM: International Cooperative for Aerosol Prediction (ICAP) region of Byzantium
        • ICAP;EASTASIA: International Cooperative for Aerosol Prediction (ICAP) region of East Asia
        • ICAP;SUBTROPATL: International Cooperative for Aerosol Prediction (ICAP) region of Subtropical Atlantic
        • ICAP;PACIFIC: International Cooperative for Aerosol Prediction (ICAP) region of Pacific
        • ICAP;CONUS: International Cooperative for Aerosol Prediction (ICAP) region of CONUS
        • ICAP;SATLANTIC: International Cooperative for Aerosol Prediction (ICAP) region of South Atlantic
        • ICAP;SIOAUS: International Cooperative for Aerosol Prediction (ICAP) region of Southern Indian Ocean and Australia
        • ICAP;NPOLAR: International Cooperative for Aerosol Prediction (ICAP) region of North Polar
        • SDS;NAMEE: WMO Sand and Dust Storm Warning and Advisory System (SDS-WAS) region of North Africa, Middle East, and Europe
        • SDS;EASTASIA: WMO Sand and Dust Storm Warning and Advisory System (SDS-WAS) region of East Asia
        • SDS;PANAM: WMO Sand and Dust Storm Warning and Advisory System (SDS-WAS) region of Pan-America
        • DUSTBELT: MPLNET sites in the Northern Hemisphere Dust Belt
        • NAAPS: MPLNET sites selected for the Navy Aerosol Analysis and Prediction System (NAAPS)

    • year=value: produces output file only containing sites active for requested year (or if month also set, then YYYY-MM period)

    • month=value: produces output file only containing sites active for requested month (or if year also set, then YYYY-MM period)

    • day=value: must be set with year and month, produces output file only containing sites active for the requested date (YYYY-MM-DD)

     
    Examples shown below:

     
    Download All Sites in CSV
    https://mplnet.gsfc.nasa.gov/operations/sites?api&sites=all&format=csv

    Download All Sites in KML
    https://mplnet.gsfc.nasa.gov/operations/sites?api&sites=all&format=kml

    Download All Sites in CSV that were active in 2010 (can omit sites parameter if all sites are desired)
    https://mplnet.gsfc.nasa.gov/operations/sites?api&format=csv&year=2010

    Download All Sites in CSV that were active in July 2010
    https://mplnet.gsfc.nasa.gov/operations/sites?api&format=csv&year=2010&month=7

    Download Currently Active Sites in CSV
    https://mplnet.gsfc.nasa.gov/operations/sites?api&sites=active&format=csv

    Download All Sites in CSV that were active in the months of July (over entire project time period 2000 - current)
    https://mplnet.gsfc.nasa.gov/operations/sites?api&format=csv&month=7

    Download 7-SEAS Sites in CSV that were active in 2018
    https://mplnet.gsfc.nasa.gov/operations/sites?api&sites=collection;campaigns;7seas&format=csv&year=2018

  • National Aeronautics and
    Space Administration
    Goddard Space
    Flight Center
    Privacy Policy and Important Notices