In addition to region, you can examine areas of interest using geospatial files and lists of coordinates. Uploaded files are shared by all users in an account.
Geospatial files define one or more polygons that bound a region of interest.
Functionality:
Any API call that returns a map slice can be supplied with an additional keyword argument, e.g. “shapefile=test.kml” to mask the requested data slice to the chosen shapefile. This works the same in the dashboard:
Accepted formats:
<aside> 💡 Note: If using shapefiles in downscale, they should be meteorologically consistent because we use one historical analog for the entire shapefile.
</aside>
Coordinate files define a list of point locations of interest (lat/lons) using the API.
<aside> 💡 Note:
https://www.notion.so/images/favicon.ico
</aside>
Functionality:
Any API call that returns data at a single location can be parallelized to multiple locations simultaneously by supplying an additional keyword argument, e.g. “location_file=test.csv. If requesting data as a netcdf, the locations will be concatenated along a “locations” dimensions, and if requesting csv will generate a different csv for each location and zip them into a single file to be returned.
Accepted formats:
The formatting is quite flexible as the parser will look for any columns with the following headers to generate coordinate pairs: