flutter_mapbox_navigation 0.0.2

flutter_mapbox_navigation #

Add Turn By Turn Navigation to Your Flutter Application Using MapBox. Never leave your app when you need to navigate your users to a location.

Features #

IOS Configuration #

  1. Mapbox APIs and vector tiles require a Mapbox account and API access token. In the project editor, select the application target, then go to the Info tab. Under the “Custom iOS Target Properties” section, set MGLMapboxAccessToken to your access token. You can obtain an access token from the Mapbox account page.

  2. In order for the SDK to track the user’s location as they move along the route, set NSLocationWhenInUseUsageDescription to:

    Shows your location on the map and helps improve OpenStreetMap.

  3. Users expect the SDK to continue to track the user’s location and deliver audible instructions even while a different application is visible or the device is locked. Go to the Capabilities tab. Under the Background Modes section, enable “Audio, AirPlay, and Picture in Picture” and “Location updates”. (Alternatively, add the audio and location values to the UIBackgroundModes array in the Info tab.)

Android Configuration #

  1. Mapbox APIs and vector tiles require a Mapbox account and API access token. Add your token in strings.xml file of your android apps res/values/ path. The string key should be "mapbox_access_token". You can obtain an access token from the Mapbox account page.
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name">Navigation map</string>
    <string name="mapbox_access_token" translatable="false">ADD_MAPBOX_ACCESS_TOKEN_HERE</string>
    <string name="user_location_permission_explanation">This app needs location permissions to show its functionality.</string>
    <string name="user_location_permission_not_granted">You didn\'t grant location permissions.</string>
</resources>
  1. Add the following permission to the app level Android Manifest
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Usage #


  final origin = Location(name: "Buffalo, NY", latitude: 42.886448, longitude: -78.878372);
  final destination = Location(name: "Boston, MA", latitude: 42.360081, longitude: -71.058884);
  
  await FlutterMapboxNavigation.startNavigation(origin, destination);
  

Screenshots #

Navigation ViewAndroid View
iOS ViewAndroid View

To Do #

  • [DONE] Android Implementation
  • Add more settings like Navigation Mode (driving, walking, etc)
  • Stream Events like relevant navigation notifications, metrics, current location, etc.
  • Embeddable Navigation View
  • Provide physical address instead of just coordinates to remove reliance on other geolocation packages

0.0.2 #

  • Added Android Support

0.0.1 #

  • Initial Release That Targets only iOS

example/README.md

flutter_mapbox_navigation_example #

Demonstrates how to use the flutter_mapbox_navigation plugin.

Usage #


  final origin = Location(name: "Buffalo, NY", latitude: 42.886448, longitude: -78.878372);
  final destination = Location(name: "Boston, MA", latitude: 42.360081, longitude: -71.058884);
  
  await FlutterMapboxNavigation.startNavigation(origin, destination);
  

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  flutter_mapbox_navigation: ^0.0.2

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:flutter_mapbox_navigation/flutter_mapbox_navigation.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
43
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
90
Overall:
Weighted score of the above. [more]
70
Learn more about scoring.

We analyzed this package on Aug 21, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.4.0
  • pana: 0.12.19
  • Flutter: 1.7.8+hotfix.4

Platforms

Detected platforms: Flutter

References Flutter, and has no conflicting libraries.

Health suggestions

Format lib/flutter_mapbox_navigation.dart.

Run flutter format to format lib/flutter_mapbox_navigation.dart.

Maintenance suggestions

Package is pre-v0.1 release. (-10 points)

While nothing is inherently wrong with versions of 0.0.*, it might mean that the author is still experimenting with the general direction of the API.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.1.0 <3.0.0
flutter 0.0.0
Transitive dependencies
collection 1.14.11 1.14.12
meta 1.1.6 1.1.7
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
flutter_test