cartopy.io.img_tiles.StadiaMapsTiles#

class cartopy.io.img_tiles.StadiaMapsTiles(apikey, style='alidade_smooth', resolution='', cache=False)[source]#

Retrieves tiles from stadiamaps.com.

For a full reference on the styles available please see https://docs.stadiamaps.com/themes/. A few of the specific styles that are made available are alidade_smooth, stamen_terrain and osm_bright.

Using the Stadia Maps API requires including an attribution. Please see https://docs.stadiamaps.com/attribution/ for details.

For most styles that means including the following attribution:

© Stadia Maps © OpenMapTiles © OpenStreetMap contributors

with Stamen styles additionally requiring the following attribution:

© Stamen Design

Parameters:

  • apikey (str, required) – The authentication key provided by Stadia Maps to query their APIs

  • style (str, optional) – Name of the desired style. Defaults to alidade_smooth. See https://docs.stadiamaps.com/themes/ for a full list of styles.

  • resolution (str, optional) – Resolution of the images to return. Defaults to an empty string, standard resolution (256x256). You can also specify “@2x” for high resolution (512x512) tiles.

  • cache (bool or pathlib.Path or str, optional) – To allow offline use, as well as not spam tile providers, Cartopy can create a local cache of previously fetched tiles. The default path is cartopy.config["cache_dir"]. If it is set to True, the default path is used. If it is set to a custom path, then this path is used instead of the default one. If it is set to False, the tiles are downloaded each time.

find_images(target_domain, target_z, start_tile=(0, 0, 0))#

Target domain is a shapely polygon in native coordinates.

tile_bbox(x, y, z, y0_at_north_pole=True)#

The (x0, x1), (y0, y1) bounding box for the given tile position.

Parameters:

  • x (int) – The x tile coordinate in the Google tile numbering system.

  • y (int) – The y tile coordinate in the Google tile numbering system.

  • z (int) – The z tile coordinate in the Google tile numbering system.

  • y0_at_north_pole (bool, optional) – Boolean representing whether the numbering of the y coordinate starts at the north pole (as is the convention for Google tiles) or not (in which case it will start at the south pole, as is the convention for TMS). Defaults to True.

tileextent(x_y_z)#

Return extent tuple (x0,x1,y0,y1) in Mercator coordinates.