Hey there! I get it—Google's docs can be a bit overwhelming when you're trying to figure out navigation setup. Let me break down exactly how to implement GPS navigation with Google Maps in your app, covering both Android and iOS since you didn't specify a platform.

1. 基础配置先搞定 #

First, make sure your project has the right dependencies and permissions:

• Add these to your module-level build.gradle file:

dependencies {
    // Core Maps SDK
    implementation 'com.google.android.gms:play-services-maps:18.1.0'
    // Location services for current position
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    // For in-app navigation (if you don't want to launch the Maps app)
    implementation 'com.google.android.libraries.navigation:navigation:2.7.0'
}

• Add permissions and your API key to AndroidManifest.xml:

<!-- Location permissions -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />

<!-- Google Maps API key -->
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="YOUR_GOOGLE_MAPS_API_KEY" />

2. 两种导航实现方式 #

方式一：直接唤起Google Maps应用（简单快捷） #

If you don't need a custom navigation UI, just launch the official Google Maps app with your destination:

// Define your destination (can be coordinates or a street address)
val destination = "37.7749,-122.4194" // San Francisco
// Mode options: d=driving, w=walking, b=bicycling, t=transit
val gmmIntentUri = Uri.parse("google.navigation:q=$destination&mode=d")

val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps") // Ensure we open Google Maps specifically

// Check if Google Maps is installed before launching
if (mapIntent.resolveActivity(packageManager) != null) {
    startActivity(mapIntent)
} else {
    // Fallback: Open web-based Maps
    val webUri = Uri.parse("https://www.google.com/maps/dir/?api=1&destination=$destination&travelmode=driving")
    startActivity(Intent(Intent.ACTION_VIEW, webUri))
}

方式二：在应用内嵌入导航（自定义界面） #

For a seamless in-app experience, use the Google Navigation SDK:

• Add a NavView to your layout:

<com.google.android.libraries.navigation.NavView
    android:id="@+id/navView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

• Initialize navigation in your Activity/Fragment:

val navView = findViewById<NavView>(R.id.navView)

// Set up navigation callbacks
val navigationOptions = NavigationOptions.Builder()
    .setNavigationListener(object : NavigationListener {
        override fun onNavigationStarted() {
            // Handle navigation start (e.g., hide UI elements)
        }
        override fun onNavigationStopped() {
            // Handle navigation stop (e.g., show main UI)
        }
        override fun onArrival() {
            // Trigger when user reaches destination
            Toast.makeText(this@MainActivity, "You've arrived!", Toast.LENGTH_SHORT).show()
        }
        // Implement other callbacks as needed
    })
    .build()

// Define start (current location) and end points
val startLatLng = LatLng(37.7749, -122.4194) // Replace with user's current location
val endLatLng = LatLng(37.3352, -122.0322) // San Jose

// Create route request
val routeRequest = RouteRequest.Builder()
    .setOrigin(startLatLng)
    .setDestination(endLatLng)
    .setTravelMode(TravelMode.DRIVING)
    .build()

// Start navigation
navView.startNavigation(routeRequest, navigationOptions)

Don't forget to request location permissions first—users need to grant access before you can get their current position!

1. 项目配置 #

• Use CocoaPods to add dependencies:

pod 'GoogleMaps'
pod 'GoogleNavigation'

• Add permissions and API key setup:
  • In Info.plist, add location permission descriptions:

  <key>NSLocationWhenInUseUsageDescription</key>
  <string>We need your location to provide turn-by-turn navigation</string>
  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>We need your location to provide turn-by-turn navigation</string>
  

  • Initialize the SDK in AppDelegate.swift:

  import GoogleMaps
  
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      GMSServices.provideAPIKey("YOUR_GOOGLE_MAPS_API_KEY")
      return true
  }
  

2. 两种导航实现方式 #

方式一：唤起Google Maps应用 #

Just like Android, you can launch the official app for navigation:

let destination = "37.7749,-122.4194"
// URL scheme for Google Maps
if let mapsUrl = URL(string: "comgooglemaps://?daddr=\(destination)&directionsmode=driving") {
    if UIApplication.shared.canOpenURL(mapsUrl) {
        UIApplication.shared.open(mapsUrl, options: [:], completionHandler: nil)
    } else {
        // Fallback to web Maps
        let webUrl = URL(string: "https://www.google.com/maps/dir/?api=1&destination=\(destination)&travelmode=driving")!
        UIApplication.shared.open(webUrl)
    }
}

方式二：应用内嵌入导航 #

Use the Google Navigation SDK for in-app navigation:

import GoogleNavigation

// Define start and end coordinates
let startCoord = CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194)
let endCoord = CLLocationCoordinate2D(latitude: 37.3352, longitude: -122.0322)

// Create waypoints
let startWaypoint = GMSNavigationWaypoint(coordinate: startCoord)
let endWaypoint = GMSNavigationWaypoint(coordinate: endCoord)

// Initialize navigation view controller
let navVC = GMSNavigationViewController(waypoints: [startWaypoint, endWaypoint], travelMode: .driving)

// Set delegate to handle navigation events
navVC.navigationDelegate = self

// Present the navigation UI
present(navVC, animated: true)

Implement the GMSNavigationDelegate to handle events:

extension YourViewController: GMSNavigationDelegate {
    func navigationViewController(_ navigationViewController: GMSNavigationViewController, didStartNavigation route: GMSRoute) {
        // Navigation started
    }
    
    func navigationViewControllerDidFinishNavigation(_ navigationViewController: GMSNavigationViewController) {
        // Navigation ended, dismiss the VC
        dismiss(animated: true)
    }
    
    func navigationViewController(_ navigationViewController: GMSNavigationViewController, didArriveAt waypoint: GMSNavigationWaypoint) {
        // User reached destination
        let alert = UIAlertController(title: "Arrived!", message: "You've reached your destination.", preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        navigationViewController.present(alert, animated: true)
    }
}

• Enable APIs in Google Cloud: Make sure your Google Cloud project has the Maps SDK for Android/iOS and Navigation SDK enabled, and your API key has the correct restrictions (e.g., tied to your app's package/bundle ID).
• Permission Handling: Always request location permissions from users before attempting to access their position or start navigation—this is required by both Android and iOS.
• Test on Real Devices: Emulators/simulators have limited location capabilities; testing on a physical device will give you accurate navigation behavior.

内容的提问来源于stack exchange，提问作者user9035169