Geospatial Resources

Vector/Feature Layers

The Ecoengine provides a selection of third party vector layers such as administrative boundaries, ecoregions, public lands etc. The data that is currently loaded can be introspected through the layers endpoint:

GET /api/layers/
Query Parameters:
 
  • tags – list of strings – search by layer tags
  • name – string – search by layer name

Note

Meta data are not fully implemented yet.

Each layer in this model is identified by its unique slug. To get the features of the layer:

GET /api/layers/{slug}/

To get a tiled vector layer (default)

GET /api/layers/{slug}/tiles/{z}/{x}/{y}/

For a working example see http://jsfiddle.net/postfalk/u20uvj6w/.

In addition this resources are also provided by a pre-rendered Mapnik generated png tiles.

GET /api/tiles/{slug}.png

Warning

This TileStache based endpoint is pending deprecation. However, if the URL has been obtained from the layers view, we will update it with the new rendering engine which is currently in the making.

Raster Data

Raster data is the second major source of geospatial content in the Ecoengine API. Available raster data sets are registered in the raster series endpoint:

GET /api/series/

Every raster series is identified by a unique slug.

GET /api/series/{slug}/

A series contains an array of rasters representing individual time steps. The time steps can be filtered between a given date pair:

GET /api/series/{slug}/{begin_date}/{end_date}/

Raster values can be read for any provided location:

GET /api/series/{slug}/rasters/
Query Parameters:
 
  • bbox – bounding box coordinates like bbox=-107.74,37.39,-106.95,38.40
  • g – geometry as GeoJSON, GML, KML or WKT
  • periods – resample temporal dimension to the given integer
  • stat – aggregate values over the given geometric area, one of max, mean, median, min, std, var

Tiled raster images can be retrieved using the URL template provided with the raster store response which follows this format:

GET /api/tiles/{slug}-{date}/{z}/{x}/{y}/

For a working example see http://jsfiddle.net/postfalk/c734kL2c/.