GeoNet API Wrapper

A Node.js API wrapper for GeoNet — Aotearoa New Zealand's geological hazard monitoring system.

Note: This wrapper has been independently developed by Carolina Mitchell and is not officially affiliated with GeoNet or Earth Sciences New Zealand (formerly GNS Science).

Installation

npm install geonet
# or
pnpm add geonet
# or
yarn add geonet
Copy

Features

• 🌋 Volcano monitoring and alert levels
• 🌊 Earthquake data and intensity measurements
• 📰 News feed integration
• 📡 Network sensor data access
• 📊 Strong motion data
• 🗺️ GeoJSON format support
• 🧰 Quality-of-life utilities
• ✨ Full TypeScript support
• 📝 Comprehensive documentation

Quick Start

TypeScript

import { GeoNet } from "geonet";
import { MMI } from "geonet/dist/@types/common";

const geonet = new GeoNet();

// Get recent earthquakes
const quakes = await geonet.getQuakes(MMI.Light);

// Get volcano alert levels
const alerts = await geonet.getVolcanoAlertLevel();
Copy

JavaScript

const { GeoNet } = require("geonet");

const geonet = new GeoNet();

// Get recent earthquakes (MMI = 4 for Light intensity)
const quakes = await geonet.getQuakes(4);

// Get volcano alert levels
const alerts = await geonet.getVolcanoAlertLevel();
Copy

Error Handling

try {
    const quakes = await geonet.getQuakes(MMI.Light);
} catch (error) {
    console.error("Error fetching quakes: ", (error as Error).message);
}
Copy

Documentation

For detailed documentation, visit our documentation site.

Contributing

Contributions are welcome! Please read the documentation and get familiar with the project code. For details on our code of conduct, please see our Code of Conduct.

If you identify a security vulnerability, please read our Security Policy for information on how to report it, and what versions are supported.

Development

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build the package
pnpm build

# Generate documentation
pnpm docs

# Regenerate documentation on file changes
pnpm docs:watch
Copy

Licence

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0); see the LICENCE file for details.

Related Links

• GeoNet API Documentation
• GeoNet Website
• GeoNet Data Policy

Support

• GitHub Issues
• Discord
• Documentation

Acknowledgements

• Carolina Mitchell for creating this package.
• Khai Dye-Brinkman for contributing to code debugging.
• GeoNet for providing the public API.
• Earth Sciences New Zealand (formerly GNS Science) and Natural Hazards Commission Toka Tū Ake for operating GeoNet.