Integrating MapsIndoors into your own App
Last updated
Last updated
The MapsIndoors Template is a downloadable starting point for you to integrate basic usage of MapsIndoors, containing search and directions functionalities, into your existing app. If you just want to get started with a simple solution with no customisation, this should fulfil your needs. Going through this guide will also teach you some principles on how MapsIndoors interacts with an app, and is a natural next step after the "Getting Started" guides.
If you need more customisation you can implementing your own solution using the documentation found on this site, or modify this code as needed.
MapsIndoors Template is provided as is, and can be integrated into your existing app. If you need further features, or want to customize existing ones, you're free to modify this one to your needs. However, MapsPeople offers no support or responsibility for changes made.
Before you get started, you need to get the API keys needed. This process is the same for both platforms.
First, you need to , just like you did in the guide (Please note: You are going to need a Google Billing Account for this step, so go ahead and if you haven't already). When the project is created, the following APIs and the specific SDK you plan to use must be enabled from the .
Google Maps Distance Matrix API
Google Maps Directions API
Google Places API Web Service
Maps SDK for Android/iOS
When the above 3 APIs and the relevant SDK are enabled, you can retrieve the API key from the . On the Credentials page, click Create credentials > API key.
If you are not a customer yet, you can use this demo MapsIndoors API key {{sdk.tutorialAPIKey}}
to follow this guide, or you can to get your building drawings processed and hosted by us to receive a unique API key. For the purpose of this guide, both methods will work.
This app was designed to be displayed in Portrait Mode. While it will work in Landscape Mode, some UI elements may look distorted or out-of-place.
Open the project you just downloaded, and copy the classes located in java/com/mapspeople/mapsindoorstemplate
into your own App
Add the following dependencies from build.gradle
:
Copy the layout and drawables from the res
folder into your app
Copy the String
values from res/values
into your app
Add the API key to the manifest file under the Application
tag like so:
Change the places where the navigation graph is used, if you are not using navigation. Alternatively, create a navigation action for MapsFragment. If so, change the navigation controller call on line: 74
inside MapsFragment.kt
under the TODO
Check the FirstFragment.kt
class on how to apply User Roles to the map fragment
First, download or clone the pre-made project from GitHub: .
Add the Maven repository () to your project's build.gradle
file
For the next step, this project uses for image handling in your application. If you are not using Glide, either import it, or if you use a different image library, you need to change some lines of code in the app. What you need to change them to, depends on the library you use. The lines are:
Copy the google_maps_api.xml
file to your project and insert a valid Google Maps API key -
Congratulations! You now have a functioning map in your own app, with the ability to both search for Locations and generate directions! If you want more advanced features, check out , or modify the existing code from this tutorial to suit your needs!