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 |