/mapkit-android-demo

MapKit Android demo

Primary LanguageKotlinOtherNOASSERTION

Yandex MapKit and NaviKit Demo Apps

Yandex MapKit and NaviKit are cross-platform libraries that let you use the capabilities of Yandex Maps in mobile applications for iOS and Android. 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:

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.

  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/yandex/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. The instruction on how to obtain NaviKit API key is described in the [documentation] (https://yandex.ru/dev/mapkit/doc/en/android/generated/navigation/getting_started#get-key).

  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 

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 or NaviKit SDK, 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.