Planet SDK for Python

The Planet Software Development Kit (SDK) for Python provides both a Python API and a command-line interface (CLI) to make use of the Planet APIs. Everything you need to get started is found in our online documentation.

Version 2.0 includes support for the core workflows of the following APIs:

• Data - Search for imagery from Planet's data catalog.
• Orders - Process and download or deliver imagery.
• Subscriptions - Set up a search to auto-process and deliver imagery.

After the initial 2.0 release there will be additional work to support the remaining Planet APIs: basemaps, tasking and analytics.

Versions and Stability

The SDK follows Semantic Versioning and therefore only major releases should break compatibility. Minor versions may include new functionality and patch versions address bugs or trivial changes (like documentation).

If depending upon official packages from PyPI, a developer should feel comfortable specifying planet == 2.* unless depending on a specific feature introduced at a minor version, in which case planet == 2.x.* (where x is the minor version of the new feature) should suffice.

The default branch is always main and should be considered in-development but with tests and other build steps succeeding.

Installation and Quick Start

The Planet SDK for Python is hosted on PyPI and can simply be installed via:

pip install planet

To install from source, first clone this repository, then navigate to the root directory (where setup.py lives) and run:

pip install .

Note that the above commands will install the Planet SDK into the global system Python unless a virtual environment is enabled. For more information on configuring a virtual environment from system Python, see the official Python venv documentation. For users who are running multiple versions of Python via pyenv, see the pyenv-virtualenv extension documentation.

Detailed installation instructions for the Planet SDK can be found in the Quick Start Guide of the documentation.

Contributing and Development

To contribute or develop with this library, see CONTRIBUTING.md.

Documentation

Documentation is currently hosted online It should be considered 'in progress', with many updates to come. It can also be built and hosted locally (see CONTRIBUTING.md) or can be read from source in the docs directory.

Authentication

Planet's APIs require an account for use. To get started you need to Get a Planet Account.