Repository navigation
Marine APIs Architecture
Bosaj edited this page Oct 18, 2026
·
2 revisions
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.
-
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¤t=wave_height,wave_direction,wave_period&timezone=Africa%2FCasablanca"
);
const data = await res.json();
console.log("Nador Wave Height:", data.current.wave_height, "meters");-
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.
-
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).
-
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
FishModalwith authoritative ecological indicators.
-
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.
-
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.
-
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.
-
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.
-
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.
Rather than keeping APIs isolated in a technical sandbox, L7OT embeds live telemetry directly into core consumer flows:
-
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").
-
Marine Sustainability Badges (
FishCard&FishModal):- Uses FishBase vulnerability index (<40 = Sustainable catch, >60 = Regulated/Protected) directly on catalog cards.
-
Pantry & Canned Fish Audit (
FishModalNutrition Tab):- Embeds Open Food Facts data directly below the fresh nutrition calculator, showing Moroccan canned fish brands with Nutri-Score & Eco-Score.
L7OT (الحوت) — The Definitive Moroccan Fish & Marine Encyclopedia
Curated & Architected by Oussama EL HADJI • Distributed under the MIT License
-
📖 Encyclopedia & Biology
-
🍽️ Culinary & Port Culture
-
📊 Economics, Treaties & Maritime Law
-
💻 Engineering & Architecture