{"openapi":"3.1.0","info":{"title":"Maps API","description":"The mapping API provides [tiled web maps](https://en.wikipedia.org/wiki/Tiled_web_map) primarily intended for display on websites, making it straightforward to visualize GBIF content on interactive maps and overlay content from multiple sources.\n\n**Most users looking to analyze data will need to use the [Occurrence API](./occurrence).**\n\n
\n
\n Birds (Aves) in Australia.\n
\n\n## Feature overview\n\nThe following features are supported:\n* Map layers are available for a **country**, **dataset**, **taxon** (including species, subspecies or higher taxa), **publisher**, **publishing country** or **network**.\n These layers can be filtered by year range, basis of record and country.\n When using a taxon, the GBIF backbone taxonomy is used unless a `checklistKey` parameter is provided with the UUID of a supported checklist (only the Catalogue of Life is supported at the time of writing). * Data is returned as points, or \u201cbinned\u201d into hexagons or squares.\n* Four map projections are supported.\n* Tiles are available in vector format for client styling, or raster format with predefined styles.\n* Arbitrary search terms are also supported, though binning is required for these searches.\n\nThis service is intended for use with commonly used clients such as the [OpenLayers](https://openlayers.org/) or [Leaflet](https://leafletjs.com/) Javascript libraries, [Google Maps](https://developers.google.com/maps/), or some GIS software including [QGIS](https://www.qgis.org/). These libraries allow the GBIF layers to be visualized with other content, such as those coming from [web map service (WMS)](https://www.ogc.org/standard/wms/) providers. It should be noted that the mapping API is not a WMS service, nor does it support WFS capabilities.\n\nAn experimental [web map tile service definition](https://gbif.link/wmts-occurrence) (see [OGC WMTS](https://www.ogc.org/standard/wmts/)) is available, and works to some extent with QGIS and ArcGIS. However, our data does not fit the usual WMTS structure, so this is of limited use. Another [definition for the GBIF basemaps](https://gbif.link/wmts-base) is also available.\n## Tile formats\n\nTwo tile formats are available: **vector tiles** and **raster tiles**. The raster tiles are generated from the vector tiles.\n\nA modern web browser can show either format. The styling of vector tiles is determined by client-side configuration (e.g. Javascript); raster tiles are styled according to a limited set of GBIF styles. *Point* vector tiles are usually larger than an equivalent raster tile and can often be slow to render. Simple vector tiles (few points, or any number of squares or hexagons) are small, fast to render, and can make zooming in and out smoother.\n\nVector tiles use [Mapbox Vector Tile format](https://www.mapbox.com/vector-tiles/), and contain a single layer `occurrence`. Objects in that layer are either points (default) or polygons (if chosen). Each object has a `total` value; that is the number of occurrences at that point or in the polygon.\n\nRaster tiles are provided in PNG format, and are normally 512px wide squares.\n\n## Example queries\n\n| Description | Sample | Live demo |\n|-------------|--------|-----------|\n| All occurrences \u2014 no additional parameters
`https://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.png?style=green.point` | | \n| All birds (*Aves*) by small hexagons, EPSG:4326 projection
`https://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.png?srs=EPSG:4326&taxonKey=212&bin=hex&hexPerTile=117&style=green-noborder.poly` | | \n| All birds observed by machine between 2015 and 2017 as squares, EPSG:4326 projection
`https://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.png?srs=EPSG:4326&taxonKey=212&basisOfRecord=MACHINE_OBSERVATION&years=2015,2017&bin=square&squareSize=128&style=purpleYellow-noborder.poly` | | \n| All occurrences from 2000 onwards published by American publishers
`https://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.png?publishingCountry=US&year=2000,2030&style=fire.point` | | \n| *Fulmarus glacialis* (northern fulmar) observations, in Arctic projection
`https://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.png?srs=EPSG:3575&taxonKey=2481433&basisOfRecord=HUMAN_OBSERVATION&basisOfRecord=MACHINE_OBSERVATION&style=classic.point` | | \n| Ad-hoc query for fungi with images, and without detected geospatial issues
`https://api.gbif.org/v2/map/occurrence/adhoc/{z}/{x}/{y}@1x.png?srs=EPSG:4326&mode=GEO_CENTROID&taxonKey=6&hasGeospatialIssue=false&mediaType=StillImage&style=scaled.circles` | | \n\nSee also [further examples and demos](https://api.gbif.org/v2/map/demo.html), and an example using [CodePen](https://codepen.io/hofft/pen/GRROjmo)\n\n## Projections\n\nThe projection defines how coordinates on Earth are transformed to a two-dimensional surface.\n\nThe tile schema defines how that two dimensional surface is split into smaller square images, and how those images are addressed.\n\nUp to four projections are available, depending on the endpoint. Information on the projections is available on the [GBIF base map tiles](https://tile.gbif.org/ui/) page.\n\n## Map styling\n\nVector tiles must by styled by the client.\n\nRaster styles are predefined, and chosen with the `style=` parameter. All available styles are shown below. Note the styles labelled \u201capproimate\u201d are not intended for precise analysis.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n
StyleRecord count
1\u20131011\u2013100101\u201310001001\u20131000010001\u2013100000100001+
Classic
classic.point

classic.poly

classic-noborder.poly
Purple-yellow
purpleYellow.point

purpleYellow.poly

purpleYellow-noborder.poly
Green
green.point

green.poly

green-noborder.poly
Heat
purpleHeat.point		Approximate

blueHeat.point		Approximate

orangeHeat.point		Approximate

greenHeat.point		Approximate
Fire
fire.point		Approximate
Glacier
glacier.point		Approximate
Green 2
green2.poly

green2-noborder.poly
iNaturalist
iNaturalist.poly
Purple-white
purpleWhite.poly
Red
red.poly
Marker
blue.marker

orange.marker

outline.poly
Geo-centroid
scaled.circles
\n\n## Base map tiles\n\nBase map tiles showing land and oceans, forests, roads and so on are available at [tile.gbif.org](https://tile.gbif.org/) for users of this API.\n\n## Further resources\n\n* [Base map examples](https://tile.gbif.org/ui/)\n* [Raster style demos](https://api.gbif.org/v2/map/demo.html)\n* [OpenLayers-based toolbox](https://api.gbif.org/v2/map/debug/ol/)\n","termsOfService":"https://www.gbif.org/terms","version":"v2"},"servers":[{"url":"https://api.gbif.org/v2/","description":"Production"},{"url":"https://api.gbif-uat.org/v2/","description":"User testing"}],"tags":[{"name":"Occurrence maps","description":"This API provides pre-calculated and ad-hoc occurrence map tiles.","x-Order":{"Order":"0100"}}],"paths":{"/map/occurrence/density/{z}/{x}/{y}{format}":{"get":{"tags":["Occurrence maps"],"summary":"Precalculated density tile","description":"Retrieves a tile showing occurrence locations in [Mapbox Vector Tile format](https://www.mapbox.com/vector-tiles/)\n\nTiles contain a single layer `occurrence`. Features in that layer are either points (default) or polygons (if chosen). Each feature has a `total` value; that is the number of occurrences at that point or in the polygon.\n\n**One primary search parameter is permitted**, from these: `taxonKey`, `datasetKey`, `country`, `networkKey`, `publishingOrg`, `publishingCountry`.\n\nThis can be combined with the parameter `country`, this limits the primary search to occurrences in that country.\n\n","operationId":"getDensityTile","parameters":[{"name":"z","in":"path","description":"Zoom level","required":true,"schema":{"type":"string","maximum":16,"minimum":0}},{"name":"x","in":"path","description":"Tile map column. 0 is the leftmost column, at the rightmost column `x == 2\u1dbb \u2013 1`, except for EPSG:4326 projection where `x == 2\u1dbb\u207a\u00b9 \u2013 1`","required":true,"schema":{"type":"string","minimum":0}},{"name":"y","in":"path","description":"Tile map row. 0 is the top row, for the bottom row `y == 2\u1dbb \u2013 1`.","required":true,"schema":{"type":"string","minimum":0}},{"name":"srs","in":"query","description":"Map projection. One of\n* `EPSG:3857` (Web Mercator)\n* `EPSG:4326` (WGS84 plate care\u00e9)\n* `EPSG:3575` (Arctic LAEA)\n* `EPSG:3031` (Antarctic stereographic)\nSee [Projections](#projections)","required":true,"schema":{"type":"string","enum":["EPSG:3857","EPSG:4326","EPSG:3575","EPSG:3031"]}},{"name":"basisOfRecord","in":"query","description":"Basis of record, as defined in our BasisOfRecord vocabulary.\n\nThe parameter may be repeated to retrieve occurrences with any of the chosen bases of record.","required":false,"explode":true,"schema":{"type":"array","items":{"type":"string","description":"The values of the Darwin Core term Basis of Record which can apply to occurrences.\n\nSee GBIF's [Darwin Core Type Vocabulary](https://rs.gbif.org/vocabulary/dwc/basis_of_record.xml) for definitions.","enum":["PRESERVED_SPECIMEN","FOSSIL_SPECIMEN","LIVING_SPECIMEN","OBSERVATION","HUMAN_OBSERVATION","MACHINE_OBSERVATION","MATERIAL_SAMPLE","LITERATURE","MATERIAL_CITATION","OCCURRENCE","UNKNOWN"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/basic/BasisOfRecord"},"uniqueItems":true},"uniqueItems":true}},{"name":"year","in":"query","description":"The 4 digit year or year range. A year of 98 will be interpreted as 98 AD.\n\nRanges are written as `1990,2000`, `1990,` or `,1900`.","required":false,"schema":{"type":"string"}},{"name":"verbose","in":"query","description":"If set, counts will be grouped by year to allow a fast view of different years. If unset (the default), the total will be a count for all years.","required":false,"schema":{"type":"boolean"}},{"name":"bin","in":"query","description":"Binning style. `hex` will aggregate points into a hexagonal grid (see `hexPerTile`). `square` will aggregate into a square grid (see `squareSize`).","required":false,"schema":{"type":"string","enum":["hex","square"]}},{"name":"hexPerTile","in":"query","description":"With `bin=hex`, sets the number of hexagons horizontally across a tile.","required":false,"schema":{"type":"integer","format":"int32","default":51}},{"name":"squareSize","in":"query","description":"With `bin=square`, sets the size of the squares in pixels on a 4096px tile. Choose a factor of 4096 so they tessalete correctly.","required":false,"schema":{"type":"string","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096"]}},{"name":"style","in":"query","description":"Raster map style \u2014 only applies to raster (PNG) tiles.\n\nChoose from one of the available styles, the default is `classic.point`.\n\nStyles ending with `.point` should only be used by non-binned tiles. Styles ending with `.poly` or `.marker.` should be used with hexagonal- or square-binned tiles.\n\nSee [map styles](#section/Map-styling).","schema":{"type":"string","enum":["purpleHeat.point","blueHeat.point","orangeHeat.point","greenHeat.point","classic.point","purpleYellow.point","green.point","fire.point","glacier.point","classic.poly","classic-noborder.poly","purpleYellow.poly","purpleYellow-noborder.poly","green.poly","green-noborder.poly","green2.poly","iNaturalist.poly","purpleWhite.poly","red.poly","blue.marker","orange.marker","outline.poly","scaled.circles"]}},{"name":"country","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the country in which the occurrence was recorded.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"taxonKey","in":"query","description":"A taxon key from the GBIF backbone.","schema":{"type":"integer","format":"int32","minimum":0}},{"name":"datasetKey","in":"query","description":"The occurrence dataset key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingOrg","in":"query","description":"The publishing organization's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingCountry","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the owning organization's country.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"networkKey","in":"query","description":"The network's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Map tile.","content":{"application/x-protobuf":{"example":null},"image/png":{"example":null}}},"204":{"description":"Empty map tile."},"400":{"description":"Incorrect request."}}}},"/map/occurrence/density/capabilities.json":{"get":{"tags":["Occurrence maps"],"summary":"Summary of a density tile map query","description":"A summary of the data available for a [density tile](#operation/getDensityTile) query.\n\nIt accepts the same search parameters as the density tile query.","operationId":"getDensityCapabilities","parameters":[{"name":"basisOfRecord","in":"query","description":"Basis of record, as defined in our BasisOfRecord vocabulary.\n\nThe parameter may be repeated to retrieve occurrences with any of the chosen bases of record.","explode":true,"schema":{"type":"array","items":{"type":"string","description":"The values of the Darwin Core term Basis of Record which can apply to occurrences.\n\nSee GBIF's [Darwin Core Type Vocabulary](https://rs.gbif.org/vocabulary/dwc/basis_of_record.xml) for definitions.","enum":["PRESERVED_SPECIMEN","FOSSIL_SPECIMEN","LIVING_SPECIMEN","OBSERVATION","HUMAN_OBSERVATION","MACHINE_OBSERVATION","MATERIAL_SAMPLE","LITERATURE","MATERIAL_CITATION","OCCURRENCE","UNKNOWN"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/basic/BasisOfRecord"},"uniqueItems":true},"uniqueItems":true}},{"name":"country","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the country in which the occurrence was recorded.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"taxonKey","in":"query","description":"A taxon key from the GBIF backbone.","schema":{"type":"integer","format":"int32","minimum":0}},{"name":"datasetKey","in":"query","description":"The occurrence dataset key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingOrg","in":"query","description":"The publishing organization's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingCountry","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the owning organization's country.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"networkKey","in":"query","description":"The network's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"year","in":"query","description":"The 4 digit year or year range. A year of 98 will be interpreted as 98 AD.\n\nRanges are written as `1990,2000`, `1990,` or `,1900`."}],"responses":{"200":{"description":"Map capabilities details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}},"400":{"description":"Invalid search request."}}}},"/map/occurrence/adhoc/{z}/{x}/{y}{format}":{"get":{"tags":["Occurrence maps"],"summary":"Ad-hoc search tile","description":"Retrieves a tile showing occurrence locations in [Mapbox Vector Tile format](https://www.mapbox.com/vector-tiles/)\n\nTiles contain a single layer `occurrence`. Features in that layer are either points (default) or polygons (if chosen). Each feature has a `total` value; that is the number of occurrences at that point or in the polygon.\n\nAny search parameter allowed by the [occurrence search](/en/openapi/v1/occurrence#tag/Searching-occurrences/operation/searchOccurrence) is supported.","operationId":"getAdHocTile","parameters":[{"name":"z","in":"path","description":"Zoom level","required":true,"schema":{"type":"string","maximum":16,"minimum":0}},{"name":"x","in":"path","description":"Tile map column. 0 is the leftmost column, at the rightmost column `x == 2\u1dbb \u2013 1`, except for EPSG:4326 projection where `x == 2\u1dbb\u207a\u00b9 \u2013 1`","required":true,"schema":{"type":"string","minimum":0}},{"name":"y","in":"path","description":"Tile map row. 0 is the top row, for the bottom row `y == 2\u1dbb \u2013 1`.","required":true,"schema":{"type":"string","minimum":0}},{"name":"srs","in":"query","description":"Map projection. One of\n* `EPSG:3857` (Web Mercator)\n* `EPSG:4326` (WGS84 plate care\u00e9)\n* `EPSG:3575` (Arctic LAEA)\n* `EPSG:3031` (Antarctic stereographic)\nSee [Projections](#projections)","required":true,"schema":{"type":"string","enum":["EPSG:3857","EPSG:4326","EPSG:3575","EPSG:3031"]}},{"name":"bin","in":"query","description":"Binning style. `hex` will aggregate points into a hexagonal grid (see `hexPerTile`). `square` will aggregate into a square grid (see `squareSize`).","required":false,"schema":{"type":"string","enum":["hex","square"]}},{"name":"hexPerTile","in":"query","description":"With `bin=hex`, sets the number of hexagons horizontally across a tile.","required":false,"schema":{"type":"integer","format":"int32","default":51}},{"name":"squareSize","in":"query","description":"With `bin=square`, sets the size of the squares in pixels on a 4096px tile. Choose a factor of 4096 so they tessalete correctly.","required":false,"schema":{"type":"string","enum":["1","2","4","8","16","32","64","128","256","512","1024","2048","4096"]}},{"name":"mode","in":"query","description":"Sets the search mode. `GEO_BOUNDS` is the default, and returns rectangles that bound all the occurrences in each bin. `GEO_CENTROID` instead returns a point at the weighted centroid of the bin.","schema":{"type":"string","enum":["GEO_BOUNDS","GEO_CENTROID"]}},{"name":"style","in":"query","description":"Raster map style \u2014 only applies to raster (PNG) tiles.\n\nChoose from one of the available styles, the default is `classic.point`.\n\nStyles ending with `.point` should only be used by non-binned tiles. Styles ending with `.poly` or `.marker.` should be used with hexagonal- or square-binned tiles.\n\nSee [map styles](#section/Map-styling).","schema":{"type":"string","enum":["purpleHeat.point","blueHeat.point","orangeHeat.point","greenHeat.point","classic.point","purpleYellow.point","green.point","fire.point","glacier.point","classic.poly","classic-noborder.poly","purpleYellow.poly","purpleYellow-noborder.poly","green.poly","green-noborder.poly","green2.poly","iNaturalist.poly","purpleWhite.poly","red.poly","blue.marker","orange.marker","outline.poly","scaled.circles"]}},{"name":"basisOfRecord","in":"query","description":"Basis of record, as defined in our BasisOfRecord vocabulary.\n\nThe parameter may be repeated to retrieve occurrences with any of the chosen bases of record.","explode":true,"schema":{"type":"array","items":{"type":"string","description":"The values of the Darwin Core term Basis of Record which can apply to occurrences.\n\nSee GBIF's [Darwin Core Type Vocabulary](https://rs.gbif.org/vocabulary/dwc/basis_of_record.xml) for definitions.","enum":["PRESERVED_SPECIMEN","FOSSIL_SPECIMEN","LIVING_SPECIMEN","OBSERVATION","HUMAN_OBSERVATION","MACHINE_OBSERVATION","MATERIAL_SAMPLE","LITERATURE","MATERIAL_CITATION","OCCURRENCE","UNKNOWN"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/basic/BasisOfRecord"},"uniqueItems":true},"uniqueItems":true}},{"name":"country","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the country in which the occurrence was recorded.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"taxonKey","in":"query","description":"A taxon key from the GBIF backbone.","schema":{"type":"integer","format":"int32","minimum":0}},{"name":"datasetKey","in":"query","description":"The occurrence dataset key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingOrg","in":"query","description":"The publishing organization's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"publishingCountry","in":"query","description":"The 2-letter country code (as per ISO-3166-1) of the owning organization's country.","schema":{"type":"string","enum":["AF","AX","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CW","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","US","UM","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AA","XK","XZ","ZZ"],"externalDocs":{"description":"API call to retrieve all official values.","url":"https://api.gbif.org/v1/enumeration/country"}}},{"name":"networkKey","in":"query","description":"The network's GBIF key (a UUID).","schema":{"type":"string","format":"uuid"}},{"name":"year","in":"query","description":"The 4 digit year or year range. A year of 98 will be interpreted as 98 AD.\n\nRanges are written as `1990,2000`, `1990,` or `,1900`."}],"responses":{"200":{"description":"Map tile.","content":{"application/x-protobuf":{"example":null},"image/png":{"example":null}}},"204":{"description":"Empty map tile."},"400":{"description":"Incorrect request."}}}}},"components":{"schemas":{"Capabilities":{"type":"object","properties":{"minLat":{"type":"integer","format":"int32","description":"The lowest latitude of occurrences covered by the query"},"maxLat":{"type":"integer","format":"int32","description":"The highest latitude of occurrences covered by the query"},"minLng":{"type":"integer","format":"int32","description":"The lowest longitude of occurrences covered by the query.\n\nFor clusters of occurrences centered around the antimeridian (180\u00b0 longitude) the `minLng` and `maxLng` will have a value just below 180\u00b0 and above 180\u00b0."},"maxLng":{"type":"integer","format":"int32","description":"The highest longitude of occurrences covered by the query.\n\nFor clusters of occurrences centered around the antimeridian (180\u00b0 longitude) the `minLng` and `maxLng` will have a value just below 180\u00b0 and above 180\u00b0."},"minYear":{"type":"integer","format":"int32","description":"The lowest year of occurrences covered by the query."},"maxYear":{"type":"integer","format":"int32","description":"The highest year of occurrences covered by the query."},"total":{"type":"integer","format":"int64","description":"The number of occurrences covered by the whole map."},"generated":{"type":"string","description":"The time the map tile was generated. Tiles are cached for hours to days, depending on the processing required to produce them."}}}}}}