Skip to content

Latest commit

 

History

History
56 lines (35 loc) · 2.21 KB

quick-start-guide.md

File metadata and controls

56 lines (35 loc) · 2.21 KB
title
Python SDK Quick Start

The Planet SDK for Python makes it easy to access Planet’s massive repository of satellite imagery and add Planet data to your data ops workflow.

Note: This is the new, non-asyncio client. If you want to take advantage of asyncio, see the async client guide. For the no-code CLI client, see the CLI guide.

Your feedback on this version of our client is appreciated. Please raise an issue on GitHub if you encounter any problems.

Dependencies

This package requires Python 3.9 or greater. A virtual environment is strongly recommended.

You will need your Planet API credentials. You can find your API key in Planet Explorer under Account Settings.

Installation

Install from PyPI using pip:

pip install planet

Usage

Authentication

Use the planet auth CLI command to establish a user login session that will be saved to the user's home directory. For other authentication options, see the Client Authentication Guide.

planet auth login

The Planet client

The Planet class is the main entry point for the Planet SDK. It provides access to the various APIs available on the Planet platform.

from planet import Planet
pl = Planet()  # automatically detects authentication configured by `planet auth login`

The Planet client has members data, orders, and subscriptions, which allow you to interact with the Data API, Orders API, and Subscriptions API. Usage examples for searching, ordering and creating subscriptions can be found in the SDK guide.

How to Get Help

As The Planet SDK (V2) is in active development, features & functionality will continue to be added.

If there's something you're missing or are stuck, the development team would love to hear from you.