New ✨¶

The subscriptions API now has a parameter called time_range_type

The Subscriptions API requires that users provide a start_time and end_time parameter to filter to a Time of Interest (TOI). Historically, these parameters filter items based on their published timestamp, which represents when the item is first published in Planet’s item store. However, most customers want to get imagery based on the time when an image is acquired rather than published.

Today we have introduced a new optional parameter to the Subscriptions API called time_range_type. With this new parameter, customers can choose which time range type they would like to receive: acquired or published.

New ✨¶

The subscriptions API now has a parameter called publishing_stages

Planet continues to increase the amount of quality PlanetScope imagery available over many parts of the world. We want to ensure that users receive imagery in a stage of their choice, whether it be a preview, a standard, or a finalized version. We have introduced a new optional parameter to the Subscriptions API called publishing_stages.

Impacts: With this new parameter, users can choose which publishing stage they would like to receive (preview, standard, or finalized). If not included, subscriptions defaults to standard or, if available, finalized.

For more information, see the Subscriptions API documentation on Catalog Source Type.

Improvements 🙌🏻¶

Issue Summary: In an effort to improve internal and external auditing of subscription results, we have extended the TTL (time to live) of results within the Subscriptions API. Previously, regardless of a subscription’s status, results were not accessible from the API after 30 days. As of this change any newly created results will be accessible for at least 30 days. This still maintains previous behavior but clients are likely to view results older than 30 days going forward.

Impacts: This means that, especially for long-running subscriptions, the number of total results returned from the API may increase over its lifetime and may provide results beyond the usual 30 days threshold. Also, please note that this change is not retroactive in that this will only apply to results created since this release.

New ✨¶

The Subscriptions API now supports Planetary Variables

We have added support for delivery of Planetary Variables through the Subscriptions API. Users can subscribe to both raster and time series data. With this new feature, customers have access to the data for the following:

• Crop Biomass
• Land Surface Temperature
• Soil Water Content

Impacts: If you are interested in Planetary Variables using the API, create a subscription and specify a Planetary Variable source type. This change requires no action if you have an existing imagery subscription.

Read more about Subscribing to Planetary Variables.

New ✨¶

New raster processing tool in Subscriptions API: Harmonize

We have introduced the Harmonization tool to the Subscriptions API!

Read more about this new Subscriptions Tool.