List every Biohotspot map layer with data within `km` of a point on the sea (a place being studied, not the user's location): habitats, wildlife, human uses, protected areas and world ocean maps, with a few values from each. Read-only. Use it to learn what a place holds.
输入参数kmlat必填lon必填
look_in_area
Look inside an area
List every Biohotspot map layer with data inside a polygon on the sea, with a few values from each. Read-only.
输入参数polygon必填
understand_area
Check an area against its targets
Check an area against its protection targets: which habitats it holds, how much of each, what is already protected, and how far each habitat is from its target. Give a polygon, or a point and radius_km. Outside Biohotspot's local planning data the answer comes from world maps and is marked rough: true. Read-only; nothing is saved.
输入参数latlonpolygonradius_km
simulate
Run the protection options (Marxan)
Run the Marxan optimiser on the example project's planning data (Exmouth Gulf, Western Australia only): the cheapest set of planning squares that meets every habitat target. `protect` = planning-square ids always included (understand_area returns them as `pus`); `target_pct` = one target for every habitat, in %. Takes a few seconds; returns the summary, each habitat's result and the best solution. Nothing is saved to your projects.
输入参数repsprotecttarget_pct
find_layers
Find map layers
Find Biohotspot map layers by words (e.g. 'seagrass', 'coral bleaching') among its 1,600+ world layers. Returns ids, names, categories and licences (25 by default); vector layers can then be read with get_features. Read-only.
输入参数limitquery必填
get_features
Read a layer's features
Get a vector layer's features as GeoJSON from Biohotspot's OGC API, optionally inside a bounding box [west, south, east, north]; up to `limit` features (500 by default, 5,000 at most). Collection ids: find_layers ids, or exmouth_<dataset> for the example project's open layers. Read-only.
输入参数bboxlimitcollection必填
get_marine_park
Australian marine park facts
Get the facts about an Australian marine park from its Biohotspot page: area, IUCN categories and named zones (CAPAD 2024), habitats, blue carbon and pressures measured inside it, each with its source and licence, and the page's address. Give part of the park's name; `state` (wa, qld, nsw, vic, sa, tas, nt, com for Commonwealth waters) narrows it. Several matches return the list to choose from; parks under 10 km² or without enough open data have no page. Read-only.
输入参数name必填state
search_papers
Search the research library
Search Biohotspot's research library (more than 5,200 papers and reports on coasts and marine habitats) for the words; returns titles, years and DOI links where known (10 by default, 50 at most). Read-only.
输入参数limitquery必填
list_projects
List your projects
List your Biohotspot projects and the ones shared with you: name, area, your role and how complete their data is. Read-only.
无需输入参数。
get_project
Read a project
Get one of your projects: its area (GeoJSON), its data check (each data type covered, partial or missing) and your role. Read-only.
输入参数project_id必填
list_project_data
Read a project's data
List the data a project's team added, with each file's status (receiving, checked, ready, failed). Read-only.
输入参数project_id必填
add_project_data
Add data to a project
Add data to a project from a public download link (GeoPackage, zipped Shapefile, GeoJSON, KML, CSV with coordinates or GeoTIFF, up to 200 MB): your own model's output, a survey, a map. Side effect: the file is downloaded, stored and added to the project, where its team can see it; nothing is deleted or overwritten. Biohotspot then checks it; follow its status with list_project_data and finish anything it asks for in the project's Uploads tab. Needs owner or editor rights.
输入参数url必填yeartitlesourcelicenceproject_id必填