ionic-team / ionic-team/capacitor-google-maps

[Bug]: Android Google Maps renders completely blank with @capacitor/google-maps@8.0.1

Open
#177 1 comment 0 reactions 0 assignees View on GitHub
needs reproduction
Dominant language
TypeScript
Stars
32
Forks
47
PR merge metrics
No merged PRs in 30d

Description

Bug Report

Plugin(s)

@capacitor/google-maps@8.0.1

Capacitor Version

Please see the npx cap doctor output below.

PASTE OUTPUT FROM `npx cap doctor` HERE

Platform(s)

* Android
* Physical Samsung device
* Android Emulator — Google Pixel 7, official Google Play image

Current Behavior

The Google Maps native map is created successfully, but nothing is rendered visually.

The issue has been reproduced consistently in two completely different Android environments:

1. A physical Samsung device running One UI.
2. A completely clean Google Pixel 7 Android emulator using an official Google Play system image.

In both environments:

* GoogleMap.create() completes successfully.
* The application logs confirm that the map is created successfully.
* The map receives touch/gesture interactions.
* The Google Maps native component appears to initialize normally.
* However, the map remains completely blank.
* No map tiles are visible.
* No Google logo is visible, including the mandatory Google Maps attribution/logo.
* There is no visible map rendering even though the native map instance has been successfully created.

This is therefore not limited to a specific physical device or manufacturer.

Expected Behavior

After successfully creating the Google Maps native map, the map should render normally with:

* Google Maps tiles
* The map content
* Google Maps attribution/logo
* Normal interaction and gestures

Code Reproduction

A minimal reproduction project is being prepared to isolate the issue from the Roulage application.

The reproduction uses:

* Capacitor 8
* @capacitor/google-maps@8.0.1
* Android
* A minimal map element
* A valid Google Maps API key
* A simple map configuration
* A visible test background around the map

The same blank-rendering behavior can be reproduced independently of the Roulage application’s business logic.

Other Technical Details

The Google Maps API key and Android configuration have been verified.

The following have been checked and ruled out:

* Incorrect API key configuration
* Incorrect AndroidManifest configuration
* Incorrect manifestPlaceholders configuration
* Google Maps API key restrictions
* Missing map creation
* Map element dimensions
* CSS transparency issues
* Android theme configuration
* Pull-to-refresh interference
* A Samsung-specific rendering problem
* A problem specific to the Roulage application

The Android Google Maps configuration follows the plugin documentation, including the required API key configuration.

The problem was also reproduced on a clean Google Pixel 7 emulator with an official Google Play image, which strongly suggests that this is not caused by the device manufacturer or existing application state.

The map creation succeeds, but the native Google Maps rendering surface remains visually empty.

Additional Context

The behavior appears similar to a rendering/compositing regression rather than a map initialization or API-key failure.

The official plugin documentation notes that Android renders the map beneath the WebView and requires transparency through the WebView layers. Those transparency requirements were explicitly tested and corrected, but the map remained completely blank.

The fact that the issue reproduces on both a physical Samsung device and a clean Pixel 7 Google Play emulator makes an application-specific rendering problem less likely.

The issue may be related to compatibility between @capacitor/google-maps@8.0.1, Capacitor 8, and the current Google Maps Android/Google Play Services rendering implementation.

I would appreciate guidance on whether this is a known Android rendering regression and whether a specific Google Maps/Play Services version or plugin version is recommended.

As an additional diagnostic step, I am also testing the previous @capacitor/google-maps 7.x release to determine whether the issue is specific to version 8.x.

Contributor guide

Open the contributing guide

Research direction

Start with the plugin documentation's Android transparency requirements and the minimal map reproduction described in the report. Compare the blank rendering on the Samsung device and Pixel 7 emulator, then test the previous @capacitor/google-maps 7.x release against 8.0.1. Done means identifying whether the regression is in the plugin, Capacitor 8, or Google Maps rendering compatibility and documenting a confirmed version or fix path.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, typescript
Domain
mobile-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.