Mappable MapKit Demo Apps

Mappable Mapkit 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 SDK on the documentation page.

Visit the Getting started page for quick start development with the MapKit SDK.

The current repository contains sample code for how to use the MapKit SDK for Android applications.

Project structures

There are two Android projects in the repository:

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.
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.

Build locally

Clone the repository:

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

Demo applications use the MapKit SDK, which requires API key. You can get a free MapKit API key in the Get the MapKit API Key documentation.
Depending on the project you want to build, follow the steps in the following sections.

mapkit-samples

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
```
Choose a target in Android Studio for the build or use a CLI build with gradle wrapper:
```
./gradlew :map-with-placemark:assembleRelease
```

mapkit-demo

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";
```

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

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.

mappable-world / mapkit-android-demo