Saltar al contenido

API PÚBLICA · VERSIÓN 17

Compartida por la web y las aplicaciones:
la estructura de datos de Maptlantis

Una API de solo lectura para que la búsqueda de lugares, el mapa, las páginas de detalle y las futuras aplicaciones de iOS y Android usen las mismas categorías, precios, temporadas y datos de vida marina.

Categorías definidas una sola vez

La web y la API comparten las mismas categorías de apnea, buceo, snorkel, vida marina y cruceros de buceo.

Preparada para aplicaciones

La paginación, los identificadores estables, las rutas canónicas y la cabecera de versión permiten guardar datos en caché y enlazar directamente a los detalles.

Nivel de perfil incluido

Las respuestas incluyen el nivel de perfil completo, de fuentes comprobadas o de directorio, junto con las fuentes, para distinguir los datos aún pendientes de revisión.

Rutas de la API

API pública de lectura

GET
/api/v1/places

Búsqueda, filtros y paginación

Combina país, actividad, vida marina, tipo de encuentro, mes, precio publicado, tipo de lugar y nivel de perfil.

GET
/api/v1/places/{country}/{region}/{slug}

Detalle de operadores y lugares

Devuelve programas destacados, precios, temporadas, contactos, programas de vida marina, fuentes y calidad del perfil.

GET
/api/v1/map

Datos esenciales para mapas en aplicaciones

Coordenadas, filtros y datos de tarjetas organizados en una tabla de cadenas y tuplas. Los índices de los campos siguen el documento OpenAPI.

GET
/api/v1/map/search

Índice de búsqueda bajo demanda

Programas, precios, contactos y palabras clave multilingües que se cargan solo cuando el usuario busca.

GET
/api/v1/map/full

Ruta para clientes anteriores

Una ruta obsoleta que devuelve el objeto JSON completo. Las nuevas integraciones deben usar las rutas de datos esenciales y búsqueda.

GET
/api/v1/spots

Puntos por mes y temporada de vida marina

Devuelve, con coordenadas, solo los marcadores cuya temporada publicada incluye el mes elegido y que ofrecen un programa para ese animal.

GET
/api/v1/tours

Fechas públicas de excursiones y plazas disponibles

Fechas de anfitriones con fuentes revisadas que coinciden con el periodo solicitado, filtradas por fecha, región y actividad, con plazas disponibles según los participantes confirmados.

GET
/api/v1/coverage

Cobertura mundial

Indica si cada una de las 249 entradas ISO 3166-1 está registrada, en actualización, suspendida por seguridad o excluida.

Consultas de ejemplo

Probar ahora

Antes de usar los datos

Los precios publicados, las temporadas, los horarios y los avistamientos pueden cambiar. Las aplicaciones y los servicios externos deben mostrar la URL de la fuente, la fecha de consulta y la calidad del perfil, y consultar de nuevo el sitio oficial del operador antes de reservar. Esta API no copia textos ni puntuaciones de reseñas de Google.