Flutter地图服务插件mapbox_api_pro的使用

本包旨在：

• 成为一个仅依赖于http的Mapbox API的Dart SDK。
• 遵循官方文档。

示例

查看examples/以获取所有可用示例。

import 'package:mapbox_api_pro/mapbox_api_pro.dart';

MapboxApi mapbox = MapboxApi(
  accessToken: '<Mapbox API token>',
);

获取您的API令牌，请访问mapbox.com

请求方向服务

final response = await mapbox.directions.request(
  profile: NavigationProfile.DRIVING_TRAFFIC,
  overview: NavigationOverview.FULL,
  geometries: NavigationGeometries.GEOJSON,
  steps: true,
  coordinates: <List<double>>[
    <double>[
      37.786060, // 纬度
      -122.246225, // 经度
    ],
    <double>[
      37.785939, // 纬度
      -122.194292, // 经度
    ],
  ],
);

if (response.error == null) {
  // response.routes ...
  // response.waypoints ...
}

查看基本示例：example/example.dart 查看完整的Flutter GL示例：example/example_directions_flutter.dart

请求正向地理编码服务

final response = await mapbox.forwardGeocoding.request(
  searchText: 'tour eiffel',
  fuzzyMatch: true,
  language: 'fr',
  proximity: <double>[
    48.858638, // 纬度
    2.286020, // 经度
  ],
);

if (response.error == null) {
  // response.features ...
}

查看完整示例：example/example_forward_search.dart

支持的API

地图

导航

搜索

账户

相关包

该SDK将与mapbox_maps_flutter完美配合以显示检索到的数据（也可以与其他任何包一起使用）。您可能还需要polyline包来将多段线字符串转换为坐标。

完整示例代码

以下是一个完整的示例代码，展示了如何使用mapbox_api_pro插件请求方向服务并处理响应。

import 'package:mapbox_api_pro/mapbox_api_pro.dart';

void main() async {
  /**
   * 获取您的Mapbox API令牌，请访问 https://www.mapbox.com/
   */
  final mapbox = MapboxApi(
    accessToken: '<Mapbox API token>',
  );

  /**
   * 这里是一个简单的HTTPS调用到方向API。
   * 所有参数都符合官方文档
   * 并在 https://docs.mapbox.com/api/ 中描述
   *
   * 可用API：
   *  - mapbox.directions
   *  - mapbox.isochrome
   *  - mapbox.mapMatching
   *  - mapbox.matrix
   *  - mapbox.optimization
   *  - mapbox.forwardGeocoding
   *  - mapbox.reverseGeocoding
   *  - mapbox.intersection
   *
   */
  final response = await mapbox.directions.request(
    profile: NavigationProfile.DRIVING_TRAFFIC,
    overview: NavigationOverview.FULL,
    geometries: NavigationGeometries.GEOJSON,
    steps: true,
    coordinates: <List<double>>[
      <double>[
        37.786060, // 纬度
        -122.246225, // 经度
      ],
      <double>[
        37.785939, // 纬度
        -122.194292, // 经度
      ],
    ],
  );

  if (response.error != null) {
    if (response.error is NavigationNoRouteError) {
      // 处理无路线响应
    } else if (response.error is NavigationNoSegmentError) {
      // 处理无段落响应
    }

    return;
  }

  if (response.routes!.isNotEmpty) {
    final route = response.routes![0];
    final eta = Duration(
      seconds: route.duration!.toInt(),
    );
    print(eta.toString());
  }
}