Logo GC

Sistema Informativo Spiaggiamenti

GeoCetus | API v2

API Pubbliche v2

La GeoCetus API v2 è un'interfaccia REST progettata per fornire accesso standardizzato ai dati degli spiaggiamenti di cetacei e tartarughe marine lungo le coste italiane. Include un sistema di filtraggio basato su parametri geografici, temporali e biologici. Restituisce i dati in formato GeoJSON, facilitando l'integrazione con applicazioni GIS e strumenti di analisi spaziale.

📘 Documentazione interattiva:
https://www.geocetus.it/gcapi/docs

Esempio

Output della chiamata API https://www.geocetus.it/gcapi/v2/records?table=C&limit=100 e mappa interattiva per la visualizzazione

Parametri

Questa sezione illustra i parametri supportati dall'endpoint /v2/records.

Parametro Descrizione Esempi
table (obbligatorio) Identifica il dataset da interrogare:
  • C = Cetacei
  • T = Tartarughe
 T
species Filtra i record per specie. Accetta nomi scientifici e comuni, anche mischiati (case-insensitive). Per più specie, separare i nomi con una virgola. caretta caretta,chelonya midas o
Balenottera minore,tursiops truncatus
period Filtra i record per intervallo temporale nel formato:
YYYY-MM-DD/YYYY-MM-DD 		2021-01-01/2022-06-15
year Filtra i record per un anno specifico.
Viene ignorato se è presente anche il parametro period. 		2025
region Filtra i record per una o più regioni (case-insensitive), separate da virgola. abruzzo,marche,emilia romagna
bbox Filtra i record per bounding box geografico WGS84:
xmin,ymin,xmax,ymax 		12.05,41.45,15.00,44.12
limit Imposta un numero massimo di record da restituire.
 10

Chiamate di esempio

Clicca per visualizzare l'output in formato GeoJSON

Filtro per specie (nome scientifico): https://www.geocetus.it/gcapi/v2/records?table=C&species=tursiops truncatus&limit=20
Filtro per specie (nome comune): https://www.geocetus.it/gcapi/v2/records?table=T&species=tartaruga comune&limit=10
Filtro per specie multiple: https://www.geocetus.it/gcapi/v2/records?table=T&species=tartaruga comune,tartaruga verde&limit=20
Filtro temporale: https://www.geocetus.it/gcapi/v2/records?table=T&period=2024-04-01/2024-07-31
Filtro per regione: https://www.geocetus.it/gcapi/v2/records?table=T&region=abruzzo&limit=20
Bounding box: https://www.geocetus.it/gcapi/v2/records?table=T&bbox=12,41,15,44&limit=50
Combinare più filtri: https://www.geocetus.it/gcapi/v2/records?table=T&species=tartaruga comune&year=2020&region=abruzzo,marche&bbox=12,41,16,44


© 2025 - Centro Studi Cetacei APS-E.T.S - Hosting by Netsons
Portale e applicazioni ottimizzati per Mozilla Firefox e Google Chrome
Tutti i contenuti sono distribuiti con licenza Creative Commons