google_maps_navigation

Description:

google maps navigation

Google Navigation for Flutter (Beta) #
Description #
This repository contains a Flutter plugin that provides a Google Navigation widget to Flutter apps targeting Android and iOS.

Note
This package is in Beta until it reaches version 1.0. According to semantic versioning, breaking changes may be introduced before 1.0.

Requirements #




Android
iOS




Minimum mobile OS supported
API level 23+
iOS 14.0+




A Flutter project


A Google Cloud project with a Mobility solution enabled, such as On-Demand Rides and Deliveries or Last Mile Fleet Solution. This requires you to Contact Sales as described in the Mobility services documentation.
In that Google Cloud project, these four products also need to be enabled depending on the target(s) of your Flutter app:

Maps SDK for Android
Navigation SDK for Android
Maps SDK for iOS
Navigation SDK for iOS




An API key from the project above
If targeting Android, Google Play Services installed and enabled
Attributions and licensing text added to your app


Important
Apply API restrictions to the API key to limit usage to "Navigation SDK, "Maps SDK for Android", and "Maps SDK for iOS" for enhanced security and cost management. This helps guard against unauthorized use of your API key.

Installation #

To add the Google Navigation for Flutter package to your project, use the command:

pub add google_navigation_flutter
copied to clipboard


Set the minimum platform version for the platform(s) targeted by your app.
Android #
Set the minSdkVersion in android/app/build.gradle:
android {
defaultConfig {
minSdkVersion 23
}
}
copied to clipboard
iOS #

Open the ios/Podfile config file in your preferred IDE.
Add the following lines to the beginning of this Podfile:

# Set platform to 14.0 to enable latest Google Maps SDK
platform :ios, '14.0'
copied to clipboard


Add your API key to the Flutter project using these instructions for the corresponding Android (build.gradle) and iOS (AppDelegate.swift) files. The instructions for this step in the google_maps_flutter package documentation apply to the google_navigation_flutter package as well.


See the example configuration for Secrets Gradle Plugin in the example app's build.gradle file.
To securely load your API key, use the Secrets Gradle Plugin. This plugin helps manage API keys without exposing them in your app's source code.
For more details, see Google Navigation SDK Documentation.
Usage #
You can now add a GoogleMapsNavigationView widget to your widget tree.
The view can be controlled with the GoogleNavigationViewController that is passed to via onViewCreated callback.
The GoogleMapsNavigationView widget should be used within a widget with a bounded size. Using it
in an unbounded widget will cause the application to throw a Flutter exception.
Add a navigation view #
import 'package:flutter/material.dart';
import 'package:google_maps_navigation/google_maps_navigation.dart';

class NavigationSample extends StatefulWidget {
const NavigationSample({super.key});

@override
State<NavigationSample> createState() => _NavigationSampleState();
}

class _NavigationSampleState extends State<NavigationSample> {
GoogleNavigationViewController? _navigationViewController;
bool _navigationSessionInitialized = false;

@override
void initState() {
super.initState();
_initializeNavigationSession();
}

Future<void> _initializeNavigationSession() async {
if (!await GoogleMapsNavigator.areTermsAccepted()) {
await GoogleMapsNavigationManager.showTermsAndConditionsDialog(
'Example title',
'Example company',
);
}
// Note: make sure user has also granted location permissions before starting navigation session.
await GoogleMapsNavigator.initializeNavigationSession();
setState(() {
_navigationSessionInitialized = true;
});
}

@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Google Maps Navigation Sample')),
body: _navigationSessionInitialized
? GoogleMapsNavigationView(
onViewCreated: _onViewCreated,
initialNavigationUIEnabledPreference: NavigationUIEnabledPreference.disabled,
// Other view initialization settings
)
: const Center(child: CircularProgressIndicator()),
);
}

void _onViewCreated(GoogleNavigationViewController controller) {
_navigationViewController = controller;
controller.setMyLocationEnabled(true);
// Additional setup can be added here.
}

@override
void dispose() {
if (_navigationSessionInitialized) {
GoogleMapsNavigator.cleanup();
}
super.dispose();
}
}
copied to clipboard
See the example directory for a complete navigation sample app.
Requesting and handling permissions #
The Google Navigation SDK Flutter plugin offers functionalities that necessitate specific permissions from the mobile operating system. These include, but are not limited to, location services, background execution, and receiving background location updates.

Note
The management of these permissions falls outside the scope of the Navigation SDKs for Android and iOS. As a developer integrating these SDKs into your applications, you are responsible for requesting and obtaining the necessary permissions from the users of your app.

You can see example of handling permissions in the main.dart file of the example application:
PermissionStatus _locationPermissionStatus = PermissionStatus.denied;

// ...

/// Request permission for accessing the device's location.
///
/// Android: Fine and Coarse Location
/// iOS: CoreLocation (Always and WhenInUse)
Future<void> _requestLocationPermission() async {
final PermissionStatus status = await Permission.location.request();

setState(() {
_locationPermissionStatus = status;
});
}

// ...

@override
Widget build(BuildContext context) {
_requestLocationPermission();
...
}
copied to clipboard
Contributing #
See the Contributing guide.
Terms of Service #
This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the Google Maps Platform Terms of Service.
This library is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this library.
Support #
This package is offered via an open source license. It is not governed by the Google Maps Platform Support Technical Support Services Guidelines, the SLA, or the Deprecation Policy (however, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service).
This package adheres to semantic versioning to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.
If you find a bug, or have a feature request, please file an issue on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our developer community channels. If you'd like to contribute, please check the Contributing guide.