Return to API Services

Documentation for /geojson/usdm.py

This service returns a GeoJSON representation of the US Drought Monitor for a given date. The date is specified in the date parameter, which should be in the format of YYYY-MM-DD. If no date is provided, the latest valid USDM is returned.

Changelog

  • 2026-02-14: Renamed top level metadata generation_time to generated_at for better consistency across IEM services.
  • 2024-08-09: Initial documentation release

Example Usage

Fetch the latest USDM:

https://mesonet.agron.iastate.edu/geojson/usdm.py

Fetch the USDM for closest date to 20 March 2024:

https://mesonet.agron.iastate.edu/geojson/usdm.py?date=2024-03-20

CGI Arguments

The following table lists the CGI arguments that are accepted by this service. A HTTP GET request is required. Fields of type Multi-Params or CSV value can accept either a comma separated list or multiple parameter and value combinations. For example, ?foo=1&foo=2 is equivalent to ?foo=1,2.

Field Type Description
callback string or null Legacy JSON-P style callback. It is likely best to not depend on this usage. The IEM website has a permissive CORS.
date string or null Date to query for, YYYY-MM-DD