{"id":21748311,"url":"https://github.com/surfstudio/yandex-mapkit-lite-flutter","last_synced_at":"2026-05-04T16:32:37.552Z","repository":{"id":219272877,"uuid":"747723847","full_name":"surfstudio/yandex-mapkit-lite-flutter","owner":"surfstudio","description":"Made by Surf 🏄","archived":false,"fork":false,"pushed_at":"2024-04-10T09:34:00.000Z","size":1151,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-10T10:38:27.327Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/surfstudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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}},"created_at":"2024-01-24T14:14:20.000Z","updated_at":"2024-04-15T07:07:27.033Z","dependencies_parsed_at":"2024-03-18T10:02:14.252Z","dependency_job_id":"f1723ebb-a4e0-45a4-938a-18a40c90f0ba","html_url":"https://github.com/surfstudio/yandex-mapkit-lite-flutter","commit_stats":null,"previous_names":["surfstudio/yandex-mapkit-lite-flutter"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2Fyandex-mapkit-lite-flutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2Fyandex-mapkit-lite-flutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2Fyandex-mapkit-lite-flutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2Fyandex-mapkit-lite-flutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/surfstudio","download_url":"https://codeload.github.com/surfstudio/yandex-mapkit-lite-flutter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244723735,"owners_count":20499325,"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":[],"created_at":"2024-11-26T08:13:00.985Z","updated_at":"2026-05-04T16:32:37.483Z","avatar_url":"https://github.com/surfstudio.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yandex Mapkit Light\n\n\u003cimg src=\"https://raw.githubusercontent.com/surfstudio/flutter-open-source/main/assets/logo_black.png#gh-light-mode-only\" width=\"200\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/surfstudio/flutter-open-source/main/assets/logo_white.png#gh-dark-mode-only\" width=\"200\"\u003e\n\nFork of [yandex_mapkit](https://pub.dev/packages/yandex_mapkit) library, but lightweight and more appropriate for the majority of the apps.\n\nMade by [Surf 🏄‍♂️🏄‍♂️🏄‍♂️](https://surf.dev/)\n\n[![Build Status](https://shields.io/github/actions/workflow/status/surfstudio/yandex-mapkit-lite-flutter/on_pull_request.yml?logo=github\u0026logoColor=white)](https://github.com/surfstudio/yandex-mapkit-lite-flutter)\n[![Pub Version](https://img.shields.io/pub/v/yandex_mapkit_lite?logo=dart\u0026logoColor=white)](https://pub.dev/packages/yandex_mapkit_lite)\n[![Pub Likes](https://badgen.net/pub/likes/yandex_mapkit_lite)](https://pub.dev/packages/yandex_mapkit_lite)\n[![Pub popularity](https://badgen.net/pub/popularity/yandex_mapkit_lite)](https://pub.dev/packages/yandex_mapkit_lite/score)\n![Flutter Platform](https://badgen.net/pub/flutter-platform/yandex_mapkit_lite)\n[![License: MIT](https://img.shields.io/badge/license-MIT-purple.svg)](https://opensource.org/licenses/MIT)\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/surfstudio/yandex-mapkit-lite-flutter/main/assets/yandex_mapkit_lite.light.png\" height=\"125\" alt=\"yandex mapkit logo\" /\u003e\n\u003c/p\u003e\n\n## Overview\n\n- :earth_africa: Map overview - enables to view the map of the world, with which user can interact with any convenient way, usually in order to demonstrate the location of some place\n- :house: Custom map objects - enables for developers to add custom map objects in order to indicate some place on the map\n- :video_game: Convenient map controls - there is an API for straight-to-point map controls through the code - from zooming and moving to limiting user scroll and controlling the speed\n- :leaves: App bundle size reduction - noticeable app bundle size reduction comparing to projects with [original package](https://pub.dev/packages/yandex_mapkit)\n- :sparkles: Recommended for use if you don't need anything but basic map\n\n## Usage\n\n### Generate your API Key\n\nBefore you can use MapKit SDK in your application, you need the **API key**.\n\n1) Go to the [Developer Dashboard.](https://developer.tech.yandex.ru/services/)\n\n2) **Log in** to your Yandex account or **create** a new one.\n\n3) Click **Connect APIs** and choose **MapKit Mobile SDK**.\n\n4) Enter information about yourself and your project, select a pricing plan, and click **Continue**.\n\n5) After your API key is successfully created, it will be available in the **API Interfaces → MapKit Mobile SDK** tab.\n\n### Installation\n\nAdd `yandex_mapkit_lite` to your `pubspec.yaml` file:\n\n```yaml\ndependencies:\n  yandex_mapkit_lite: $currentVersion$\n```\n\n### Setup for iOS\n\nSpecify your API key and locale in `ios/Runner/AppDelegate.swift`. It should be similar to the following\n\n```swift\nimport UIKit\nimport Flutter\nimport YandexMapsMobile\n\n@UIApplicationMain\n@objc class AppDelegate: FlutterAppDelegate {\n  override func application(\n    _ application: UIApplication,\n    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?\n  ) -\u003e Bool {\n    YMKMapKit.setLocale(\"YOUR_LOCALE\") // Your preferred language. Not required, defaults to system language\n    YMKMapKit.setApiKey(\"YOUR_API_KEY\") // Your generated API key\n    GeneratedPluginRegistrant.register(with: self)\n    return super.application(application, didFinishLaunchingWithOptions: launchOptions)\n  }\n}\n```\n\nUncomment `platform :ios, '9.0'` in `ios/Podfile` and change to `platform :ios, '12.0'`\n\n```ruby\n# Uncomment this line to define a global platform for your project\nplatform :ios, '12.0'\n```\n\n### Setup for Android\n\nAdd dependency `implementation 'com.yandex.android:maps.mobile:4.4.0-lite'` to `android/app/build.gradle`\n\n```groovy\ndependencies {\n    implementation 'com.yandex.android:maps.mobile:4.4.0-lite'\n}\n```\n\nSpecify your API key and locale in your custom application class. If you don't have one the you can create it like so\n\n`android/app/src/main/.../MainApplication.java`\n\n```java\nimport android.app.Application;\n\nimport com.yandex.mapkit.MapKitFactory;\n\npublic class MainApplication extends Application {\n    @Override\n    public void onCreate() {\n        super.onCreate();\n        MapKitFactory.setLocale(\"YOUR_LOCALE\"); // Your preferred language. Not required, defaults to system language\n        MapKitFactory.setApiKey(\"YOUR_API_KEY\"); // Your generated API key\n    }\n}\n```\n\n`android/app/src/main/.../MainApplication.kt`\n\n```kotlin\nimport android.app.Application\n\nimport com.yandex.mapkit.MapKitFactory\n\nclass MainApplication: Application() {\n  override fun onCreate() {\n    super.onCreate()\n    MapKitFactory.setLocale(\"YOUR_LOCALE\") // Your preferred language. Not required, defaults to system language\n    MapKitFactory.setApiKey(\"YOUR_API_KEY\") // Your generated API key\n  }\n}\n```\n\nIn your `android/app/src/main/AndroidManifest.xml` Add necessary permissions:\n\n```xml\n\u003cuses-permission android:name=\"android.permission.INTERNET\"/\u003e\n\u003cuses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\" /\u003e\n```\n\n## Comparison with the full version\n\nIt is recommended to take into account the drawbacks of this mapkit version.\n\nFor app bundle size optimization purposes, the original package was moved to lite version, so some functionality will not be included:\n\n|                                              | Full version       | Lite version                                                                     |\n|----------------------------------------------|--------------------|----------------------------------------------------------------------------------|\n| Map                                          | :white_check_mark: | :white_check_mark:                                                               |\n| Traffic layer                                | :white_check_mark: | :white_check_mark:                                                               |\n| Offline maps                                 | :white_check_mark: | :white_check_mark:                                                               |\n| Location manager                             | :white_check_mark: | :white_check_mark:                                                               |\n| User location layer                          | :white_check_mark: | :white_check_mark:                                                               |\n| Custom clusterization                        | :x:                | :white_check_mark: - see the example project                                     |\n| Search, hints, geocoding                     | :white_check_mark: | :x: - consider using [yandex_geocoder](https://pub.dev/packages/yandex_geocoder) |\n| Automobile, bicycle, and pedestrian routing  | :white_check_mark: | :x:                                                                              |\n| Routing taking into account public transport | :white_check_mark: | :x:                                                                              |\n| Panorama display                             | :white_check_mark: | :x:                                                                              |\n\nIf your app needs functionality mentioned upper, that is not supported in lite version, consider using [full](https://pub.dev/packages/yandex_mapkit) version.\n\n## Issues\n\n### Minimal versions\n\nThere is OS version and platform restrictions for this package. The table for supported platforms and versions of their OS is presented lower:\n\n|             | Android |   iOS   |\n|-------------|---------|---------|\n| **Support** | SDK 21+ | iOS 12+ |\n\n### Localizations\n\nMapkit can be used with one language only at the same time.\n\nDue to native constraints after the application is launched language can't be changed.\n\n### Android\n\n### Example\n\nExample project is soon to be refactored.\n\n#### Hybrid Composition\n\nBy default android views are rendered using [Hybrid Composition](https://flutter.dev/docs/development/platform-integration/platform-views). In order to render the `YandexMap` widget on Android using Virtual Display (old composition), set [AndroidYandexMap.useAndroidViewSurface] to false before using `YandexMap` widget.\n\n```dart\nAndroidYandexMap.useAndroidViewSurface = false;\n```\n\n### Terms of use\n\n**Disclaimer**: This project uses Yandex Mapkit which belongs to Yandex. When using Mapkit refer to these [terms of use](https://yandex.com/dev/mapkit/doc/en/conditions).\n\nCredits to [Unact](https://github.com/Unact).\n\n## Contribute\n\nTo report your issues, submit them directly in the [Issues](https://github.com/surfstudio/yandex-mapkit-lite-flutter/issues) section.\n\nIf you would like to contribute to the package (e.g. by improving the documentation, fixing a bug or adding a cool new feature), please read our [contribution guide](./CONTRIBUTING.md) first and send us your pull request.\n\nYour PRs are always welcome.\n\n## How to reach us\n\nPlease feel free to ask any questions about this package. Join our community chat on Telegram. We speak English and Russian.\n[![Telegram](https://img.shields.io/badge/chat-on%20Telegram-blue.svg)](https://t.me/surf_flutter)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurfstudio%2Fyandex-mapkit-lite-flutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsurfstudio%2Fyandex-mapkit-lite-flutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurfstudio%2Fyandex-mapkit-lite-flutter/lists"}