Cloud customization

To use Cloud-based maps styling on Android, you must opt in to the new renderer. Follow these instructions.

Paid feature: Functionality accessed by adding a map ID triggers a map load charged against the Dynamic Maps SKU for Android and iOS. See Google Maps Billing for more information.

Select platform: Android iOS JavaScript

Google Maps Platform offers Cloud-based maps styling features that make it easy to style, customize, and manage your maps using the Google Cloud Console, letting you improve the overall user experience of your maps. To make these features easy to adopt and manage, Cloud-based maps styling brings a number of new tools to the Cloud Console:

• A style editor for easy style creation.
• Map ID creation and management.
• Custom map style creation and management.
• Tools for dynamic updating of styles.

Add a map ID to your app

A map ID is an identifier that's associated with a specific map style or feature. Configure a map style and associate it with a map ID in the Google Cloud Console. Then, when you reference a map ID in your code, its associated map style is displayed in your app. Any subsequent style updates you make appear in your app automatically, without the need for any updates by your customers.

Add your map ID through a <fragment> element in the activity’s layout file, by using the MapView class, or programmatically using the GoogleMapOptions class.

For example, assume you created a map ID that is stored as a string value named map_id in res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

For maps added through a <fragment> element in the activity’s layout file, all map fragments that should have the custom style must specify the map ID in the map:mapId attribute:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

You can also use the map:mapId attribute of the MapView class to specify a map ID:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

To specify a map ID programmatically, pass it to a SupportMapFragment instance using the GoogleMapOptions class:

Java

GoogleMapOptions options = new GoogleMapOptions()
    .mapId("YOUR_MAP_ID");
SupportMapFragment mapFragment = SupportMapFragment.newInstance(options);

      

Kotlin

val options = GoogleMapOptions()
  .mapId("YOUR_MAP_ID")
val mapFragment = SupportMapFragment.newInstance(options)

      

Or alternatively, pass it to a MapView instance:

Java

GoogleMapOptions options = new GoogleMapOptions()
    .mapId("YOUR_MAP_ID");
MapView mapView = new MapView(context, options);

      

Kotlin

val options = GoogleMapOptions()
    .mapId("YOUR_MAP_ID")
val mapView = MapView(context, options)

      

In Android Studio, build and run your app as you normally would. Custom styles will be applied to all maps with an ID.

Using the maps style editor

The Maps Style editor is a GUI-based tool available in the Google Cloud Console.

Learn to use the Cloud-based map styling tool