
Welcome to the MOSAIKS API
If you’ve been to the API before, you may notice that things look different. We offer access to all of the same data, but with a new interface. See details below.
Downloading Features
The native resolution features are organized using a 0.01 x 0.01 degree latitude-longitude global grid, centered at .005 degree intervals. Features have been created from a 2019 Quarter 3 composite image of the earth from Planet Labs .
You will generally receive features in a tabular .csv format. Each row represents a unique grid cell (or administrative unit), with the first two columns representing latitude and longitude coordinates (or the administrative unit code), and subsequent columns representing K features (for now, there are K = 4000 features).
To access feature files, you will need to create a Redivis account and be signed in.
Obtaining features using the Coarsened Global Grids
We offer MOSAIKS features for the globe at coarsened resolutions that are easy to download. The advantage of using these files, is that they provide rich information globally and are relatively small in file size. For many users intending to experiment with the platform, these grid files may be a great place to start.
Currently, we offer 1 x 1 degree, 0.25 0.25 degree, and 0.1 x 0.1 degree coarsened grids. These aggregations are available with area weights as well as population weights.
Proceed to Coarsened Global Grids
Obtaining features using the Administrative Region Aggregations
We offer MOSAIKS features that are aggregated to the country (ADM0), state/province (ADM1), and county/municipality (ADM2) levels. A significant amount of administrative data is only available when aggregated up to these political units. For many users using label data for ADM units, these files may be all that is needed.
Just as with the Global Grids, these administrative unit aggregations are available with area weights as well as population weights.
These data are also what is used to produce the results of Sherman et al., (2023) For more information on administrative unit aggregations, see Sherman et al., (2023)
Proceed to Administrative Region Aggregations
Dense grid methods (advanced users)
More advanced users, may want native resolution grid files (0.01 x 0.01 degree resolution). Users can query for these files using directly using Redivis.
To get started, review this Python notebook in conjunction with the Redivis documentation. More guidance documents for querying native resolution features will be added soon.
Proceed to Redivis
For questions, contact mosaiksteam@gmail.com.
Banner photo by Aviv Ben Or