iOS Wayfinding Migration guide

We have released the 3.0 version of Situm Wayfinding, this time the Wayfinding is based on the Situm Map Viewer. This enhancement brings numerous advantages, such as providing a consistent user experience across multiple platforms and also improved usability.

Please note that this major version enhances not only the UI but also the API so there are some required changes to migrate to this new version. For instance, we have replaced Google Maps with Mapbox, eliminating the need for a Google Maps API key. It is important to mention that certain functionalities previously available may not be present in this new version. Rest assured, we are actively working on further development and enhancements for the module.

Migrate from Situm Wayfinding to the new MapView on SitumSDK #

Before starting the migration process make sure you have a clean state on your project, and ensure you have a way to revert the process in case something goes wrong during the migration. A repository is almost always a good idea for that.

Migrating your app from Situm Wayfinding to Mapview on Situm SDK requires modifications in your app. However, the process is straightforward, and you will notice that your code becomes cleaner than before:

  • First dependencies need to be modified. To do that open your Podfile file and remove SitumWayfinding dependency and add SitumSDK version 3.0.0 onwards. Run pod install on your project.
  • Remove previous code (SitumMapsLibrary, LibrarySettings, Credentials, …). Since we have deleted the deprecated dependency if you try to compile now the compiler will tell you which parts to delete (main classes and protocols)
  • On the MainStoryboard go to the map View Controller and update the container class, typically UIView, for SITMapView
  • Load the new MapView component
let config = SITMapViewConfiguration(buildingIdentifier: buildingIdentifier, floorIdentifier: floorIdentifier)

mapView.load(with: config) { controller, error in
            guard error==nil else{
                print("Error loading map \(String(describing: error))")
            print("Map loaded properly")

A complete example can be found on our Quickstart guide.

And that should be it. With this steps you can provide a full Wayfinding experience in your app. Additional information of this component can be found in the documentation.

Subscribe to our newsletter


Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller:
Responsible for protection:
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper

Close window