situm-wayfinding

Situm Wayfinding for Android provides a plug-and-play navigation experience with 3D floor plans, points of interest (POIs), routes, and turn-by-turn directions — all seamlessly integrated into your application. Powered by Situm.

This documentation covers the wayfinding module of the Situm SDK, which provides the visual and interactive components for map display and navigation.

📍 For positioning and location-related APIs, refer to the official JavaDoc.
This separation exists because the SDK is composed of two main components: a positioning core and a map interface, which are documented independently.

Getting Started

To learn how to set up a new Android application using this module, please refer to the full tutorial available on the official Situm documentation site.

Below is a minimal example that shows how to initialize and load a MapView:

// Get a reference to the MapView
val mapView = findViewById<MapView>(R.id.exampleMapView)

// Configure the MapView
val configuration = MapViewConfiguration.Builder()
    .setBuildingIdentifier(YOUR_BUILDING_ID)
    .build()

// Load the map
mapView.load(configuration, object : MapView.MapViewCallback {
    override fun onLoad(mapViewController: MapViewController) {
        Log.d(TAG, "Map is ready!")
        // You can now interact with the map via the controller
        // For example:
        // mapViewController.navigateToPoi("A-VALID-POI-IDENTIFIER")
    }

    override fun onError(error: Error) {
        Log.e(TAG, "Error loading map: ${error.message}")
    }
})

If you have any questions, feedback, or integration issues, feel free to reach out to Situm.