Documentation >

Changelogs

This document highlights the new features, datasets, and breaking changes between each release of the Planetary Computer.

January 2023

This release brings a new datasets and features, including:

Vector Rendering

The Planetary Computer Data Catalog contains assets in a variety of common geospatial formats, but until now the Explorer has only supported visualizing raster data. With this release, we’re introducing support for vector rendering for collections with GeoParquet data assets. We’re showcasing this feature with the MS Buildings dataset, which contains over 1 billion building footprints across the world.

For this, and future, GeoParquet vector datasets you’ll find a new collection-level asset with a role of tilejson that contains a TileJSON endpoint that can be used to render the data as Mapbox Vector Tiles.

Use the Explorer to quickly visualize the geographic coverage of the dataset:

/_images/docs-explorer-vector-buildings-us-extent.png

Or overlay it with other layers to see how it fits into the broader context of the world. For example, to see villages in southern Nigeria that have very low nighttime light intensity:

/_images/docs-explorer-vector-buildings-at-light.png

Here’s an example of building vectors rendered with a Sentinel-2 imagery product:


New datasets

This release includes several new datasets:

ESA Climate Change Initiative Land Cover

The ESA Climate Change Initiative Land Cover datasets consistent global annual land cover maps at 300m spatial resolution from 1992 to 2020. There are collections containing Cloud Optimized GeoTIFFs and NetCDF files.

This is a timelapse from 1992-2020 over the Amazon Rainforest in Brazil and Bolivia:

Timelapse ESA CCI LC 1992-2020 over Brazil

NOAA Climate Normals

The NOAA US Climate Normals datasets provide information about typical climate conditions for thousands of weather station locations across the United States.

The individual weather station data is contained in the noaa-climate-normals-tabular colleciton, which contains tabular data in GeoParquet format.

Additionally, there is gridded data provided in the collections noaa-climate-normals-gridded, which contains Cloud Optimized GeoTIFFs, and noaa-climate-normals-netcdf which contains NetCDF files.

Note that this dataset resides in the East US Azure region.

https://ai4edatasetspublicassets.azureedge.net/assets/pc_thumbnails/noaa-climate-normals-gridded-thumb.png

Cropland Data Layer

The USDA Cropland Data Layer is a crop-specific land cover classification product of more than 100 crop categories grown in the United States.

/_images/changelog-usda-cdl.png

USGS Land Change Monitoring, Assessment, and Projection

The USGS Land Change Monitoring, Assessment, and Projection (LCMAP) datasets provide land cover mapping and change monitoring from the U.S.

There are two datasets; one containing “Collection 1.3” data for the Conterminous United States (usgs-lcmap-conus-v13) and another containing “Collection 1.0” data for Hawaii (usgs-lcmap-hawaii-v10)

This is a timelapse from 1985-2021 over California’s Plumas National Forest:

Timelapse ESA CCI LC 1992-2020 over Brazil

National Wetlands Inventory

The FWS National Wetlands Inventory collection contains more than 35 million wetland and deepwater features. This dataset covers the conterminous United States, Hawaii, Puerto Rico, the Virgin Islands, Guam, the major Northern Mariana Islands and Alaska.

/_images/changelog-fws-nwi.png

Dataset updates

NOAA GOES updates

Other dataset updates

  • TerraClimate was updated to include the latest data from the producer, the Climatology Lab. The dataset now covers 1958 - 2021. Note that some variables, such as the station influence variables, are no longer provided. The Zarr store linked from the STAC collection is at a new URL. The data at the old URL will be deleted sometime in the future. In addition, the STAC metadata now includes the latest updates from the xarray-assets STAC extension.

  • The NOAA National Water Model data products, which are hosted but not yet fully integrated into the API, are now documented in the data catalog.

  • Using new functionality in stactools, the footprints in the ASTER collection have been update to better match the actual image data, rather than the full raster extent.

  • Collections now have an msft:region property, which indicates the Azure Region in which the data is hosted.

  • The Microsoft Building Footprints dataset can now be visualized in the Explorer, using the vector rendering feature described above.

Documentation Improvements

Updates to our Terms of Use

Our Terms of Use has been updated to clarify terms about the data access tokens issued by the Planetary Computer for data access. No change in behavior or permissions has occurred. Please read the Terms of Use to get more information about the permitted utilization of data tokens for the Planetary Computer.

Notices for upcoming release

Please be advised that in the next release, approximately in the April/May 2023 time frame, we will be upgrading the version of our raster tiling engine, TiTiler. This will result in some changes to the way rendering parameters are specified when generating image tiles. These changes will affect both the Item Tile endpoints and the Mosaic Tile endpoints.

These changes will not affect how you use the Explorer or any links you’ve saved or shared via the Explorer. It will only affect certain query string parameters you may have generated that hit /api/data/ endpoints directly.

Please see the upstream changes for more information:

If you have any questions, please reach out to us on our GitHub Discussions page.

October 2022

New features

This release brings a number of new features to the Explorer app, including:

Item preview mode

The default map view for search results is a mosaic of all the items included in the search. This is useful for quickly getting an overview of the data available, but it can be difficult to see individual items in the mosaic. Since mosaics default to layering the most recent results on top, it may obscure older items in the mosaic. Or, varying atmospheric conditions may result in incongruent seams where the mosaic has applied pixels from different partially overlapping items.

To help with this, we’ve added a new “Item Preview” mode to the map view. When activated, this mode locks the current search and will render just the selected item from the search results. Since the search is locked, you can pan and zoom the map without affecting the result list. You can select a different item from the search results to preview it on the map, or use the map control to move to the next or previous item in the search results. Using the map control, you can also zoom to the current item’s footprint on the map or return to the original search viewport.

To activate, click the map icon button on the thumbnail image of any search result:

/_images/docs-explorer-activate-item-preview_c.jpg

Here’s an example of using Item Preview mode to view sequential search result items showing the progression of the devastating floods in Pakistan from late 2022 using Sentinel-1 RTC.


Generate a timelapse GIF for a dataset mosaic

Many of our datasets have a temporal component, and it can be interesting to see how the data changes over time. We’ve added a new feature to the Explorer app that allows you to generate a timelapse GIF for any dataset mosaic that has a temporal dimension. You can control the time increment, area of interest, and frame speed of the GIF. The timelapse export will use the current search parameters and render options to generate the GIF, so experiment with the settings to get a good result. To use the feature, open the overflow menu on the search results header and select “Generate timelapse animation”

/_images/docs-explorer-animation-screen_c.jpg

Using a timelapse is another way to view sequential items, similar to the Item Preview feature. Using the same example for the Sentinel-1 RTC dataset, this GIF also shows the progression of the floods in Pakistan from late 2022.

Our Landsat C2 L2 dataset goes back to 1982 in many places, and is a good example of how you can use the timelapse feature to see how the landscape has changed over time. Here’s a timelapse GIF of the Landsat C2 L2 dataset for the area around the city of Las Vegas, Nevada.

Timelapse of Las Vegas

Generate a static image of a dataset mosaic

Similar to the timelapse export, you can also generate a static image of a dataset mosaic. This is useful for creating an image of a dataset for a report, presentation, to use as a background, or to share on social media. To use the feature, open the overflow menu on the search results header and select “Generate snapshot image”.

Adjust the settings to control the area of interest and image size, then click “Generate image” to download the image.

/_images/docs-explorer-image-screen_c.jpg

You can also use this to create great Microsoft Teams backgrounds! Use the “Large (1920 x 1080)” image size to clip out your favorite view and set it as your background in Teams. If you want to automate the generation of Teams backgrounds - and don’t mind a bit of codebase setup - check out the https://github.com/microsoft/planetary-computer-teams-background repository, which uses the Planetary Computer APIs to auto-rotate with the latest imagery of Sentinel 2 from the Planetary Computer.


Advanced filter allows settings time in ranges

You can now specify time (in UTC) for date ranges in the Advanced date field filter. This is especially useful for frequently updating datasets like GOES-CMI, where you may want to filter for a specific time range. To use the feature, enable the Advanced filter and open the date field dropdown.

/_images/docs-explorer-time-filter_c.jpg

Along with filtering on time, all search results now include the time in their display to help better identify individual items.


Ability to change sort order of search results

Last but now least, we’ve also added a sort direction selector for search results. You can now sort the results by date ascending or descending. This not only sorts the results list, but also the order of items applied to the mosaic on the map.

/_images/docs-explorer-sort-order_c.jpg

New datasets

This release includes several new datasets:

GOES-R Lightning Detection

GOES-R Lightning Detection: Continuous lightning detection over the Western Hemisphere from the Geostationary Lightning Mapper (GLM) instrument.

/_images/docs-data-glm_c.jpg

NOAA MRMS QPE

/_images/docs-data-noaa-mrms-qpe_c.jpg

NOAA Monthly NClimGrid

NOAA Monthly NClimGrid: Monthly Climate Gridded dataset with data on temperature and precipitation.

Timelapse avg temp nclimgrid

Denver Regional Council of Governments Land Use Land Cover

Denver Regional Council of Governments Land Use Land Cover: 1-ft resolution land use / land cover dataset around Denver, Colorado.

/_images/docs-data-denver-regional_c.jpg

Chesapeake Land Cover/Land Use

Chesapeake Land Cover (7-class): 1-meter land cover data product for the entire Chesapeake Bay watershed with a uniform set of 7 land cover classes.

/_images/docs-data-chesapeake-7_c.jpg

Chesapeake Land Cover (13-class): 1-meter land cover data product for the entire Chesapeake Bay watershed with 13 varying land cover classes.

/_images/docs-data-chesapeake-13_c.jpg

Chesapeake Land Use: 1-meter land use data product for the entire Chesapeake Bay watershed.

/_images/docs-data-chesapeake-lu_c.jpg

June 2022

This month’s release includes many changes to our website tools, support for bulk STAC queries, several new datasets, and updates to our open-source dependencies and libraries.

Highlights

  • The Catalog and Explorer interfaces have been redesigned to accommodate the increased number of datasets available in the Planetary Computer.

  • The entire website, including the Explorer, Catalog, and Documentation pages, have all been updated to work well on most mobile devices.

  • We now provide snapshots of our STAC items for most of our collections as GeoParquet datasets to support bulk STAC queries.

Bulk STAC queries with GeoParquet

Many of our collections now include a geoparquet-items collection-level asset that links to a GeoParquet dataset in Azure Blob Storage. Each row in these Parquet datasets is a STAC item. While most users should continue to use the normal STAC API, these Parquet datasets are a nice complement for workloads that need to return very many STAC items.

See Bulk STAC item queries with GeoParquet for more.

New datasets

This release includes several new datasets in our STAC API. Each of these links to the dataset details page, which includes an example notebook.

May 2022

This release includes many new datasets, API enhancements, and updates to libraries.

Highlights

  • Improved performance and scalability of our STAC API. Requests to our STAC API, including searches, will return faster and scale to larger concurrent loads. See the pgstac 0.5 and 0.6 release notes for more.

  • The Explorer now includes the ability to pin layers, allowing you to compare multiple queries. See working with multiple layers for more.

  • Many new datasets are available through our catalog. See the datasets section below for more.

New datasets

This release includes many new datasets. Each of these links to the dataset details page, which includes an example notebook.

API updates

STAC API

  • Updated the STAC API to v1.0.0-rc.1

  • Initial support for queryables in the STAC API. See Sentinel-2-l2a for an example. Additional queryables and more metadata description in coming releases.

  • Scalability and performance improvements.

Data API

  • Upgrades to pgstac-titiler 0.1.0a7

  • Scalability and performance improvements.

Documentation and Tutorials

In addition to the dataset examples, we have several new tutorials going in-depth on a specific topic.

Hub environments

Changes

Changes in behavior that existing users may need to account for:

  • The landsat-8-c2-l2 collection is deprecated. This collection only contained Landsat 8 images from Collection 2. Please use the landsat-c2-l2 collection, which now has data from Landsat 4 - 9 spanning all the way back to 1982. Existing workflows using landsat-8-c2-l2 items should be able to switch to landsat-c2-l2 without disruption. landsat-8-c2-l2 is removed from the website but remains in the STAC API; however it will no longer be updated with new items.

  • Some queries on date ranges may return different results with this new release. This is due to corrections in the date range logic in our underlying metadata store, PgSTAC. For Items with all of a start_datetime, end_datetime, and datetime property, only the start_datetime and end_datetime will be considered, whereas previously datetime was the target of the search.

January 2022

This release includes several new datasets, features, and updates to libraries.

Highlights

  • The Explorer tool now has an advanced mode which allows creating custom queries against our datasets.

  • Six new datasets have been added to our catalog.

  • We’ve open-sourced our STAC API, Tiler API, and our frontend tools — in addition to the Hub. See more details at our main repository.

APIs

STAC API

New features

Data API

New features
  • Our tiling endpoints were upgraded to the latest version of TiTiler. This has some breaking changes to the query string parameters, see GitHub for more details.

  • Added endpoints to generate map legend configuration from a set of TiTiler render parameters.

New API datasets

  • GPM IMERG: A time series of precipitation over the majority of the earth.

  • 10m Annual Land Use Land Cover (9-class): A time series of annual global maps of land use and land cover.

  • Earth Exchange Global Daily Downscaled Projections: Global downscaled climate scenarios derived from the General Circulation Model runs conducted under the Coupled Model Intercomparison Project Phase 6.

  • Land Cover of Canada: Collection of Land Cover products for Canada as produced by Natural Resources Canada using Landsat satellite imagery.

  • Chloris Biomass: Estimates of stock and change in aboveground biomass for Earth’s terrestrial woody vegetation ecosystems.

  • gNATSGO Soil Database: A composite database that provides complete coverage of the best available soils information for all areas of the United States and Island Territories.

New Blob Storage datasets

Hub environments

Support for batch workflows

The Planetary Computer Hub is now integrated with kbatch to run asynchronous / batch workflow jobs, complementing JupyterHub’s support for interactive computing. See the kbatch overview and the kbatch documentation for more.

New package versions

The Planetary Computer Hub has been upgraded to use container images from the planetary-computer-containers 2022.01.17.0 release. In particular, this release includes

  • pystac-client 0.3.2, with support for cql2-json queries

  • leafmap 0.7.2, with support for adding STAC items from the Planetary Computer’s STAC catalog and tiling with the Planetary Computer’s data API

See the release notes for the changes in the various packages provided in the Planetary Computer’s environment.

Website

  • Explorer advanced mode offers a custom query builder interface, and searches use the new CQL2 syntax

  • Explorer now generates dynamic legends for continuous and categorical datasets

  • Updated styling and layout of the Planetary Computer Data Catalog and Explorer

  • The Data Catalog and Explorer tools are open-sourced

September 2021

This release includes several new datasets, features, and updates to libraries.

Highlights

APIs

STAC API

New features

Data API

New features
  • Implemented STAC query mosaics through the titiler-pgstac project. This API allows mosaics of the results of STAC queries, and powers the map tiles for the new Explorer front-end.

New datasets

  • GOES-R ABI L2 Cloud & Moisture Imagery: This dataset provides 16 bands from the ABI instrument aboard the GOES-16 and GOES-17 satellites. We provide both NetCDF and COG data assets. More GOES-R products are coming soon!

  • ALOS DEM: a 30-meter resoluation global digital surface model.

  • Copernicus DEM: a global digital surface model available at both 30- and 90-meter resolution.

  • Global Biodiversity Information Facility (GBIF): records of species occurrences from a wide array of sources including specimen-related data from natural history museums, observations from citizen science networks, and automated biodiversity surveys.

  • US Census 2020: information on population and geographic boundaries at various levels of cartographic aggregation.

  • gridMET: a dataset of daily surface meteorological data covering the contiguous United States at ~4km resolution.

  • USFS Forest Inventory and Analysis (FIA): Status and trends on U.S. forest location, health, growth, mortality, and production.

Hub environments

New package versions

The Planetary Computer Hub has been upgraded to use container images from the planetary-computer-containers 2021.09.27.0 release. Among other changes, these container images include

  • pystac-client 0.3.0b1

  • dask-geopandas 0.1.0a4

  • planetary-computer 0.4.2

See the release notes for the changes in the various packages provided in the Planetary Computer’s environment.

Note

pystac-client 0.2.0 doesn’t recognize the new conformance classes provided by the Planetary Computer’s STAC API. Either set “ignore_conformance=True” when creating your pystac Client, or upgrade to pystac-client>=0.3.0b1.

Website

August 2021

This minor release has the following breaking changes:

  • The sentinel-2-l2a Item IDs have been updated to include the Product Discriminator number. See this stactools issue for more information.

  • The sentinel-2-l2a Items have removed the downsampled version of assets. This includes renaming asset keys to no longer have the resolution; for example, visual-10m has been renamed to visual and visual-20m has been removed.

New datasets

  • JRC Global Surface Water: surface water distribution from 1984 to 2020, based on data from the Landsat 5, 7, and 8 sensors.

July 2021

Highlights

  • The STAC API is now compliant with STAC 1.0.

  • Added a new Data API with several features, including the ability to preview datasets and items. See Data API below for more.

  • Added support for Earth-systems datasets in our STAC catalog. See Datasets below for more.

  • The Hub environment Dockerfiles and images are now publicly available. See Hub environments below for more.

APIs

STAC API

New features
Breaking changes
  • Users will need to use tools that work with STAC 1.0 with the STAC API. As STAC 1.0 was recently released, the state of the tools ecosystem is still catching up. See the new Hub package versions below for packages that will work with the STAC API.

Data API

This is a new API that provides titiler endpoints for our STAC Items. There are also collection tile endpoints for some datasets. See the Data API docs for a list of endpoints available. These endpoints are not available for all Collections and Items. For Collections and Items that have visualization endpoints, assets are added for TileJSON and links for simple Leaflet map previews are added by the STAC API. For example, https://planetarycomputer.microsoft.com/api/data/v1/collection/map?collection=io-lulc is the preview link for the new Esri 10-Meter Land Cover dataset.

The Data API should be considered in an alpha state - expect updates and breaking changes in the future.

Datasets

The full list of new datasets is provided below, but we wanted to highlight that that a new kind of dataset is now available through our STAC API. In addition to our remote sensing datasets stored as Cloud Optimized GeoTIFFs, we’re also hosting and cataloging data stored in Zarr format. See this Daymet dataset for an example. This work was done with the STAC and Pangeo communities, and spurred improvements to the datacube STAC extension and the creation of the xarray-assets STAC extension.

New datasets

The following datasets are now available in our data catalog and STAC API:

Changes to existing datasets

  • New items from Sentinel-2 and Landsat 8 are now continuously available through the STAC API

  • Changed the item IDs for Sentinel-2 Level-2A and Landsat 8 Collection 2 Level-2 to not include the processing date

  • Fixed issues with missing Sentinel-2 scenes

  • Fixed various quality issues with some Landsat 8 scenes by updating to the most recently processed version available from USGS

  • Fixed Landsat 8 STAC item footprints being off by half a pixel

Hub environments

The Dockerfiles for building the environments used on the Planetary Computer Hub are now available at https://github.com/microsoft/planetary-computer-containers. Users can download the images from Microsoft Container Registry:

$ docker pull mcr.microsoft.com/planetary-computer/python

The packages used in the Hub’s environments have been upgraded. The following table lists some notable changes.

New package versions

Package

Previous version

New version

pystac

0.5.6

1.0.0rc3

pystac-client

0.1.1

0.2.0b2

dask

2021.5.0

2021.6.2

planetary-computer

0.2.2

0.3.0rc2

Some of these package updates include API breaking changes. We recommend reading through the relevant changelogs:

Website

Some datasets now have a built-in map viewer. Check it out on Esri 10m Land Cover.