Mapsted Maps JavaScript API v2 — Legacy Documentation

Archived. These pages are preserved for customers migrating off v2. The current supported release is 26.7.1. Start at the current release.

Status

Aspect	State
v2 support	End-of-life. Frozen at 2.13.0. No new features, no bug fixes, security patches at Mapsted's discretion only.
Last v2 build	v2.13.0 on the maps.js CDN (/v2.13.0/maps.js?id=<propertyId>)
Current release	26.7.1. Full TypeScript types, structured error codes, typed event system, origin-validated postMessage, interactive sandbox, WCAG 2.2 AA docs.
Deprecation window	v2 method aliases remain in the current runtime shim (src/migration/shim.ts — 10 renames + 1 removal). Aliases log console.warn on first call and will be removed in a future major release.

What this section contains

Page	For
Migration to the current release	Start here if you are upgrading a v2 integration to 26.7.1. Complete rename table (10 renames + 1 removal), event renames per WIRE_TO_PUBLIC_NAME, SecurityConfig contract, and a 6-step upgrade checklist.
Legacy v2 API reference	Historical v2 API surface, extracted from the v2.13.0/example/*.html demos that shipped with the v2 CDN bundle. Use this if you are still on v2 and need to look up what a method did.
v2 changelog	Pointer to the unified CHANGELOG.md at the repo root; confirms v2 is frozen at 2.13.0.

What v2 offered

v2 (2.x, last release 2.13.0) was the UMD-only, untyped predecessor to v3. It exposed a single global namespace mapsted.maps loaded via a CDN <script> tag:

<script src="https://mapi.mapsted.com/v2.13.0/maps.js?id=202"></script>
<script>
  mapsted.maps.initialize({
    element: document.getElementById('map'),
    entityData: [{ id: 599, name: 'Holt' }],
  });
  mapsted.maps.addEventListener('select', (e) => console.log(e.detail));
</script>

Core v2 capabilities (all preserved in 26.7.1 under new names — see the migration guide):

• Embed an interactive indoor map via a single <script> tag.
• Select entities, highlight lots, attach custom markers + popup HTML.
• Change floors and buildings (changeFloorById, changeFloorByName).
• Route between entities / coordinates / map overlays (calculateDistance).
• Deep-link into a pre-selected map state via share-link boosts (createBoostSelect, createBoostRouting).
• Broad event API with DOM-style addEventListener / removeEventListener.

Why there is no full v2 API reference on this site

v2's TypeDoc output lived next to the legacy UMD bundle on the distribution server and is not mirrored into the v3 VitePress site. The legacy v2 API reference page preserves the representative surface extracted from the v2.13.0 example bundle — enough for a lookup reference. If you need the full TypeDoc bundle, keep your pinned copy of main.min.js and its companion typedoc/ folder from the v2 distribution.

Recommended next step

1. If you are still on v2 and need to operate the deployment you have, read the legacy v2 API reference. mapi.mapsted.com keeps serving v2.13.0 — your existing <script> tags continue to work with no changes required.
2. If you are upgrading to the current release, read the migration guide, then go to Embed your first map for the 26.7.1 starter.
3. If you are new to Mapsted Maps, ignore this /v2/ tree entirely — start at the current release.