Flutter地图服务插件mapbox_api的使用

mapbox_api 是一个用于调用 Mapbox API 的 Dart SDK，它仅依赖于 http 包，并且遵循官方文档。本文将介绍如何在 Flutter 项目中使用 mapbox_api 插件来请求导航和地理编码服务。

快速开始

添加依赖

首先，在你的 pubspec.yaml 文件中添加 mapbox_api 依赖：

dependencies:
  mapbox_api: ^latest_version

然后运行 flutter pub get 来安装依赖。

初始化 MapboxApi

在使用 mapbox_api 之前，你需要从 Mapbox 获取一个 API token。

import 'package:mapbox_api/mapbox_api.dart';

void main() async {
  final mapbox = MapboxApi(
    accessToken: '<Your Mapbox API token>',
  );
}

请求导航服务

示例代码：获取驾驶路线

下面是一个简单的示例，演示如何请求从一个地点到另一个地点的驾驶路线。

import 'package:mapbox_api/mapbox_api.dart';

void main() async {
  final mapbox = MapboxApi(
    accessToken: '<Your Mapbox API token>',
  );

  try {
    final response = await mapbox.directions.request(
      profile: NavigationProfile.DRIVING_TRAFFIC,
      overview: NavigationOverview.FULL,
      geometries: NavigationGeometries.GEOJSON,
      steps: true,
      coordinates: [
        [37.786060, -122.246225], // 起点坐标 (纬度, 经度)
        [37.785939, -122.194292], // 终点坐标 (纬度, 经度)
      ],
    );

    if (response.error == null) {
      if (response.routes != null && response.routes!.isNotEmpty) {
        final route = response.routes![0];
        final eta = Duration(seconds: route.duration!.toInt());
        print('预计到达时间: $eta');
      } else {
        print('未找到路线');
      }
    } else {
      print('请求失败: ${response.error}');
    }
  } catch (e) {
    print('发生错误: $e');
  }
}

处理错误

如果请求失败，response.error 将包含具体的错误信息。你可以根据不同的错误类型进行处理：

if (response.error is NavigationNoRouteError) {
  // 处理找不到路线的情况
} else if (response.error is NavigationNoSegmentError) {
  // 处理找不到路段的情况
}

请求地理编码服务

正向地理编码

正向地理编码是将地址转换为经纬度坐标。以下是如何请求正向地理编码的示例：

import 'package:mapbox_api/mapbox_api.dart';

void main() async {
  final mapbox = MapboxApi(
    accessToken: '<Your Mapbox API token>',
  );

  try {
    final response = await mapbox.forwardGeocoding.request(
      searchText: '埃菲尔铁塔',
      fuzzyMatch: true,
      language: 'fr',
      proximity: [48.858638, 2.286020], // 可选参数，提供附近的参考位置以提高准确性
    );

    if (response.error == null) {
      if (response.features != null && response.features!.isNotEmpty) {
        final feature = response.features![0];
        print('经纬度: ${feature.geometry!.coordinates}');
      } else {
        print('未找到匹配结果');
      }
    } else {
      print('请求失败: ${response.error}');
    }
  } catch (e) {
    print('发生错误: $e');
  }
}

反向地理编码

反向地理编码是将经纬度坐标转换为地址。以下是反向地理编码的示例：

import 'package:mapbox_api/mapbox_api.dart';

void main() async {
  final mapbox = MapboxApi(
    accessToken: '<Your Mapbox API token>',
  );

  try {
    final response = await mapbox.reverseGeocoding.request(
      longitude: 2.286020,
      latitude: 48.858638,
    );

    if (response.error == null) {
      if (response.features != null && response.features!.isNotEmpty) {
        final feature = response.features![0];
        print('地址: ${feature.placeName}');
      } else {
        print('未找到匹配结果');
      }
    } else {
      print('请求失败: ${response.error}');
    }
  } catch (e) {
    print('发生错误: $e');
  }
}

支持的 API

目前 mapbox_api 主要支持以下几类 API：

• Navigation（导航）：包括 Directions、Isochrone、Map Matching、Matrix 和 Optimization。
• Search（搜索）：包括 Forward Geocoding、Reverse Geocoding 和 Intersection。

其他 API 如 Maps、Accounts 等尚未实现。

相关包

• flutter-mapbox-gl：用于在 Flutter 中显示 Mapbox 地图。
• polyline：用于将 polyline 字符串转换为坐标。

通过结合这些包，你可以在 Flutter 应用中实现更丰富的地图功能。

完整示例

完整的示例代码可以在 GitHub 仓库 中找到。其中包括了更多详细的用法和场景。

希望这篇指南能帮助你在 Flutter 项目中成功集成和使用 mapbox_api 插件！如果有任何问题或需要进一步的帮助，请随时查阅官方文档或社区资源。