Flutter地图服务插件dgis_mobile_sdk_map的使用

Flutter地图服务插件dgis_mobile_sdk_map的使用

本包允许您在应用程序中添加一个2GIS地图。通过此SDK，您可以将地图显示在屏幕上，添加标记，绘制几何形状，构建路线，获取对象信息，控制相机等。

地图数据支持OGC标准。

获取访问密钥

要使用SDK，您需要获得一个带有应用ID的dgissdk.key文件。该密钥用于连接到2GIS服务器，获取地理数据以及使用离线导航器。此密钥是这种类型SDK独有的，不能与其他2GIS SDK一起使用。

要获取密钥文件：

1. 在dev.2gis.ru填写表单。
2. 将生成的密钥文件添加到应用的assets目录中。

激活密钥后，您可以在个人账户Platform Manager中注册并查看请求分布统计。

安装

Android

当为Android构建时，会使用.aar格式的二进制构件。为了正确连接，您需要在应用的build.gradle中添加包含此构件的仓库：

repositories {
    maven {
        url "https://artifactory.2gis.dev/sdk-maven-release"
    }
}

示例应用

本包提供了一个位于example文件夹中的用法示例应用。运行应用之前，请确保将您获得的dgissdk.key文件添加到应用的assets目录中。

示例代码

以下是示例代码，展示了如何使用dgis_mobile_sdk_map插件创建一个基本的地图应用：

import 'pages/add_objects.dart';
import 'pages/all_map_controls.dart';
import 'pages/benchmark.dart';
import 'pages/calc_position.dart';
import 'pages/camera_moves.dart';
import 'pages/clustering.dart';
import 'pages/copyright.dart';
import 'pages/fps_page.dart';
import 'pages/indoor_widget.dart';
import 'pages/map_gestures.dart';
import 'pages/map_objects_identification.dart';
import 'pages/map_snapshot.dart';
import 'pages/search_page.dart';
import 'pages/stateless_screen_with_map.dart';
import 'pages/traffic_widget.dart';
import 'package:flutter/material.dart';

import 'pages/common.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter SDK测试应用',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter SDK测试应用首页'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({required this.title, super.key});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return DefaultTabController(
      length: 2,
      child: Scaffold(
        appBar: AppBar(
          title: Text(widget.title),
          bottom: const TabBar(
            tabs: [
              Tab(text: '地图'),
              Tab(text: '目录'),
            ],
          ),
        ),
        body: TabBarView(
          children: [
            _mapPages(),
            _directoryPages(),
          ],
        ),
      ),
    );
  }

  Widget _mapPages() {
    return ListView(
      children: [
        ListTile(
          title: buildPageTitle('添加对象'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) => AddObjectsPage(title: '添加对象')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('所有地图控件'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      AllMapControlsPage(title: '所有地图控件')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('基准测试'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) => BenchmarkPage(title: '基准测试')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('计算位置'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      CalcPositionPage(title: '计算位置')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('相机移动'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      CameraMovesPage(title: '相机移动')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('聚类'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      ClusteringPage(title: '聚类')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('版权信息'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      CopyrightPage(title: '版权信息')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('帧率显示'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(builder: (context) => FpsPage(title: '帧率显示')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('室内小部件'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      IndoorWidgetPage(title: '室内小部件')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('地图手势'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      MapGesturesPage(title: '地图手势')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('地图对象识别'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      MapObjectsIdentificationPage(
                          title: '地图对象识别')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('地图快照'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      MapSnapshotPage(title: '地图快照')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('简单的地图屏幕（无状态小部件）'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      SimpleMapScreen(
                          title: '简单的地图屏幕（无状态小部件）')),
            );
          },
        ),
        ListTile(
          title: buildPageTitle('交通小部件'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      TrafficWidgetPage(title: '交通小部件')),
            );
          },
        ),
      ],
    );
  }

  Widget _directoryPages() {
    return ListView(
      children: [
        ListTile(
          title: buildPageTitle('搜索'),
          onTap: () {
            Navigator.push(
              context,
              MaterialPageRoute(
                  builder: (context) =>
                      SearchPage(title: '搜索')),
            );
          },
        ),
      ],
    );
  }
}