maio.api

One island.
A shared foundation.

A digital representation of Maio. Its places, landscapes and infrastructure, connected through one public API.

5,480geographic & place records
20 / 27collections with data
10datasets with source data
Public read accessNo API key required · Snapshot data

Explore the collections

Beaches

Coastal beaches and curated beach assets.
Loading…
ATLANTIC OCEANPorto InglêsCalhetaPedro Vaz
↑ N
Beaches · Current page© OpenStreetMap contributors · ODbL
Reading snapshot…

The island in context

All datasets

Your next idea.
Our shared island.

One versioned interface for Visit Maio, Maio Guide, the Data Portal, researchers and future tools. Read it from any application, without an API key.

OpenAPI 3.1 specification
Example request · JavaScript
const response = await fetch(
  '/api/v1/collections/beaches/items?limit=10'
);
const beaches = await response.json();

for (const feature of beaches.features) {
  console.log(feature.id, feature.geometry);
}

// Follow beaches.links.next for the next page.
// Use the deployed API origin from other apps.
GET only · CORS enabled · GeoJSON · Paginated

Find exactly what you need

Filter by collection, search with q, or use bbox=west,south,east,north. Coordinates are longitude, latitude. Spatial queries match feature bounding boxes.

Know what you’re reading

Every feature carries source IDs and a geometry status. Snapshot revisions track source changes. Source dates may be unknown; this API does not imply live or complete coverage.

Make room for the future

Environmental records include sourced model estimates; physical sensors remain planned. The specification includes a future observation contract with timestamps, units, provenance and quality flags.