Tile Services

The API Tile Service and Basemap Tile Service make is easy to visualize Planet imagery in desktop or web mapping applications that support either the XYZ or WMTS protocol. These services offer a low-friction way for web developers and GIS analysts to interact with, and derive value from Planet imagery without the need for further image processing.

Authentication

A valid Planet account is required to access either of the tile services. Authentication is achieved by providing a valid api_key as a query parameter to all tile requests.

NOTE: Permissions Required

For all Planet tile services, you must have permission to access the specific resource requested, otherwise the tile request will return a 404 error.

Tile Service URLs

The Planet tile services serve tiles using the following domains: https://tiles0.planet.com https://tiles1.planet.com https://tiles2.planet.com https://tiles3.planet.com

Using multiple subdomains allows more tiles to load concurrently in web browsers. Libraries like OpenLayers and Leaflet provide support to easily make use of all subdomains by providing the proper string patterns.

API Tile Service

The API Tile Service acts an extension to the Planet API by allowing visualization of assets available in Planet's item archive as tiles. The tiled imagery returned by this service is a compressed version of the high-quality visual asset, making is easy to incorporate into any supporting client. At this time, only clients supporting the XYZ tile protocol are supported.

API Tile Service Request Structure

https://tiles{0-3}.planet.com/data/v1/{item_type}/{item_id}/{z}/{x}/{y}.png?api_key={api-key}
Parameter Value
item_type Item type of the item to view.
item_id Item id of the item to view.
z Tile zoom level.
x Tile row in the grid.
y Tile column in the grid

As an example, a complete URL for a tile request for the PSScene3Band item with an id of 20161221_024131_0e19 would look like the following:

API Tile Service Example

  https://tiles1.planet.com/data/v1/PSScene3Band/20161221_024131_0e19/14/12915/8124.png?api_key={api-key}

Basemap Tile Service

The Basemap Tile Service provides access to tiles for any of Planets color corrected weekly or monthly global mosaics. The Basemap Tile Service works with any client that supports either the XYZ or the WMTS protocol.

XYZ Basemap Tile Service

XYZ Basemap Tile Service Request Structure

https://tiles{0-3}.planet.com/basemaps/v1/planet-tiles/{mosaic_name}/gmap/{z}/{x}/{y}.png?api_key={api-key}
Parameter Value
mosaic_name The name of mosaic.
z Tile zoom level.
x Tile row in the grid.
y Tile column in the grid.

As an example, a complete URL for a tile request for the global mosaic global_monthly_2016_05_mosaic would look like the following:

XYZ Basemap Tile Service Example

https://tiles0.planet.com/basemaps/v1/planet-tiles/global_monthly_2016_05_mosaic/gmap/0/0/0.png?api_key={api-key}

WMTS Basemap Tile Service

The Planet WMTS Basemap Service allows users to access a listing of Planet's entire catalog of basemaps.

WMTS Catalog Access Request Structure

https://api.planet.com/basemaps/v1/mosaics/wmts?api_key={api-key}

XYZ Protocol Overview

The XYZ protocol describes how a mapping client (often from within a browser) can access tiled imagery. This is the same protocol that Planet Explorer uses to display tiled imagery. It provide a pyramid of tiles at 16 zoom levels so that it can efficiently be displayed in web browsers. As with other XYZ tiling services, Planet XYZ tiles have these attributes:

  • Tiles are 256 × 256 pixels.
  • Tiles use the Web Mercator coordinate reference system (EPSG:3857).
  • Tiles are available between zoom levels 0 and 15.
  • Tiles are rendered in the PNG format with an alpha channel for transparency.
  • Grid is a rectangle with 2*z rows and 2*z columns, where z is the zoom level.
  • Grid uses 0,0 as the top, left corner in the grid.
  • Tiles are found at the path z/x/y.png, where z is the zoom level, and x and y are the positions in the tile grid.

WMTS Protocol Overview

The WMTS protocol is similar to the XYZ protocol, but has a broader set of compatible 3rd party applications. It adds a uniform catalog protocol allowing discovery and display of tiled imagery. It provides a pyramid of tiles at 16 zoom levels so that it can be easily displayed in web browsers and various other clients. Planet's WMTS services are compatible with QGIS desktop, ArcGIS Pro, ArcOnline, CesiumJS and others. As with other WMTS tiling services, Planet WMTS tiles have these attributes:

  • Tiles are 256 × 256 pixels.
  • Tiles use the Web Mercator coordinate reference system (EPSG:3857).
  • Tiles are available between zoom levels 0 and 15.
  • Tiles are rendered in the PNG format with an alpha channel for transparency.
  • Grid is a rectangle with 2*z rows and 2*z columns, where z is the zoom level.
  • Grid uses 0,0 as the top, left corner in the grid.