Desenvolupadors · API & SDK

Integra mapes GIS a la teva aplicació.

gis2web exposa una API REST completa i un component incrustable com a iframe. Afegeix mapes interactius amb funcionalitats GIS completes a qualsevol web o aplicació en minuts.

Sol·licitar accés API

POST /api/auth
Authorization: Bearer <token>

→ { "token": "eyJ..." }

GET /api/maps/:mapId
Authorization: Bearer <token>

→ { "iframe": "<iframe src=..." }

import { MapHandler } from '@vidromaps/map-handler'

const map = new MapHandler(iframeEl)
map.on('click', (feature) => { ... })

REST API

Una API per controlar-ho tot

L'API REST de gis2web et permet autenticar usuaris, sol·licitar mapes i executar operacions des de qualsevol sistema extern. Documentació completa disponible sota petició.

POST /api/auth

Autenticació

Utilitza un token Bearer per autenticar les peticions. Els tokens es configuren des del backoffice.

GET /api/maps/:id

Sol·licitar un mapa

Amb el token actiu, sol·licita el mapa que vols incrustar. La resposta inclou l'iframe HTML llest per inserir.

map.on('event', fn)

Esdeveniments i mètodes

El component incrustable emet esdeveniments DOM i exposa mètodes públics. Reacciona a clics al mapa, canvis de capa o resultats de cerca des del teu propi codi.

Component incrustable

Un iframe que fa molt més que mostrar un mapa

El visualitzador de gis2web es lliura com a iframe incrustable a qualsevol web. Estén-lo amb @vidromaps/map-handler per controlar el seu comportament des de JavaScript.

Paquet npm

@vidromaps/map-handler

Llibreria JavaScript per controlar l'iframe de gis2web. Envia comandes, escolta esdeveniments i gestiona el cicle de vida del mapa amb una API neta.

npm install @vidromaps/map-handler

import { MapHandler } from '@vidromaps/map-handler'

// Bind to the gis2web iframe element
const map = new MapHandler(
  document.getElementById('gis2web-iframe')
)

// Listen for feature clicks
map.on('featureClick', (feature) => {
  console.log(feature.id, feature.properties)
})

// Send commands to the map
map.setLayer('water-network', { visible: true })
map.zoomTo({ lat: 41.38, lng: 2.17, zoom: 14 })

Integració en 4 passos

De zero a mapa en minuts

Autenticar usuari via API

Sol·licitar el mapa a l'API

Inserir l'iframe al lloc

Estendre amb @vidromaps/map-handler

Arquitectura de plugins

Extén les funcionalitats

gis2web té una arquitectura de plugins que permet afegir capacitats a cada instal·lació: Maniobres, Inventari, Cadastre, Marcadors i més. Els plugins s'activen des del backoffice sense tocar codi.

Maniobras

Inventario

Catastro

Marcadores

Comunitat

Uneix-te al Discord de gis2web

Comparteix integracions, pregunta dubtes tècnics i segueix el desenvolupament de la plataforma junt amb la comunitat d'usuaris de gis2web i BMAPS.

Unir-se al Discord

Llest per integrar?

Sol·licita accés a l'API i t'enviem les credencials i la documentació completa en menys de 24 hores.

Sol·licitar accés API