Yandex MapKit Demo Apps

Yandex MapKit is a cross-platform library that lets you use the capabilities of Yandex Maps in mobile applications for iOS and Android. 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:

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.

   • map-offline: Examples of using the Offline Maps API for working with MapKit's maps without the internet.

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.

Build locally

1. Clone the repository:

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

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

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

Support

If you have problems or suggestions while using MapKit, visit the contact 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.	map-offline How to download offline maps to use them without the internet.