@mapsted/maps-react-native

v26.7.2

Published

16 days ago

Mapsted Maps for React Native — indoor maps, wayfinding, and turn-by-turn navigation for iOS and Android. Hardware-free indoor positioning powered by 110+ granted patents.

0High
0Medium
0Low

mapsted-admin

mapsted indoor-maps wayfinding indoor-positioning indoor-navigation react-native ios android blue-dot

Overview

@mapsted/maps-react-native embeds Mapsted's fully interactive indoor maps into any React Native app. Drop the MapstedMapView component into your view tree and users get a blue-dot wayfinding experience the moment the screen opens — indoor maps, multi-floor routing, and turn-by-turn navigation, on both iOS and Android from a single JavaScript/TypeScript API.

Positioning is hardware-free — no beacons, no Wi-Fi fingerprinting, and no on-site hardware to install. The wrapper is built on Mapsted's native 26.7.1 SDK and ships TypeScript types alongside the components.

60-second quick start

Install

npm install @mapsted/[email protected]

Requires React Native 0.76+, Android minSdkVersion 26 with Kotlin 2.3.20, and iOS deployment target 16.0. See the getting-started guide for the full setup, and the migration guide if you are upgrading from the 0.0.x wrapper.

Minimal embed

import { MapstedMapView } from '@mapsted/maps-react-native';

export default function IndoorMap() {
  return (
    <MapstedMapView
      propertyId={504}
      style={{ flex: 1 }}
      onMapReady={() => {}}
      onMapLoadError={(e) => { /* safety-net if a load fails to complete */ }}
    />
  );
}

The property auto-plots indoors on mount — no extra initialization call needed.

Feature grid

| Wayfinding | Positioning | Mobile integration | |---|---|---| | Turn-by-turn blue-dot navigation with multi-floor routing | Hardware-free indoor positioning — no beacons, no Wi-Fi fingerprinting, no on-site hardware | One JavaScript/TypeScript API for both iOS and Android | | Multi-building, campus-scale, and cross-floor routing | Accessibility routing — step-free paths on demand | Embedded MapstedMapView component drops into any React Native view tree | | Route preview and on-demand distance / travel-time estimates | 110+ granted patents protecting the positioning technology | Full TypeScript types ship with the package | | Picture-in-picture map mode during active navigation | Real-time blue-dot with automatic floor detection | Certified on real arm64 hardware, including first launch |

Who uses it

Trusted by PepsiCo, FIFA, and leading healthcare networks. Deployed across 12+ industries in over 4 billion square feet of indoor space worldwide — airports, shopping centres, universities, hospitals, corporate campuses, and transit hubs.

See Mapsted's industry solutions →

Core API at a glance

import { MapstedMapView, launchMapActivity } from '@mapsted/maps-react-native';

// Embedded map with routing + turn-by-turn navigation:
<MapstedMapView
  propertyId={504}
  destinations={[{ propertyId: 504, buildingId: 504, entityId: 121, floorId: 941 }]}
  startNavigation={startNav}
  pipMode="expanded"
  onRouteReady={/* ... */}
  onNavigationInstructionStarted={(e) => { /* e.nativeEvent.currentInstruction */ }}
/>

// Fullscreen property picker → indoor map:
await launchMapActivity();

| Surface | What it does | |---|---| | MapstedMapView | Embedded indoor map — auto-plot, routing, navigation, PiP. The recommended, real-device-certified integration path. | | propertyId / destinations | Select the property to plot and the entities to route to (ids are shared across iOS and Android). | | onMapReady / onMapLoadError | Map lifecycle and safety-net error callbacks. | | onRouteReady / onNavigationInstructionStarted | Routing and turn-by-turn navigation callbacks. |

Platform requirements

| Platform | Minimum | |---|---| | React Native | 0.76 (range 0.76 → 0.86) | | Android | minSdkVersion 26, Kotlin 2.3.20 (AGP 8.6+ / Gradle 8.10+ — RN 0.76 defaults) | | iOS | deployment target 16.0, CocoaPods with the Mapsted podspec source |

The Android SDK resolves from Mapsted's public Maven repository (injected by the wrapper during install); the iOS pods resolve from the Mapsted podspec repo. Full setup — including the iOS dynamic-framework linkage step — is in the getting-started guide.

Security and compliance

Licence-bound — each build runs against a Mapsted licence issued for your OS and bundle id; demo licences are available for evaluation.
TLS everywhere — all map, routing, and positioning traffic is served over HTTPS.
No on-site hardware — positioning needs no beacons or Wi-Fi infrastructure, reducing your deployment and security surface.
Accessibility — step-free routing and multi-language support are built in.

Licence

Proprietary Licence — the full text is included in the LICENSE file shipped with this package. See the Licence Agreement for the canonical version.