Overview

Planet Analytics leverages computer vision to transform our imagery into Analytic Feeds that detect and classify objects, identify geographic features, and understand change over time across the globe. This user guide is intended to help users access the Analytic Feeds and leverage them to build applications and solutions.

Authentication

The Analytics API uses Basic HTTP Authentication and requires that you have a Planet API key. Currently, anyone can sign up for a free account on our website. Once you're signed up, you can find your API key in your account settings. Authenticate by setting username to your API key.

Authentication Via cURL:

curl --header "Authorization: api-key ${PL_API_KEY}" 
https://api.planet.com/analytics/

Analytics API

The Analytics API is a RESTful API interface to provide programmatic access to Planet Analytic Feeds. It enables search and retrieval of analytic results within the user’s subscription. Find details about the supported resources and operations in the API reference documentation.

Analytic Feeds

An Analytic Feed represents an analytic derived from Planet imagery. For example, a Road Detection Feed represents roads detected on monthly Planet Basemaps.

Subscriptions

Users have subscriptions to feeds in a specific Area of Interest (AOI) and Time Interval of Interest (TOI). For example, a subscription could be Road Detection over 12 months in San Francisco, California. Users can get a list of their subscriptions from the Analytics API.

Results

When new imagery is published in a user's subscription, Planet’s computer vision models process the imagery and its output is added to a collection of results associated with the subscription. For example, if a user has a subscription for the Vessel Detection Feed, newly published daily imagery within that subscription AOI will be processed and new ship detections will be added to the subscription results. For raster-based output like Building Detections, results representing the footprint and linking to the raster data are added to the collection of results.

Vector Results

Geojson outputs will be stored in Web Feature Service collections. Vessel detections will be served as vector features. Each feature in the feature collection from the API will reference an individual instance of a vessel detection.

Raster Results

GeoTIFF outputs containing the rasters of road and building detections will be served as links within a feature collection. Each feature in the feature collection from the Analytics API is a mosaic quad with links to the source (input for the analytic operation) and target (results of the analytic operation (ie, roads or building pixels).

Feature Collections results are ordered by creation date, with most recent collections listed first.

Web Map Tile Service

Road Detection and Building Detection outputs can also be accessed via a WMTS implementation. This enables users to stream the Road Detection and Building Detection rasters into standard GIS tools like QGIS. Learn how to leverage Planet’s WMTS in the tile service reference documentation.