Flutter地图瓦片插件mbtiles的使用

mbtiles

Mapbox MBTiles v1.3 文件，支持矢量和栅格瓦片。

• 支持的栅格瓦片：jpg、png、webp
• 支持的矢量瓦片：pbf
• Web 不支持，因为它缺少对 SQLite 的支持。

Getting started

pubspec.yaml

dependencies:
  # this package:
  mbtiles: ^0.4.0
  # coordinates will be returned as `LatLng`, include the following package 
  # if you want to work with them.
  latlong2: ^0.9.0
  # sqlite libraries (in case not otherwise bundled)
  sqlite3_flutter_libs: ^0.5.18

Usage

这个包设计时没有依赖于 Flutter，因此可以在 Dart 程序中使用。如果你想要在 Flutter 应用中使用它，请参考 Flutter 指令，如果你想在纯 Dart 中使用它，请参考 Dart-only 指令。

Flutter

1. 如果你不提供 sqlite3 库，则需要添加 sqlite3_flutter_libs 包作为依赖。
2. 打开你的 .mbtiles 文件。
   • 建议将 mbtiles 文件存储在由 path_provider 提供的目录之一中。
   • 如果你想从内部设备存储或 SD 卡打开文件，你需要先请求权限！你可以使用 permission_handler 来请求所需的用户权限。
   • 注意：mbtiles 文件不能放在 Flutter 资源中！请先将其复制到文件系统中。

示例代码

import 'package:mbtiles/mbtiles.dart';
import 'package:path_provider/path_provider.dart';

Future<void> main() async {
  // 获取应用文档目录路径
  final appDocDir = await getApplicationDocumentsDirectory();
  final mbtilesPath = '${appDocDir.path}/your-mbtiles-file.mbtiles';

  // 打开 mbtiles 文件为只读
  final mbtiles = MBTiles(mbtilesPath: mbtilesPath);

  // 获取元数据
  final metadata = await mbtiles.getMetadata();
  print('Metadata: $metadata');

  // 获取瓦片数据
  final tile = await mbtiles.getTile(z: 0, x: 0, y: 0);
  if (tile != null) {
    print('Tile size: ${tile.length}');
  } else {
    print('Tile not found');
  }

  // 关闭 mbtiles 文件
  await mbtiles.dispose();
}

Dart-only

1. 打开 mbtiles 数据库。
   • 你需要为 Dart 程序提供平台特定的 sqlite3 库。
   • 可以在 www.sqlite.org 上获取构建版本。

示例代码

import 'package:mbtiles/mbtiles.dart';

void main() {
  // 根据操作系统选择 sqlite3 路径
  final sqlitePath = switch (Platform.operatingSystem) {
    'windows' => r'assets\windows\sqlite3.dll',
    'macos' => 'assets/macos/sqlite3',
    'linux' => 'assets/linux/sqlite3',
    String() => throw Exception(
        'The example program is dart-only and running it on flutter is '
        'not supported.\n'
        'If you want to use this package in a flutter app, head over to '
        'the package documentation!',
      ),
  };

  // 打开 mbtiles 文件
  final mbtiles = MBTiles(
    mbtilesPath: 'assets/mbtiles/countries-raster.mbtiles',
    sqlitePath: sqlitePath,
  );

  // 获取元数据
  final metadata = mbtiles.getMetadata();
  print('Metadata: $metadata');

  // 获取瓦片数据
  final tile = mbtiles.getTile(z: 0, x: 0, y: 0);
  if (tile != null) {
    print('Tile size: ${formatSize(tile.length)}');
  } else {
    print('Tile not found');
  }

  // 关闭 mbtiles 文件
  mbtiles.dispose();
}

/// 返回格式化的字节大小字符串
String formatSize(int amountBytes, {int decimals = 0}) {
  const suffixes = ["b", "kb", "mb", "gb", "tb"];
  if (amountBytes == 0) return '0${suffixes[0]}';
  final i = (log(amountBytes) / log(1024)).floor();
  return ((amountBytes / pow(1024, i)).toStringAsFixed(decimals)) + suffixes[i];
}

Additional information

• MBTiles specification
• Read about MBTiles in the OpenStreetMap Wiki

通过上述步骤和示例代码，你应该能够在 Flutter 或纯 Dart 环境中成功使用 mbtiles 插件来处理地图瓦片文件。