BGS Documentation

To make our data more FAIR, BGS have made a selection of our Open Data available as an API using the OGCAPI-Features standard at https://ogcapi.bgs.ac.uk/. This is targeted at academics, developers, data scientists & geospatial specialists who would like to work with our data programmatically using R/Python etc or would like a live connection to frequently updated datasets in their desktop GIS platform.

We would really appreciate your feedback or suggestions including what other data would benefit from this delivery mechanism.

The API is compatible with both ESRI ArcPro & QGIS allowing you a “live” link to the data – useful for those with frequent updates

• ArcPro
• QGIS

OpenAPI specification is available through Swagger UI at - https://ogcapi.bgs.ac.uk/openapi?f=html

Data collections include:

• Earthquakes – Recent
• Landslide Database Index
• Borehole Records (SOBI)
• Offshore Hydrocarbon Wells

For further documentations see OS which use the same protocol https://labs.os.uk/public/osngd/os-ngd-api-features/ https://labs.os.uk/public/osngd/os-ngd-api-features/code-playground/#template-leaflet https://labs.os.uk/public/osngd/os-ngd-api-features/examples/items.html#filter=bbox,datetime https://osngd.gitbook.io/osngd/accessing-os-ngd/access-the-os-ngd-api-features https://osdatahub.os.uk/docs/ofa/overview

Queries

Simple Queries

Limited to BBOX, Property Display/Filters & Sort.

Example to get:

• all Hydrocarbon Wells where water depth = 50 m and include attributes wellid, wellname, completion_date, water_depth_m, tvd_m, td_m
• World Mineral Statistics, most recent first
• World Mineral Statistics, Oldest first
• World Mineral Statistics, only the folloowing attributes: Year, commodity, sub-commodity, country, statistic type

CQL Queries

These allow full complex queries against those collections using a postgres backend.

Some example URL encoded queries:

• Earthquakes with ml between 4 and 4.5
• Earthquakes with ml between 4 and 4.5 and >5km depth

Users don't have to URL encode the queries - the following will also work if copy & pasted into a browser: https://ogcapi.bgs.ac.uk/collections/recentearthquakes/items?f=json&limit=100&filter=ml BETWEEN 4 AND 4.5 AND depth > 5

• Earthquakes where ml = 4.2
• Earthquakes with year = 1975 or 1990
• Earthquakes inside a defined polygon
• Earthquakes inside a defined polygon HTML response
• All earthquakes in a polygon with a ml (Richter local magnitude) between 1 & 2
• Boreholes in a polygon area where ags_log_url IS NOT NULL and length is between 20 and 50 m
• World Mineral statistics for Guyana before 1975 with erml_commodity code = Gold
• Gold in Cyprus, after 2020-09-19

Examples

In the notebook folder of this repository we have a few example Jupyter Notebooks showing how you can interact with our data.

Follow the instructions below to install and run the demonstration Jupyter Notebook on your own machine.

• Earthquakes example - view the code and results in your browser.
  • Click here for mobile-friendly version rendered by Jupyter nbviewer.
• EDR Seafloor example - view the code and results in your browser.
  • Click here for mobile-friendly version rendered by Jupyter nbviewer.
• World Mineral Statistics example - view the code and results in your browser.
  • Click here for mobile-friendly version rendered by Jupyter nbviewer.

Prerequisites

• Python 3
• A Python 3 package manager e.g. pip3, conda

Installing dependencies

The following packages should be installed via pip3 or conda:

pip3 install -r requirements.txt

For developers

To test that the notebook runs to completion, extra packages are required:

pip3 install -r requirements-dev.txt

Run the test with:

pytest --nbval-lax notebooks\ogcapi-features-cql-owslib-earthquakes.ipynb

Starting the notebook

The demo runs in a Jupyter notebook. Start the notebook with:

jupyter notebook

A browser window will open at http://localhost:8888 with a list of available notebooks.