2.19.0

• Orders API client support for multiple fallback bundle(s) (#1106)
• Make subscription source types optional (#1107)

2.18.0

What's Changed

• Increase default read timeout to 125s
• Make read timeout configurable per Session

Full Changelog: 2.17.0...2.18.0

2.17.0

What's Changed

• hotfix: omit page_size arg to client call if not provided in subs cli list command by @charcey in #1102

Full Changelog: 2.16.0...2.17.0

2.16.0

Subscriptions API Summary Endpoints Support

We're excited to announce the support of two new Subscriptions API endpoints in v2.16! You can now summarize subscription statuses and subscription result statuses to better track all your subscriptions or a single subscription.

Using the CLI:

planet subscriptions summarize // to summarize the status of all subs the requester has created
planet subscriptions summarize --subscription-id={SUB_ID} // to summarize the status of _results_ for the provided subscription

Python SDK:

from planet import Planet
pl = Planet()

# to summarize the status of all subs the requester has created
summary = pl.subscriptions.get_summary()

# to summarize the status of _results_ for the provided subscription
subscription_summary = pl.subscriptions.get_subscription_summary(SUB_ID)

The follow docs are available:

• Python client: get summary
• Python client: get subscription summary
• CLI

Please open an issue to report bugs or provide feedback.

What's Changed

• Add support for new subscriptions summary endpoints by @charcey in #1098
• fix notes for features api docs by @stephenhillier in #1099
• fix docstring in get_subscription_summary client function by @charcey in #1100

Full Changelog: 2.15.0...2.16.0

Features API support

We're excited to announce Features API support in v2.15! You can now create Features API collections and items using both the CLI and SDK.

Using the command line client:

planet features collections list
planet features collections create --title "my new collection"  // returns collection ID
planet features items add $COLLECTION_ID ./my-feature.geojson

Python SDK:

from planet import Planet

def main():
    pl = Planet()

    # list items in a collection
    items = pl.features.list_items(collection_id=collection_id)

    for item in items:
        # use items/AOIs directly in other Planet APIs
        results = pl.data.search(["PSScene"], geometry=item)

See the docs for more SDK examples. Please open an issue to report bugs or provide feedback.

What's Changed

• Features client by @tbarsballe in #1073
• add info about features support by @stephenhillier in #1097

Full Changelog: 2.14.0...2.15.0

2.14.0

What's Changed

• Upgrade httpx to >= 0.28.0 by @asonnenschein in #1089
• Add group_by to composite tool function (#1053) by @ormaq in #1088
• refactor sdk and cli guides by @stephenhillier in #1087
• Housekeeping: Add GEE delivery option for Subscription, OCS delivery option for Orders, remove PS2 target sensor for harmonize tool by @charcey in #1092
• add str to geometry type hints by @stephenhillier in #1090
• add "create configuration" support for SH hosting in orders and subs by @charcey in #1095
• Add page_size arg to list_subscriptions() by @asonnenschein in #1096
• remove product bundles json from repo, and fetch it dynamically, add helper function to get valid item types and bundles in cli by @charcey in #1094

2.13.1

• Fix for a build issue with 2.13.0. 2.13.0 was not published to PyPi
• Add a unique User-Agent header when using the new Planet client

2.13.0

Planet sync client

This release includes a brand new, simplified Planet client class.

The Planet class has members data, subscriptions, and orders that together contain all the core SDK functionality found in the async clients. You no longer need to manage your own Sessions, switch between clients or use asyncio to interact with the Planet Python SDK.

All existing async SDK functionality is unchanged. Users can continue to use the async clients for asyncio applications.

Example Planet client usage:

from planet import Planet

pl = Planet()
for item in pl.data.search(['PSScene'], limit=5):
    print(item)

See the documentation for more info and examples! For bug reports and feedback, please create an issue.

2.12.0

• Add parameters to the subscriptions list command: --source-type, --created, --start-time, --end-time, --updated, --hosting, --name, --name-contains, and --sort-by.
• Add parameters to the orders list command: --source-type, --name, --name-contains, --created-on, --last-modified, --hosting, and --sort-by.
• Remove the unused limit parameter of SubscriptionsClient.get_results_csv

2.11.0

Added:

• Support for new Tanager item types and assets.

Updated:

• Development and release process documentation.