capacitor-google-navigation 0.0.5 → 0.0.7

package/README.md

@@ -490,6 +490,27 @@ The Android Navigation SDK validates the API key from `AndroidManifest.xml`. Ens
 **iOS — "This app has attempted to access privacy-sensitive data"**
 Add both `NSLocationWhenInUseUsageDescription` and `NSLocationAlwaysAndWhenInUseUsageDescription` to `Info.plist` before calling `initialize()`.
 
+**iOS — App crashes with "Invalid parameter not satisfying: CLClientIsBackgroundable"**
+The Navigation SDK requires background location capability to track position during guidance. In Xcode:
+1. Select your app target → **Signing & Capabilities** → **+ Capability** → **Background Modes**
+2. Check **Location updates**
+
+Also ensure all three keys are present in `Info.plist`:
+```xml
+<key>NSLocationWhenInUseUsageDescription</key>
+<string>This app uses your location for navigation.</string>
+<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
+<string>This app uses your location for navigation, including in the background.</string>
+<key>NSLocationAlwaysUsageDescription</key>
+<string>This app uses your location for navigation, including in the background.</string>
+```
+
+**iOS — "This application has been blocked by the Google Navigation SDK"**
+The Navigation SDK requires explicit enrollment — it is not available to all Google Cloud projects by default. Ensure:
+1. The **Navigation SDK for iOS** is enabled under APIs & Services → Library in Google Cloud Console
+2. Your project has been granted access (you may need to request it via the [Navigation SDK get started page](https://developers.google.com/maps/documentation/navigation/ios-sdk/get-started))
+3. Billing is active on the project
+
 **CocoaPods not found / pod install fails**
 Make sure CocoaPods is installed (`sudo gem install cocoapods`) and run `npx cap sync` before `pod install`.
 

package/ios/Sources/GoogleNavigationPlugin/GoogleNavigation.swift

@@ -15,6 +15,7 @@ import GoogleNavigation
 
     func initialize(apiKey: String, completion: @escaping (Bool, String?) -> Void) {
         DispatchQueue.main.async {
+            print("[GoogleNavigation] provideAPIKey called, key length: \(apiKey.count), prefix: \(String(apiKey.prefix(8)))...")
             GMSServices.provideAPIKey(apiKey)
             completion(true, nil)
         }

package/ios/Sources/GoogleNavigationPlugin/NavigationViewController.swift

@@ -17,26 +17,28 @@ class NavigationMapViewController: UIViewController {
     }
 
     override func loadView() {
+        let container = UIView(frame: UIScreen.main.bounds)
+
         let options = GMSMapViewOptions()
-        options.frame = UIScreen.main.bounds
+        options.frame = container.bounds
         let mapView = GMSMapView(options: options)
+        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        container.addSubview(mapView)
         self.mapView = mapView
-        self.view = mapView
-    }
 
-    override func viewDidLoad() {
-        super.viewDidLoad()
-
-        guard let mapView = mapView else { return }
-        let enabled = mapView.enableNavigation(with: session)
-        if enabled {
-            mapView.cameraMode = .following
-        }
-
-        addCloseButton()
-    }
+        // Overlay sits above the map and all Google-rendered UI
+        let overlay = UIView()
+        overlay.translatesAutoresizingMaskIntoConstraints = false
+        overlay.isUserInteractionEnabled = true
+        overlay.backgroundColor = .clear
+        container.addSubview(overlay)
+        NSLayoutConstraint.activate([
+            overlay.topAnchor.constraint(equalTo: container.topAnchor),
+            overlay.bottomAnchor.constraint(equalTo: container.bottomAnchor),
+            overlay.leadingAnchor.constraint(equalTo: container.leadingAnchor),
+            overlay.trailingAnchor.constraint(equalTo: container.trailingAnchor),
+        ])
 
-    private func addCloseButton() {
         let button = UIButton(type: .system)
         button.setImage(UIImage(systemName: "xmark"), for: .normal)
         button.tintColor = .white
@@ -44,14 +46,24 @@ class NavigationMapViewController: UIViewController {
         button.layer.cornerRadius = 20
         button.translatesAutoresizingMaskIntoConstraints = false
         button.addTarget(self, action: #selector(closeTapped), for: .touchUpInside)
-        view.addSubview(button)
-
+        overlay.addSubview(button)
         NSLayoutConstraint.activate([
-            button.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor, constant: 16),
-            button.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 16),
+            button.topAnchor.constraint(equalTo: overlay.safeAreaLayoutGuide.topAnchor, constant: 16),
+            button.leadingAnchor.constraint(equalTo: overlay.leadingAnchor, constant: 16),
             button.widthAnchor.constraint(equalToConstant: 40),
-            button.heightAnchor.constraint(equalToConstant: 40)
+            button.heightAnchor.constraint(equalToConstant: 40),
         ])
+
+        self.view = container
+    }
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        guard let mapView = mapView else { return }
+        let enabled = mapView.enableNavigation(with: session)
+        if enabled {
+            mapView.cameraMode = .following
+        }
     }
 
     @objc private func closeTapped() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-google-navigation",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Google maps turn by turn navigation for capcitor",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",