GET /occurrence/tile/{x}/{y}/{z}.mvt
Summary: Fetch gridded occurrences for a tile as MVT.
Operation ID: —
Auth: unknown
Operation ID: —
Auth: unknown
Description
Fetch gridded occurrences for a tile as MVT.
Parameters (25)
absence
(string, query, optional)
Include absence records (include) or get absence records exclusively (true).
areaid
(string, query, optional)
Area ID.
cellspertile
(integer, query, optional)
Grid cells per tile in X direction (default 20).
datasetid
(string, query, optional)
Dataset UUID.
dropped
(string, query, optional)
Include dropped records (include) or get dropped records exclusively (true).
enddate
(string, query, optional)
End date formatted as YYYY-MM-DD.
enddepth
(integer, query, optional)
End depth, in meters.
event
(string, query, optional)
Include pure event records (include) or get pure event records exclusively (true).
exclude
(string, query, optional)
Comma separated list of quality flags to be excluded.
flags
(string, query, optional)
Comma separated list of quality flags which need to be set.
geometry
(string, query, optional)
Geometry, formatted as WKT or GeoHash.
hab
(boolean, query, optional)
HAB species only, true/false.
instituteid
(string, query, optional)
Institute ID.
margin
(integer, query, optional)
Tile margin in Geohash units (default 1).
nodeid
(string, query, optional)
Node UUID.
precision
(integer, query, optional)
Geohash precision (default adaptive based on zoom level and cellspertile).
redlist
(boolean, query, optional)
Red List species only, true/false.
startdate
(string, query, optional)
Start date formatted as YYYY-MM-DD.
startdepth
(integer, query, optional)
Start depth, in meters.
taxonid
(string, query, optional)
Taxon AphiaID.
tiletype
(string, query, optional)
Vector tile type (point or polygon, default polygon).
wrims
(boolean, query, optional)
WRiMS species only, true/false.
x
(number, path, required)
Longitude in decimal degrees.
y
(number, path, required)
Latitude in decimal degrees.
z
(integer, path, required)
Zoom level.
Examples (3)
| Title | Type | URL | Action |
|---|---|---|---|
| Basic tile at zoom level 2 | curl |
https://api.obis.org/occurrence/tile/1/1/2.mvt |
|
| Tile filtered by taxon and date range | curl |
https://api.obis.org/occurrence/tile/8/12/5.mvt?taxonid=127405&startdate=2020-01-01&enddate=2023-12-31 |
|
| Point tile with custom grid density | curl |
https://api.obis.org/occurrence/tile/4/6/3.mvt?tiletype=point&cellspertile=30&redlist=true |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:34:08.825407 | 200 | 166ms | |
| 2026-03-23 09:08:21.721797 | 200 | 125ms | |
| 2026-03-23 09:03:09.618401 | 200 | 106ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 09:08:21.721797 | 7079c957a1fa |
7cef87347cda |
| 2026-03-23 10:34:08.825407 | 7cef87347cda |
f744bc93fc8e |