Skip to main content

Basemaps API Reference

Planet Mosaics API (1.0)

Download OpenAPI specification:Download

An API to interact with Mosaics generated on Planet's platform.

Basemaps and Mosaics

List Mosaics

List all accessible mosaics.

query Parameters
_page
integer

Integer representing a specific page of results.

_page_size
integer

Number of results to return per page.

name__is
string

If provided, returns up to one result that exactly matches the provided value.

name__contains
string

If provided, returns only results that contain the fragment, case-insensitive.

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "mosaics": [
    ]
}

Get Mosaic

Get a mosaic by id.

path Parameters
mosaic_id
required
string

Mosaic identifier.

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "bands": 0,
  • "bbox": [
    ],
  • "coordinate_system": "string",
  • "datatype": "string",
  • "first_acquired": "2019-08-24T14:15:22Z",
  • "grid": {
    },
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "interval": "string",
  • "item_types": [
    ],
  • "last_acquired": "2019-08-24T14:15:22Z",
  • "level": 0,
  • "name": "string",
  • "product_type": "string",
  • "quad_download": true
}

Get Mosaic Grid

Get extended mosaic metadata by id.

path Parameters
mosaic_id
required
string

Mosaic identifier.

Responses

Response samples

Content type
application/json
{
  • "quad_size": 0,
  • "resolution": 0
}

Create a Mosaic Quad search

List of quad download links for a mosaic.

path Parameters
mosaic_id
required
string

Mosaic identifier.

query Parameters
minimal
boolean

If true, only return quad download links.

_page_size
integer

Number of results to return per page.

Request Body schema: application/json
required

Search request

object (Search)

Search is a valid GeoJSON Polygon or MultiPolygon with 1500 or fewer vertices.

Responses

Request samples

Content type
application/json
{
  • "coordinates": {
    },
  • "type": "Polygon"
}

Response samples

Content type
application/json
{
  • "field": {
    },
  • "general": [
    ]
}

Get Mosaic Quad

Get mosaic quad by id.

path Parameters
mosaic_id
required
string

Mosaic identifier.

quad_id
required
string

Quad identifier.

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "bbox": [
    ],
  • "id": "string",
  • "percent_covered": 0.1
}

Get Mosaic Quad URL

Get a full quad download URL quad id.

path Parameters
mosaic_id
required
string

Mosaic identifier.

quad_id
required
string

Quad identifier.

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

List Mosaic Quad Items

List items that contributed to a quad.

path Parameters
mosaic_id
required
string

Mosaic identifier.

quad_id
required
string

Quad identifier.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ]
}

Get Mosaic TileJSON

Get TileJSON for Mosaic. See https://github.com/mapbox/tilejson-spec

path Parameters
mosaic_id
required
string

Mosaic identifier.

Responses

Response samples

Content type
application/json
{ }

List Mosaic Series

List all mosaic series available to the authenticated user.

query Parameters
_page
integer

Integer representing a specific page of results.

_page_size
integer

Number of results to return per page.

name__is
string

If provided, returns up to one result that exactly matches the provided value.

name__contains
string

If provided, returns only results that contain the fragment, case-insensitive.

acquired__between
string

Acquired between comma separated dates or date-times

acquired__gt
string

Acquired greater than date or date-time

acquired__lt
string

Acquired less than date or date-time

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "series": [
    ]
}

Get Mosaic Series

Get a mosaic series by id.

path Parameters
series_id
required
string

Series identifier.

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "first_acquired": "2019-08-24T14:15:22Z",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "interval": "string",
  • "last_acquired": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "product_type": "basemap",
  • "selector": "string"
}

List Series' Mosaics

List mosaics in this series.

path Parameters
series_id
required
string

Series identifier.

query Parameters
acquired__between
string

Acquired between comma separated dates or date-times

acquired__gt
string

Acquired greater than date or date-time

acquired__lt
string

Acquired less than date or date-time

Responses

Response samples

Content type
application/json
{
  • "_links": {
    },
  • "mosaics": [
    ]
}