Global Biodiversity Information Facility

Base Map Tiles

Information

GBIF hosts map tiles in four projections, for use on GBIF.org and by users of our API. We serve vector tiles based on the OpenMapTiles.org schema, and from these generate raster tiles in several styles. Both the vector and raster tiles are available for public use.

For information on occurrence map tiles, see the GBIF Maps API.

Data schema and sources

The Web Mercator tiles are simply those from OpenMapTiles.org, see the OpenMapTiles schema (v3.6) for details. The other projections have been generated to fit the same layer schema, but with fewer layers — see below.

Web Mercator tiles are from 2017-07-03.

The other projections use OpenStreetMap and Natural Earth data. We do not plan to make frequent updates to the tiles, since the geological features of most interest to us do not often change.

WGS84 tiles are from OpenStreetMap as of 2017-08-28, and Natural Earth version 2.0.0.

Arctic (3575) tiles are from OpenStreetMap as of 2019-01, and Natural Earth version 2.0.0.

Antarctic (3031) tiles are from OpenStreetMap as of 2017-08-28, and Natural Earth version 2.0.0.

Vector Tiles

The schema for the vector tile layers follows the OpenMapTiles schema, but with fewer layers included for the non-Mercator projections. In addition, the Arctic LAEA projection includes a world_extent layer, with a polygon for the Northern Hemisphere, and a graticules layer, containing a lines for 45°N and the Arctic Circle.

Vector tiles can be styled in the browser. For a general overview of vector tiles, see the OpenMapTiles documentation.

Projection Layers in “omt” vector tiles
world_extent graticules water waterway landcover landuse mountain_peak park boundary aeroway transportation building water_name transportation_name place housenumber poi
EPSG:3857
EPSG:4326
EPSG:3575
EPSG:3031

Raster Styles

Eight raster styles are available, they can be used with any of the projections, but will only have the layers that exist in that projection.

The “GBIF Geyser”, “GBIF Tuatara”, “GBIF Violet”, “OSM Bright” and “GBIF Natural” styles are available with labels in several languages. The default is for labels to be in the local language(s) of the country. Use the style names like gbif-geyser-XX, where XX should be replaced with ar, da, de, en, es, fr, ja, pt, ru or zh to have the labels translated, where possible.

Usage

URLs take this format: https://tile.gbif.org/{srs}/{tileset}/{z}/{x}/{y}{format}{params}

srs
The spatial reference system; one of 4326, 3857, 3575 or 3031.
tileset
The tileset, omt.
z, x, y
The zoom, column and row of the tile. The origin is the top left, so the top left tile always has x=0 and y=0.
format
Either .pbf for a vector tile, or @1x.png, @2x.png, @3x.png, @4x.png for PNG tiles at various pixel densities. Use higher pixel densities for high resolution screens, otherwise the tiles will appear fuzzy.
params
Only for PNG tiles, specify a style, for example ?style=gbif-classic.

Tiles are available over either HTTPS or HTTP, but HTTPS is recommended to take advantage of HTTP/2.

Web Mercator tiles use the standard Google/OpenStreetMap tile schema; at zoom zero a single tile covers the Earth between -180° to +180°, and -85.06° to 85.06°. The default tile size for PNG tiles is 512×512px.

There is no universal standard for the other projections, so you will need to use these parameters:

Projection Extent of zoom zero in projection units
(left, top, right, bottom)
Tile(s) at zoom zero
EPSG:4326
(WGS84)
–180°, 90°, 180°, –90°  
EPSG:3575
(Arctic LAEA on 10°E)
The northern hemisphere:
–6371007.2 √2, 6371007.2 √2, 6371007.2 √2, –6371007.2 √2
EPSG:3031
(Antarctic stereographic)
The southern hemisphere:
–12367396.2185, 12367396.2185, 12367396.2185, –12367396.2185

If you are using OpenLayers or Leaflet, it will be best to look at the examples.

Examples

The OpenLayers minimal pages show only a GBIF raster base layer. Start here if you are new to OpenLayers, and start with the Web Mercator projection if you are new to web maps in general.

The OpenLayers demo links show the GBIF base vector layer and GBIF base raster layers, plus a non-GBIF base layer, and two GBIF occurrence density layers — one raster and one vector.

The Leaflet map uses the Leaflet library. Support for non-Mercator projections uses a plugin and is buggy, but for simple Web Mercator maps performance may be better than OpenLayers.

Static (non-interactive) maps can be displayed using HTML and some CSS:

For further examples of GBIF maps with occurrence data, see Occurrence Map examples.

Feedback and issues

The process used by GBIF to generate the tiles in the three other projections is on GitHub. Please log issues there, or use the GBIF API Users mailing list.

Credits and copyright

Map data and cartography:

Thanks also to: