Developers · API & SDK

Integrate GIS maps into your application.

gis2web exposes a complete REST API and an embeddable iframe component. Add interactive maps with full GIS capabilities to any web or application in minutes.

Request API access

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

One API to control everything

The gis2web REST API lets you authenticate users, request maps and run operations from any external system. Full documentation available on request.

POST /api/auth

Authentication

Use a Bearer token to authenticate requests. Tokens are configurable from the backoffice.

GET /api/maps/:id

Request a map

With an active token, request the map you want to embed. The response includes the ready-to-insert HTML iframe.

map.on('event', fn)

Events & methods

The embeddable component emits DOM events and exposes public methods. React to map clicks, layer changes or search results from your own code.

Embeddable component

An iframe that does much more than display a map

The gis2web viewer is delivered as an embeddable iframe for any website. Extend it with @vidromaps/map-handler to control its behaviour from JavaScript.

npm package

@vidromaps/map-handler

JavaScript library to control the gis2web iframe. Send commands, listen for events and manage the map lifecycle with a clean API.

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 })

Integration in 4 steps

From zero to map in minutes

Authenticate user via API

Request the map from the API

Insert the iframe into the site

Extend with @vidromaps/map-handler

Plugin architecture

Extend the functionality

gis2web has a plugin architecture that lets you add capabilities to each installation: Maneuvers, Inventory, Cadastre, Bookmarks and more. Plugins are activated from the backoffice with no code changes.

Maniobras

Inventario

Catastro

Marcadores

Community

Join the gis2web Discord

Share integrations, ask technical questions and follow the platform's development alongside the gis2web and BMAPS user community.

Join Discord

Ready to integrate?

Request API access and we'll send you credentials and full documentation within 24 hours.

Request API access