Troubleshoot

  • This documentation addresses common issues encountered when setting up map styles within Google Cloud Platform and provides troubleshooting steps.

  • Users might experience issues with legacy cloud styling access, style updates not propagating, preview map display errors, blurry text, and incorrect feature styling.

  • Solutions include checking style overlaps, inheritance overrides, zoom levels, color contrast, and feature visibility settings.

  • The document links to relevant resources such as release notes, WebGL support, and specific troubleshooting guides for managing style overlaps and understanding style hierarchy.

  • Users can report bugs and feature requests through provided links to Google's issue tracker.

This document describes common issues that might occur when setting up yourmap style, and how to resolve them.

Click to file aBugorFeature Request.

Known issues

To see the latest known issues with cloud-based maps styling, seetherelease notes.

Messages

Here are some messages you might see and their solutions:

A mapstyles property cannot be set when amapId is present.
You cannot use map IDs and styles at the same time. Instead, edit the styleassociated with the map ID using the Cloud console. See alsoI get an error trying to load my map style.

The style editor can't be loaded right now

The preview map uses a vector map. In cases when vector maps cannotbe loaded on your web browser, it falls back to a "no map" experience:

An example of the message that says The style editor can't be loaded right now along with several steps on how to troubleshoot the error.

If you run into this issue, try the following:

  • Check your browser settings to make sure hardware acceleration is enabled.
  • Check if your device is supported by visitingget.webgl.org. If the demo does not run, your browser or device may not be compatible with WebGL. Make sure your device's drivers/browser combination is not subject to the denylist rules defined in theKhronos WebGL wiki.
  • Update your graphics card and make sure that your device has a video graphics card (GPU) that supports WebGL. SeeApplication and website requirements.

For additional support, seeGMP WebGL support.

Style issues

You might see the following messages displayed after creating or updatinga style.

My style changes aren't updating in my apps or website

Style changes can take a few hours to propagate to your apps and websites, andapps can take longer if the devices aren't connected to the internet. If you'restill not seeing your style changes after a few hours, check the followingthings:

  • Make sure you've published your style update.

  • If you made your changes in a duplicated style, make sure you've associatedyour map ID with the duplicated style. For details, seeAssociate or remove map IDs on your style.

I can't see my style changes on the preview map

If you make a change, and can't see the change on the preview map, hereare some things to try.

  • Check for style overlaps: For details, seeManage styles that overlap.

  • Check for style inheritance overrides: Check to see if there is acustom child style underneath the style you're setting that is overridingits parent style. For details on style inheritance, seeUnderstand map style inheritance and hierarchy.

  • Change the map zoom level: It's possible that the map features you arestyling are not visible in the map at the current zoom level.

    • Zoom in: If you are sure the feature is present on the map,zoom in to a more detailed view and it may appear.

    • Zoom out: With some large map features, you may need to zoom outuntil the detailed map features drop out before your styling shows up.

My text looks blurry or out of focus

If the colors you've chosen for your fill and stroke for text don't haveenough contrast, the font looks bold and fuzzy because the stroke (outline)and fill merge together. Select colors that have enough contrast.

My style looks dull or the wrong color

The map feature you are styling may overlap with one or more other mapfeatures. For assistance, seeManage styles that overlap.

The wrong map features are being styled

If you are seeing map features that match the style you've set, it may be thatthe default map style for those map features are the same as the style you'resetting. Here are some things to try:

  • Turn off visibility for the map feature that matches. For example,if you are trying to set Winery to a dark red, and notice that EmergencyPOIs are red, which could be confusing for your users. You can choose toturn off visibility for Emergency POIs to avoid this confusion.

  • Change the style of the map features that you don't want to match.the example above, you could also choose to style Emergency POIs to orangeto avoid confusion.

I get an error trying to load my map style

You cannot use map IDs and styles at the same time. You can do one of thefollowing:

  • Recommended: Remove the map style, and edit the style associated withthe map ID using the Cloud console. With this method, you can create onestyle that applies to all platforms. For details, seeAssociate a style with a map ID.

  • Remove the map ID, and edit the style for each app platform usingJSON styling.Since JSON styling is platform-specific, you need to create the style for eachapp platform on which you display the styled maps.

If you already have a JSON map style that you want to use for cloud-basedmaps styling, you can import it. For details, seeImport a JSON map style.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.