cartopy.io.img_tiles.MapboxStyleTiles#

class cartopy.io.img_tiles.MapboxStyleTiles(access_token, username, map_id, cache=False)[source]#

Implement web tile retrieval from a user-defined Mapbox style. For more details on Mapbox styles, see https://www.mapbox.com/studio-manual/overview/map-styling/.

For terms of service, see https://www.mapbox.com/tos/.

__init__(access_token, username, map_id, cache=False)[source]#

Set up a new instance to retrieve tiles from a Mapbox style.

Access to Mapbox web services requires an access token and a map ID. See https://www.mapbox.com/api-documentation/ for details.

Parameters:

  • access_token – A valid Mapbox API access token.

  • username – The username for the Mapbox user who defined the Mapbox style.

  • map_id – A map ID for a map defined by a Mapbox style. This is the map whose tiles will be retrieved through this process. Note that this style may be private and if your access token does not have permissions to view this style, then map tile retrieval will fail.

Methods

__init__(access_token, username, map_id[, cache])

Set up a new instance to retrieve tiles from a Mapbox style.

find_images(target_domain, target_z[, ...])

Target domain is a shapely polygon in native coordinates.

get_image(tile)

image_for_domain(target_domain, target_z)

subtiles(x_y_z)

tile_bbox(x, y, z[, y0_at_north_pole])

Return the (x0, x1), (y0, y1) bounding box for the given x, y, z tile position.

tileextent(x_y_z)

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