Places UI Kit: A ready-to-use library that provides room for customization and low-code development. Try it out, and share yourinput on your UI Kit experience.

Map color scheme

  • Roadmap and terrain map types allow customization of color schemes (light, dark, or system default) usinggoogle.maps.colorScheme.

  • ThecolorScheme option must be set during map initialization and cannot be changed afterward.

  • By default, maps use light mode; to change, importColorScheme and specify the desired scheme (LIGHT, DARK, or FOLLOW_SYSTEM) within map options.

  • Custom styles using Map IDs are only compatible with the light color scheme for roadmap map types.

For maps of typeroadmap andterrain, you can set the map color scheme(dark, light, or current system setting) by usinggoogle.maps.colorScheme. ThecolorScheme option can only be set when the map is initialized; setting thisoption after the map is created will have no effect.

Roadmap

The following image shows the light mode and dark mode color schemes for theroadmap type.

Two examples of the roadmap type map of Paris using the light mode and dark mode color schemes.

Terrain

The following image shows the light mode and dark mode color schemes for theterrain type.

Two examples of the terrain type map using the light mode and dark mode color schemes.

By default, the map uses light mode. When creating the map, importColorSchemeand specify the map color scheme (LIGHT,DARK, orFOLLOW_SYSTEM) inmap options, as shown here.

const{ColorScheme}=awaitgoogle.maps.importLibrary("core")constmapOptions={center:{lat:-34.397,lng:150.644},zoom:8,colorScheme:ColorScheme.DARK,}map=newgoogle.maps.Map(document.getElementById('map_canvas'),mapOptions);

If you reset the options after the map is instantiated,colorScheme has noeffect.

To create custom light styles and dark styles for your roadmap map types, usecloud-based maps styling.

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.