Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions data-access-changes/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ access type | impacted dataset
[FITS to Tilde](fits-to-tilde.md) | generic time series data and general overview of the migration
[FITS to Tilde volcano monitoring data](fits-to-tilde-mapping.pdf) | manually collected volcano monitoring data
[FITS to Tilde GNSS time series](gnss-time-series-access-change.md) | GNSS time series data
[GeoNet API](geonet-api.md) | API to query miscellanous data and information from GeoNet



51 changes: 51 additions & 0 deletions data-access-changes/geonet-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# GeoNet API (api.geonet.org.nz)

## GeoNet API Network Sensor changes (March 2026)
The GeoNet API endpoints that were providing information about the GeoNet sensor network have been reviewed and modified for improved usability.

Key changes:
- additional sensor types can now be queried (e.g. cameras, environmental sensors, scandoas, geomagnetic sensors)
- sensor types categories and associated numbering changed (client sensor search queries might be impacted)
- seismic stations metadata endpoint updated (and details now queried from GeoNet metadata database (delta) and not GeoNet FDSN station service)
- GNSS station metadata enpoint updated
- Network Data endpoint updated (XXXX ADD MORE INFO HERE XXXXX)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm putting in comments to help work out where we need to add more detail.
Not sure what the Network data end point changes ATM


### Sensors types
Sensor types listing reviewed to include additional types (and data domains). Numbering and categories have been reviewed.
The endpoint to query sensor type is `https://api.geonet.org.nz/network/sensor/type`

Previous API version was returing
```
1: Accelerometer
2: Barometer
3: Broadband Seismometer
4: GNSS Antenna
5: Hydrophone
6: Microphone
7: Pressure Sensor
8: Short Period Borehole Seismometer
9: Short Period Seismometer
10: Strong Motion Sensor
```

New API version is returnig
```
1: Air pressure sensor
2: Broadband seismometer
3: Coastal sea level gauge
4: DART bottom pressure recorder
5: DOAS spectrometer
6: Environmental sensor
7: Geomagnetic sensor
8: GNSS/GPS
9: Lake level gauge
10: Manual collection
11: Short period seismometer
12: Strong motion sensor
13: Camera
```

### Sensor details

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To get detailed information on a specific sensor use network/sensors?sensorType=n&station=stationcode
e.g. https://api.geonet.org.nz/network/sensors?sensorType=8&station=DUND


### Sensor search
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would like to add some notes on the end points notes on who to replace these end points (which are working but are deprecated?)
e.g.
sensor search:
https://api.geonet.org.nz/network/sensor?sensorType=3,10&endDate=9999-01-01
sensor details:
https://api.geonet.org.nz/network/fdsn/station?network=NZ&station=QRZ
https://api.geonet.org.nz/network/gnss/mark?code=DUND