Troubleshoot

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

Click to file a Bug or Feature Request.

Access to legacy cloud styling

Legacy cloud styling is only available for some users. To have access to legacy cloud styling and have the Opt out button available, the following must be true:

  • Your project has already opted out of the new cloud styling.

  • Your project still has at least one legacy style.

Known Issues

  • Some points of interest ignore custom styling and visibility:

    Custom styling may not be applied to all POIs, in particular, some may still be visible even if you turn off Visibility. This is a known issue.

  • Text stroke sometimes doesn't work: Text stroke styling doesn't always work if it is not used in the base map. The known case is for Water.

  • Preview map sometimes doesn't load: The preview map for this release uses a vector map. In cases when vector maps cannot be loaded on your web browser, it falls back to a "no map" experience:

    If you run into this issue, try the following:

iOS Known Issues

  • The iOS client does not interpolate text stroke color for labels.

Messages

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

Further style changes may not display correctly across all browsers. We recommend that further style changes be avoided.

Map styles in the legacy version of cloud styling have a limit on the number of style changes that you can make. When you try to edit styles that have reached that limit, you get this message. You can select a different style to edit, or consider moving to the latest cloud styling, which has fixed this issue.

Style Issues

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

Map becomes blank when switching to Satellite view

Styling cannot be applied to satellite view. Only the roadmap type works with cloud-based map styles.

Some points of interest ignore custom styling and visibility at some zoom levels

If a point of interest is highlighted (bolded text) on the base map, custom styling does not work, and they are still visible even if you turn off Visibility. This issue only occurs at zoom levels where the point of interest is highlighted on the base map. This is a known issue.

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, and apps can take longer if the devices aren't connected to the internet. If you're still not seeing your style changes after a few hours, check the following things:

  • Make sure you've published your style update.

  • If you made your changes in a duplicated style, make sure you've associated your map ID with the duplicated style. For details, see Associate 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, here are some things to try.

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

  • Check for style inheritance overrides: Check to see if there is a custom child style underneath the style you're setting that is overriding its parent style. For details on style inheritance, see Understand map style inheritance and hierarchy.

  • Change the map zoom level: It's possible that the map features you are styling 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 out until 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 have enough 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 map features. For assistance, see Manage 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 that the default map style for those map features are the same as the style you're setting. 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 Emergency POIs are red, which could be confusing for your users. You can choose to turn 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 orange to avoid confusion.