{"id":18682840,"url":"https://github.com/yandex/mapkit-android-demo","last_synced_at":"2025-05-16T07:07:13.864Z","repository":{"id":38485126,"uuid":"124944765","full_name":"yandex/mapkit-android-demo","owner":"yandex","description":"MapKit Android demo","archived":false,"fork":false,"pushed_at":"2025-03-26T15:52:42.000Z","size":87520,"stargazers_count":131,"open_issues_count":28,"forks_count":61,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-08T18:19:46.397Z","etag":null,"topics":["android","mapkit","mapkit-android-demo","maps","yandex"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yandex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-12T20:04:47.000Z","updated_at":"2025-04-04T02:20:39.000Z","dependencies_parsed_at":"2022-07-11T19:53:29.910Z","dependency_job_id":"823cc0c5-7eb5-419c-8bda-fa5a27d33bd2","html_url":"https://github.com/yandex/mapkit-android-demo","commit_stats":{"total_commits":68,"total_committers":17,"mean_commits":4.0,"dds":0.7794117647058824,"last_synced_commit":"b21887129fc9768e204f5203e976c400fe8a438a"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-android-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-android-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-android-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex%2Fmapkit-android-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yandex","download_url":"https://codeload.github.com/yandex/mapkit-android-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485065,"owners_count":22078767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","mapkit","mapkit-android-demo","maps","yandex"],"created_at":"2024-11-07T10:12:59.130Z","updated_at":"2025-05-16T07:07:08.841Z","avatar_url":"https://github.com/yandex.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yandex MapKit and NaviKit Demo Apps\n\nYandex 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](https://yandex.ru/dev/mapkit/doc/en/?from=github-demo) page.\n\nFor a quick start development with the MapKit and NaviKit SDKs visit the following pages:\n- [Getting started with MapKit SDK](https://yandex.ru/dev/mapkit/doc/en/android/generated/getting_started)\n- [Getting started with NaviKit SDK](https://yandex.ru/dev/mapkit/doc/en/android/generated/navigation/getting_started)\n\nThe current repository contains sample code for how to use the MapKit and NaviKit SDKs for Android applications.\n\n## Project structures\n\nThere are three Android projects in the repository:\n\n1. [__`mapkit-samples`__](mapkit-samples): Contains several Android applications with sample code in Kotlin, all of which are demonstrated in the MapKit SDK Tutorials documentation.\n\n    - [`map-with-placemark`](mapkit-samples/map-with-placemark): A simple MapKit SDK application with [Getting started with MapKit for Android](https://yandex.ru/dev/mapkit/doc/en/android/generated/getting_started) information.\n\n    - [`map-objects`](mapkit-samples/map-objects): Using the [Map Objects](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_objects) API to add objects to the map.\n\n    - [`map-interaction`](mapkit-samples/map-interaction): Examples from the [Map Interaction](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_interaction) tutorial.\n\n    - [`map-search`](mapkit-samples/map-search): Examples of how to use the [Search](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_search) and [Geosuggest](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_suggest) functionality.\n\n    - [`map-routing`](mapkit-samples/map-routing): About the [Routes](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_routes) and [Routing](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_routing) API.\n\n    - [`map-offline`](mapkit-samples/map-offline): Examples of using the [Offline Maps](https://yandex.ru/dev/mapkit/doc/en/android/generated/tutorials/map_offline) API for working with MapKit's maps without the internet.\n\n2. [__`mapkit-demo`__](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.\n\n3. [__`navikit-demo`__](navikit-demo): A demo application showcasing the basic navigation features you can implement with NaviKit SDK.\n\n## Build locally\n\n1. Clone the repository: \n    ```sh\n    git clone https://github.com/yandex/mapkit-android-demo.git\n    ```\n\n2. MapKit SDK demo application and samples require __API key__. You can get a free MapKit __API key__ in the [Get the MapKit API Key](https://yandex.ru/dev/mapkit/doc/en/android/generated/getting_started#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). \n \n3. Depending on the project you want to build, follow the steps in the following sections.\n\n### mapkit-samples\n\n1. 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:\n    \n    ```properties\n    MAPKIT_API_KEY=YOUR_API_KEY\n    ```\n\n2. Choose a target in Android Studio for build, or use a CLI build with gradle wrapper:\n    \n    ```sh\n    ./gradlew :map-with-placemark:assembleRelease\n    ```\n\n### mapkit-demo\n\n1. Open the [`MainApplication.java`](mapkit-demo/src/main/java/com/yandex/mapkitdemo/MainApplication.java) and edit the `MAPKIT_API_KEY` field, setting its value with your __API key__ in place of the `your_api_key` placeholder:\n    \n    ```java\n    private final String MAPKIT_API_KEY = \"your_api_key\";\n    ```\n\n2. Run the __mapkit-demo__ target in Android Studio or use the CLI build with gradle wrapper:\n\n    ```sh\n    ./gradlew assembleLiteRelease  # Lite MapKit samples only\n    ./gradlew assembleFullRelease  # Lite and full \n    ```\n\n### navikit-demo\n\n1. 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:\n    \n    ```properties\n    MAPKIT_API_KEY=YOUR_API_KEY\n    ```\n\n2. Run the __app__ target in Android Studio or use the CLI build with gradle wrapper:\n\n    ```sh\n    ./gradlew assembleRelease\n    ```\n\n## Support\n\nIf you have problems or suggestions while using MapKit or NaviKit SDK, visit the [contact](https://yandex.ru/dev/mapkit/doc/en/feedback/) page.\n\n## Sample overview\n\n| [map-with-placemark](mapkit-samples/map-with-placemark) \u003cbr\u003eDemonstrates how to create a MapKit map, move\u003cbr\u003eit, and display custom tappable placemarks. | [map-objects](mapkit-samples/map-objects) \u003cbr\u003eHow to display different objects on the map, including:\u003cbr\u003eimages, geometries, and clusterized collections. |\n|:-|:-|\n| ![](_assets/map_with_placemark_demo.gif) | ![](_assets/map_objects_demo.gif) | \n\n| [map-interaction](mapkit-samples/map-interaction)\u003cbr\u003e About interacting with the MapKit map using \u003cbr\u003ecamera movements, tap actions, focus rect \u003cbr\u003e and focus point, and interactions with POIs. | [map-search](mapkit-samples/map-search) \u003cbr\u003eShows how to use Search and Geosuggest \u003cbr\u003efunctionality in the full MapKit SDK. |\n|:-|:-|\n| ![](_assets/map_interaction_demo.gif) | ![](_assets/map_search_demo.gif) |\n\n| [map-routing](mapkit-samples/map-routing)\u003cbr\u003e Building routes using requested map points. | [map-offline](mapkit-samples/map-offline) \u003cbr\u003e How to download offline maps to use\u003cbr\u003e them without the internet. |\n|:-|:-|\n| ![](_assets/map_routing_demo.gif) | ![](_assets/map_offline_demo.gif) |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex%2Fmapkit-android-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyandex%2Fmapkit-android-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex%2Fmapkit-android-demo/lists"}