Skip to content

Marine APIs Architecture

Bosaj edited this page Oct 18, 2026 · 2 revisions

🌐 Worldwide Free Marine & Fisheries APIs Architecture

L7OT connects with 8 premier open, free-tier or public-domain APIs covering marine meteorology, biological taxonomy, global biodiversity, satellite telemetry, and open food products.


🛰️ 1. Open-Meteo Marine API

  • Endpoint: https://marine-api.open-meteo.com/v1/marine
  • Authentication: 100% Free, No API Key Required
  • Parameters Used: latitude, longitude, current=wave_height,wave_direction,wave_period,wind_wave_height,swell_wave_height
  • Use Case: Live wave height, swell telemetry, and artisanal fishing safety radar across 8 major Moroccan ports (Casablanca, Agadir, Tangier Med, Dakhla, Safi, Essaouira, Nador, Laâyoune).
// Sample Request:
const res = await fetch(
  "https://marine-api.open-meteo.com/v1/marine?latitude=35.17&longitude=-2.93&current=wave_height,wave_direction,wave_period&timezone=Africa%2FCasablanca"
);
const data = await res.json();
console.log("Nador Wave Height:", data.current.wave_height, "meters");

🏛️ 2. World Register of Marine Species (WoRMS) REST API

  • Endpoint: https://www.marinespecies.org/rest/AphiaRecordsByName/{ScientificName}?like=true
  • Authentication: 100% Free Open Access
  • Data Returned: Official AphiaID, valid binomial name, taxonomic rank (Kingdom, Phylum, Class, Order, Family, Genus), publication authority, and direct database citation.
  • Use Case: Taxonomic verification and synonym resolution for all 32 Moroccan species.

🌊 3. Ocean Biodiversity Information System (OBIS) API

  • Endpoint: https://api.obis.org/v3/occurrence?scientificname={ScientificName}&size=10
  • Authentication: Free, UNESCO-IOC (Intergovernmental Oceanographic Commission)
  • Data Returned: Georeferenced occurrence records with latitude, longitude, observation dates, vessel basis of record, and water body.
  • Use Case: Verifying biological occurrences within the Moroccan Exclusive Economic Zone (EEZ).

🐟 4. FishBase & SeaLifeBase API (rOpenSci)

  • Endpoint: https://fishbase.ropensci.org/species?Genus={Genus}&Species={Species}
  • Authentication: 100% Free REST API
  • Key Fields: Vulnerability (0–100 ecological vulnerability score), Troph (Trophic level 1.0–5.0), Length (maximum observed length), FBname (official FAO common name).
  • Use Case: Powering the live science telemetry tab in FishModal with authoritative ecological indicators.

🥫 5. Open Food Facts JSON API

  • Endpoint: https://world.openfoodfacts.org/cgi/search.pl?search_terms={SearchTerm}&json=1
  • Authentication: 100% Free Open Data
  • Key Fields: product_name, brands, nutriscore_grade (A to E), ecoscore_grade, nova_group, image_url.
  • Use Case: Querying Moroccan canned sardines, mackerel, and seafood exported to Europe and North America to verify Nutri-Score compliance.

📡 6. Copernicus Marine Service (EU Sentinel Satellite)

  • Endpoint: https://marine.copernicus.eu/
  • Authentication: Free registration under European Union Copernicus open data license.
  • Telemetry: Sea surface temperature (SST), chlorophyll-a concentration, sea level anomalies, ocean current velocities.
  • Use Case: Modeling upwelling currents off Cap Blanc and the Canary Current system feeding Moroccan sardine grounds.

🚢 7. Global Fishing Watch Public API

  • Endpoint: https://globalfishingwatch.org/developer-portal/
  • Authentication: Free developer tier with registration token.
  • Telemetry: Satellite Automatic Identification System (AIS) vessel positions, fishing effort hours, gear types (purse seiners, trawlers, longliners).
  • Use Case: Monitoring industrial fishing pressure within Moroccan territorial and artisanal zones.

🇺🇳 8. FAO Fisheries & Aquaculture Open Data (ASFIS)

  • Repository: https://www.fao.org/fishery/en/collection/asfis
  • Standard Codes:
    • Area 34: Eastern Central Atlantic (المحيط الأطلسي الشرقي الأوسط)
    • Area 37: Mediterranean and Black Sea (البحر الأبيض المتوسط)
    • 3-Alpha Species Codes: PIL (Sardina pilchardus), HKE (Merluccius merluccius), OCC (Octopus vulgaris).
  • Use Case: Historical catch benchmarks and Moroccan quota analytics.

🌍 9. Global Biodiversity Information Facility (GBIF) API

  • Endpoint: https://api.gbif.org/v1/occurrence/search?scientificName={ScientificName}&country=MA&limit=4
  • Authentication: 100% Free Open Access, Zero Key Required
  • Telemetry: Research-grade geo-referenced sightings along the Moroccan coast (Tangier, Casablanca, Safi, Agadir, Al Hoceïma), observation dates, IUCN Red List categories, and direct photo links from iNaturalist.
  • Use Case: Embedded directly in the Fish Modal Overview tab under "Marine Ecology & Sightings in Moroccan Waters" to give consumers real empirical proof of local coastal abundance.

🎯 Practical Consumer Integration in L7OT

Rather than keeping APIs isolated in a technical sandbox, L7OT embeds live telemetry directly into core consumer flows:

  1. LiveMarineConditionsWidget (Market Guide & Modal):
    • Uses Open-Meteo Marine API to fetch wave height, swell, and wave period at the user's detected local port (Casablanca, Safi, Tangier, Nador, etc.).
    • Automatically evaluates getSeaStateImpact(): translates raw ocean physics into actionable market advice for Moroccan buyers ("Rough seas today = artisanal boats docked = lower sardine supply and higher retail prices").
  2. Marine Sustainability Badges (FishCard & FishModal):
    • Uses FishBase vulnerability index (<40 = Sustainable catch, >60 = Regulated/Protected) directly on catalog cards.
  3. Pantry & Canned Fish Audit (FishModal Nutrition Tab):
    • Embeds Open Food Facts data directly below the fresh nutrition calculator, showing Moroccan canned fish brands with Nutri-Score & Eco-Score.

Clone this wiki locally