Mappable MapKit and NaviKit Demo Apps

Mappable Mapkit and NaviKit lets you embed interactive maps in iOS and Android mobile apps and give users access to Mappable’s technology and cartographic data. Learn more about the MapKit and NaviKit SDKs on the documentation page.

For a quick start development with the MapKit and NaviKit SDKs visit the following pages:

• Getting started with MapKit SDK
• Getting started with NaviKit SDK

The current repository contains sample code for how to use the MapKit and NaviKit SDKs for Android applications.

Project structures

There are three Android projects in the repository:

1. mapkit-samples: Contains several Android applications with sample code in Kotlin, all of which are demonstrated in the MapKit SDK Tutorials documentation.

   • map-with-placemark: A simple MapKit SDK application with Getting started with MapKit for Android information.

   • map-objects: Using the Map Objects API to add objects to the map.

   • map-interaction: Examples from the Map Interaction tutorial.

   • map-search: Examples of how to use the Search and Geosuggest functionality.

   • map-routing: About the Routes and Routing API.

2. mapkit-demo: A demo application in Java that contains the basic functionality of the lite and full MapKit SDK versions. It is not supported with Tutorials documentation, unlike the mapkit-samples project.

3. navikit-demo: A demo application showcasing the basic navigation features you can implement with NaviKit SDK.

Build locally

1. Clone the repository:

   git clone https://github.com/mappable-world/mapkit-android-demo.git

2. MapKit SDK demo application and samples require API key. You can get a free MapKit API key in the Get the MapKit API Key documentation.

3. Depending on the project you want to build, follow the steps in the following sections.

mapkit-samples

1. Open or create the project's local.properties file. Add the following property with your API key value in place of the YOUR_API_KEY placeholder:

   MAPKIT_API_KEY=YOUR_API_KEY

2. Choose a target in Android Studio for the build or use a CLI build with gradle wrapper:

   ./gradlew :map-with-placemark:assembleRelease

mapkit-demo

1. Open the MainApplication.java and edit the MAPKIT_API_KEY field, setting its value with your API key in place of the your_api_key placeholder:

   private final String MAPKIT_API_KEY = "your_api_key";

2. Run the mapkit-demo target in Android Studio or use the CLI build with gradle wrapper:

   ./gradlew assembleLiteRelease  # Lite MapKit samples only
   ./gradlew assembleFullRelease  # Lite and full

navikit-demo

1. Open or create the project's local.properties file. Add the following property with your API key value in place of the YOUR_API_KEY placeholder:

   MAPKIT_API_KEY=YOUR_API_KEY

2. Run the app target in Android Studio or use the CLI build with gradle wrapper:

   ./gradlew assembleRelease

Support

If you have problems or suggestions while using MapKit, visit our technical support page.

Sample overview

map-with-placemark Demonstrates how to create a MapKit map, move it, and display custom tappable placemarks.	map-objects How to display different objects on the map, including: images, geometries, and clusterized collections.

map-interaction About interacting with the MapKit map using camera movements, tap actions, focus rect and focus point, and interactions with POIs.	map-search Shows how to use Search and Geosuggest functionality in the full MapKit SDK.

map-routing Building routes using requested map points.