Permite el acceso a los datos del «Anuario de Mareas» publicado por el Instituto Hidrográfico de la Marina (IHM). El objetivo de esta API es ofrecer a los usuarios la posibilidad de incrustar los datos de la predicción de Mareas del IHM en sus páginas web, documentos o trabajos a partir de la solicitud a un servicio de peticiones automatizado. La página permite de forma intuitiva construir pasa a paso la url con la petición para obtener los datos deseados.
Utilizando como base la url «http://ideihm.covam.es/api-ihm/getmarea?» se pueden solicitar dos tipos de peticiones (parámetro REQUEST):
REQUEST=getlist -> ofrece un listado de las estaciones de mareas donde existen datos de predicción. REQUEST=gettide -> ofrece predicciones de mareas para un puerto determinado.
Al seleccionar la petición gettide se debe de seleccionar, al menos, el puerto con uno de los parámetros obligatorios ID o PORT (identificador numérico del puerto o nombre corto del puerto). Se ofrece la salida de la petición en varios formatos a través del parámetro opcional FORMAT con valores json, xml, txt o gra, este último dá una salida gráfica de los datos y es solo para la obtención de datos de predicción en una estación (por defecto, si no se indica formato se toma txt, texto plano). A través del parámetro opcional DATE o MONTH, se obtinen datos de una fecha o mes determinado (DATE=YYYYMMDD o MONTH=YYYYMM). Si no se indica alguno de estos parámetros, por defecto, se utilizan los datos del día actual. Al seleccionar como formato de salida gra para la predicción mensual se puede indicar la frecuencia de las predicciones con el parámetro opcional TIME= 1H, 30min o 5min (siendo por defecto es 1H).