Create and use map styles

Select platform: Android iOS JavaScript Web Service

A map style is a set of visual customizations to map features that you associate with a map ID. You then reference the map ID in your application code to display the customized map.

You can create a map style before you have a map ID; however, to use the style, you must associate the style with a map ID. To use a map style, you must take all of these steps:

  1. Create and publish a map Style.For details, see Create a styleandPublish a style.

  2. Create a map ID.For details, see Create a map ID.

  3. Associate the map style with a map ID.For details, see Associate a map ID to a map style.

  4. Add the map ID to your appto display your style. For details, see Add the map ID to your map.

Create a map style

Create a map style using one of these methods:

  • Createa new style using the default Google map style.

  • Duplicateand modify an existing standard or customized style.

Create a new style

  1. In the Google Cloud Console, go to Map Styles,and select a project, if needed.

  2. InMap Styles,selectCreate Style.

  3. At the bottom, selectOpen in Style Editor.

  4. Select map features and change their style to create the map style you want. Map features with custom styles have a solid blue dot next to them.

  5. SelectSave.

  6. In theSave and publish map stylebox, enter a name for your style and optionally a description, and selectSave.

The style is automatically published, and you see your new style's main page.

Duplicate a style

  1. Go to Map Styles,and select a project, if needed.

  2. Select one of your existing styles.

  3. On the style page, selectDuplicate.

  4. In theDuplicate Map Stylebox, enter a new map name and optionally a description.

  5. SelectSave.

    The style is automatically published, and you can see your new style's main page. Associate it with a map ID to use it for your maps. For details, see Associate a map ID to a map style.

  6. If you want to modify the style, selectCustomize style,make changes, and selectSave.

Publish a style

When you first create a new map style, which includes duplicating an existing style or importing a JSON style, that first instance of the new map style is automatically published. After that, you can save changes as a draft and then publish when you're happy with the changes.

  1. Make the changes to the map style or duplicated map style you want to publish. For details, seeChange a style.

  2. While you're still making changes, selectSave.

  3. When you're ready to publish and have your changes go live for any map IDs using that map style, selectSave,and then selectPublish.

Published versus Draft map styles

Published:A published map style is live. Any maps that use the map style display the published version of it.

Draft:Draft versions of a map style are works in progress and aren't displayed in maps until you publish them.

Change a style

If you want to make changes to your map style, you can make the changes right in the style editor. You have a couple of choices when you update a style:

  • If you want changes to go live as soon as you're ready:Select Customize styleand make your changes. SelectSaveto save your changes as a draft, and then selectPublishwhen you are ready.

  • If you want to test your changes in a test environment first:Instead of making changes directly in the map style, duplicate the style first. For details, seeDuplicate a styleand Test map style updates.

Once you've created a map style, you can make changes to it on the style's main page in any of the following ways:

  • Edit:SelectCustomize style.

  • Duplicate:For details, see Duplicate a style.

  • Rename:Rename the map style.

  • Delete:Delete the map style.

  • Add map IDs:Associate map IDs with the style

Associate or remove map IDs on your style

You can associate styles with multiple map IDs, since the same style can be applied across multiple Google Maps apps. However, you can associate a map ID with only one style.

  1. Go toMap Stylesand select a style.

  2. Select eitherAdd Map IDsorEdit Map IDs.

  3. InEdit Map IDs,check the box next to map IDs to associate them with this style. To remove a map ID, clear the box to remove the association.

  4. SelectSave.

To use your cloud-based map style, add the map ID to your app.

You navigate on the preview map in the same way you navigate on any Google map:

  • Enter an address or location in theSearch Addressbox.

  • Click the compass to center on your location. You may also have to grant location permissions.

  • Drag to move the map.

  • Zoom in or out using the plus (+) and minus (-).

Find map features

To find a map feature that you want to style, underMap Features,enter a term in theFilterbox.

You can also expand and collapse map feature categories to find the map feature you want.

If you can't find a map feature:

  • Don't use plurals. All of the categories are singular.

  • Try using a more generic term for the feature. For example, instead of "pizza parlor" or "fast food," search for "restaurant."

  • Try using a broader category, and then explore that category for the closest map feature. For example, instead of "theater," search for "entertainment."

  • Browse the list of map features at What you can style on a map.