Web SDK - ss-map-gl
@sovereignsolutions/ss-map-gl is the official Web Map SDK from Sovereign Solutions - a complete
mapping toolkit in one package: Sovereign Solutions styles and tile services, a full map API
(Map, Marker, Popup, NavigationControl, and the rest), high-performance vector drawing
(polygons, circles, text notations), GeoJSON serialization, spatial clustering, and geolocation.
Install one package and you have everything - no separate map engine to install, version, or keep
in sync yourself.
Status: Production ready
Purpose and goals of the SDK
The Web SDK exists so that your team does not have to build map rendering, drawing, clustering and geospatial services from scratch, and can ship a consistent Sovereign Solutions map experience in any web app - with a single install and no map-engine version to manage.
Open ecosystem compatibility
ss-map-gl speaks the open MapLibre GL interface end to end, so it is fully compatible with the
open MapLibre ecosystem: controls, overlays, geocoders, drawing tools, tile protocols, and
framework bindings all plug straight in, including react-map-gl, vue-maplibre-gl, deck.gl,
terra-draw, the MapLibre geocoder, and pmtiles. Bring whatever tools you already use - nothing
extra to configure. See Get Started for details.
Overview of the SDK features and capabilities
- Map rendering - render a Sovereign Solutions map with a full map API (
Map,Marker,Popup,NavigationControl,LngLat, and more), with lifecycle handling, event hooks and cleanup. - Basemap styles - nine predefined Sovereign Solutions styles, switchable at runtime.
- Geolocation - a "Locate me" button and
getMyLocation(). - Drawing tools - draw polygons, circles and text notations with a toolbar, and import/export
GeoJSON. Ships as a separate
/drawingsubpath so apps that never draw don't pay for it in their bundle. - Clustering - cluster 10,000+ points with custom badges, including weighted clustering.
- Open ecosystem compatibility - implements the open MapLibre GL interface, so MapLibre controls, overlays, geocoders, drawing tools and framework bindings work with it unmodified.
Continue to Get Started to add the SDK to your project.
See also: Basic Map Initialization, Basemap Styles, Drawing Controller, Cluster Controller.
