搜索插件、代码仓与 APP 分类

yandex_mapkit 封面
插件详情v4.3.0

yandex_mapkit

一个用于在 Android 和 iOS 应用程序中集成 Yandex.MapKit 的 Flutter 插件。

AndroidiOS
近 30 天下载
7790
喜欢数
236
Pub 分数
150

安装插件

flutter pub add yandex_mapkit

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Yandex MapKit 是一个 Flutter 插件,可实现 Yandex 地图在 Android 和 iOS 应用中的无缝集成。它通过一致的 Dart API 提供地图渲染、标记、路线和地理编码功能。该插件在两个平台上均支持原生性能,并由社区维护。开发者可以自定义地图外观,处理用户交互,并利用 Yandex 的地图数据提供基于位置的服务。对于需要详细地图和导航工具且 Yandex 地图广泛使用的地区,该插件非常理想。

适合场景

  • 在移动应用中集成 Yandex 地图
  • 显示自定义标记和叠加层
  • 实施路线规划和导航
  • 将地址转换为坐标
  • 构建位置感知的应用程序

主要特点

  • 跨平台支持(Android 和 iOS)
  • 原生地图渲染性能
  • 标记和折线自定义
  • 地理编码和反向地理编码
  • 交互式地图手势和事件

适合对象

  • 面向俄罗斯和独联体市场的应用
  • 使用 Yandex 地图数据的开发者
  • 基于位置的服务应用
  • 导航和路线规划功能

使用建议

  • 需要 Yandex MapKit SDK 设置
  • 与其他插件相比,文档有限
  • 取决于Yandex的区域覆盖范围
  • 需要正确的 API 密钥配置
  • 在 Android 上可能需要额外的权限

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

yandex_mapkit

A flutter plugin for displaying yandex maps on iOS and Android.

Android iOS
Support SDK 26+ iOS 15+

Disclaimer: This project uses Yandex Mapkit which belongs to Yandex
When using Mapkit refer to these terms of use

Features

  • [X] Working with Placemarks/Polylines/Polygons/Circles - adding, updating, removing, tap events, styling
  • [X] Working with collections of map objects and clusters
  • [X] Setting map bounds and limiting user interactions
  • [X] Showing current user location
  • [X] Address suggestions
  • [X] Basic driving/bicycle/pedestrian routing
  • [X] Basic address direct/reverse search
  • [X] Working with geo objects
  • [X] Support for both lite and full variants

Getting Started

Generate your API Key
  1. Go to https://developer.tech.yandex.ru/services/
  2. Create a MapKit Mobile SDK key
Setup for iOS
  • Specify your API key and locale in ios/Runner/AppDelegate.swift. It should be similar to the following
import UIKit
import Flutter
import YandexMapsMobile

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    YMKMapKit.setLocale("YOUR_LOCALE") // Your preferred language. Not required, defaults to system language
    YMKMapKit.setApiKey("YOUR_API_KEY") // Your generated API key
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}
  • Specify your desired variant of native library using environment variable YANDEX_MAPKIT_VARIANT

Available options: lite and full. navikit variant is currently not supported.
Defaults to lite.
After changing YANDEX_MAPKIT_VARIANT you need to invalidate Xcode cache using

rm -rf ~/Library/Developer/Xcode/DerivedData
Setup for Android
  • Specify your desired variant of native library.

Available options: lite and full. navikit variant is currently not supported.
Defaults to lite.

Add the following line to android/gradle.properties

yandexMapkit.variant=<YOUR_DESIRED_VARIANT>
  • Add dependency implementation 'com.yandex.android:maps.mobile:4.39.1-<YOUR_DESIRED_VARIANT>' to android/app/build.gradle
dependencies {
    implementation 'com.yandex.android:maps.mobile:4.39.1-<YOUR_DESIRED_VARIANT>'
}
  • Specify your API key and locale in your custom application class.
    If you don't have one the you can create it like so

android/app/src/main/.../MainApplication.java

import android.app.Application;

import com.yandex.mapkit.MapKitFactory;

public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MapKitFactory.setLocale("YOUR_LOCALE"); // Your preferred language. Not required, defaults to system language
        MapKitFactory.setApiKey("YOUR_API_KEY"); // Your generated API key
    }
}

android/app/src/main/.../MainApplication.kt

import android.app.Application

import com.yandex.mapkit.MapKitFactory

class MainApplication: Application() {
  override fun onCreate() {
    super.onCreate()
    MapKitFactory.setLocale("YOUR_LOCALE") // Your preferred language. Not required, defaults to system language
    MapKitFactory.setApiKey("YOUR_API_KEY") // Your generated API key
  }
}
  • In your android/app/src/main/AndroidManifest.xml

Add permissions <uses-permission android:name="android.permission.INTERNET"/> and <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Find application tag and replace android:name to the name of your custom application class prefixed by a dot .. In the end it should look like the following

    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <application
      android:name=".MainApplication" >
Usage

For usage examples refer to example app

image

Additional remarks
Language

YandexMapkit always works with one language only.
Due to native constraints after the application is launched it can't be changed.

Android. Hybrid Composition

By default android views are rendered using Hybrid Composition.
To render the YandexMap widget on Android using Virtual Display(old composition), set AndroidYandexMap.useAndroidViewSurface to false.
Place this anywhere in your code, before using YandexMap widget.

AndroidYandexMap.useAndroidViewSurface = false;

所属分类

依赖

依赖清单 3 项

源码仓库

使用此插件的项目

暂无相关数据。