maps module¶

maps module API:

map

Example usage:

from pygbif import maps
maps.map(taxonKey = 2435098)

maps API¶

maps.map(z=0, x=0, y=0, format='@1x.png', srs='EPSG:4326', bin=None, hexPerTile=None, style='classic.point', taxonKey=None, country=None, publishingCountry=None, publisher=None, datasetKey=None, year=None, basisOfRecord=None, **kwargs)¶

GBIF maps API

Parameters:

source – [str] Either density for fast, precalculated tiles, or adhoc for any search
z – [str] zoom level
x – [str] longitude
y – [str] latitude
format –
[str] format of returned data. One of:
- .mvt - vector tile
- @Hx.png - 256px raster tile (for legacy clients)
- @1x.png - 512px raster tile, @2x.png for a 1024px raster tile
- @2x.png - 1024px raster tile
- @3x.png - 2048px raster tile
- @4x.png - 4096px raster tile
srs –
[str] Spatial reference system. One of:
- EPSG:3857 (Web Mercator)
- EPSG:4326 (WGS84 plate caree)
- EPSG:3575 (Arctic LAEA)
- EPSG:3031 (Antarctic stereographic)
bin – [str] square or hex to aggregate occurrence counts into squares or hexagons. Points by default.
hexPerTile – [str] sets the size of the hexagons (the number horizontally across a tile)
squareSize – [str] sets the size of the squares. Choose a factor of 4096 so they tessalate correctly: probably from 8, 16, 32, 64, 128, 256, 512.
style – [str] for raster tiles, choose from the available styles. Defaults to classic.point.
taxonKey – [int] A GBIF occurrence identifier
datasetKey – [str] The occurrence dataset key (a uuid)
country – [str] The 2-letter country code (as per ISO-3166-1) of the country in which the occurrence was recorded. See here http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
basisOfRecord –

[str] Basis of record, as defined in the BasisOfRecord enum

http://gbif.github.io/gbif-api/apidocs/org/gbif/api/vocabulary/BasisOfRecord.html Acceptable values are
- FOSSIL_SPECIMEN An occurrence record describing a fossilized specimen.
- HUMAN_OBSERVATION An occurrence record describing an observation made by one or more people.
- LIVING_SPECIMEN An occurrence record describing a living specimen.
- MACHINE_OBSERVATION An occurrence record describing an observation made by a machine.
- MATERIAL_CITATION An occurrence record based on a reference to a scholarly publication.
- OBSERVATION An occurrence record describing an observation.
- OCCURRENCE An existence of an organism at a particular place and time. No more specific basis.
- PRESERVED_SPECIMEN An occurrence record describing a preserved specimen.
year – [int] The 4 digit year. A year of 98 will be interpreted as AD 98. Supports range queries, smaller,larger (e.g., 1990,1991, whereas 1991,1990 wouldn’t work)
publishingCountry – [str] The 2-letter country code (as per ISO-3166-1) of the country in which the occurrence was recorded.

Returns:

An object of class GbifMap

For mvt format, see https://github.com/tilezen/mapbox-vector-tile to decode, and example below

Usage:

from pygbif import maps
out = maps.map(taxonKey = 2435098)
out.response
out.path
out.img
out.plot()

out = maps.map(taxonKey = 2480498, year = range(2008, 2011+1))
out.response
out.path
out.img
out.plot()

# srs
maps.map(taxonKey = 2480498, year = 2010, srs = "EPSG:3857")
# bin
maps.map(taxonKey = 212, year = 1998, bin = "hex",
   hexPerTile = 30, style = "classic-noborder.poly")
# style
maps.map(taxonKey = 2480498, style = "purpleYellow.point").plot()
# basisOfRecord
maps.map(taxonKey = 2480498, year = 2010,
  basisOfRecord = "HUMAN_OBSERVATION", bin = "hex", 
  hexPerTile = 500).plot()
maps.map(taxonKey = 2480498, year = 2010, 
  basisOfRecord = ["HUMAN_OBSERVATION", "LIVING_SPECIMEN"],
  hexPerTile = 500, bin = "hex").plot()

# map vector tiles, gives back raw bytes
from pygbif import maps
x = maps.map(taxonKey = 2480498, year = 2010,
  format = ".mvt")
x.response
x.path
x.img # None
import mapbox_vector_tile
mapbox_vector_tile.decode(x.response.content)