English | 日本語 | Español (Latinoamérica)

@mapconductor/js-sdk-core

Core abstractions for the MapConductor JS SDKs: geometry, camera, observable map and overlay state, controller interfaces, and shared types. The package is platform-neutral — no React or DOM dependency — and everything else builds on it: @mapconductor/js-sdk-react and every provider package (react-for-googlemaps, react-for-maplibre, react-for-here, …).

Installation

Installing any provider package pulls this in automatically. Install it explicitly when you import from it directly (which typical application code does), with pnpm's strict (isolated) node_modules, or when building your own provider or extension:

npm install @mapconductor/js-sdk-core

Quick start

Application code creates provider-neutral state here and hands it to any provider view:

import{createGeoPoint,createMapCameraPosition,createMarkerState,}from'@mapconductor/js-sdk-core';consttokyo=createGeoPoint({latitude: 35.6812,longitude: 139.7671});// Camera position in Google Maps zoom semantics — shared by all providers.constcamera=createMapCameraPosition({position: tokyo,zoom: 12});// Observable marker state. Render it with <Marker state={...}> from// @mapconductor/js-sdk-react on any provider; mutations update the view.constmarker=createMarkerState({id: 'tokyo',position: tokyo});

See the react-for-* package READMEs for complete map examples.

What's inside

• Geometry and spherical utilities: GeoPoint, bounds, offsets, projections
• Camera: MapCameraPosition with Google Maps zoom semantics, plus zoom/altitude conversion shared by the provider packages
• Observable overlay states: marker, circle, polyline, polygon, ground image, and raster layer
• Bulk-marker tiling (MarkerTilingOptions) and geocell helpers
• Local tile server infrastructure (including the tile-sw.js service-worker entry point)
• Controller and provider interfaces implemented by each react-for-* package

Development notes

The logic in this package must stay synchronized with the core module of the MapConductor Android SDK.

Related packages

• @mapconductor/js-sdk-react — shared Marker, Markers, shapes, and info bubbles
• @mapconductor/react-for-* — provider packages (Google Maps, MapLibre, Mapbox, Leaflet, OpenLayers, ArcGIS, Cesium, HERE)