DEPRECATED: Legacy cloud styling is deprecated and is slated for retirement in March 2025. At that point, your legacy map styles may no longer work. Google recommends you update to the new cloud-based maps styling before March 2025. For more information about the deprecation, see Deprecations. To update your legacy styles, see Update a map style to the latest version.

Legacy set up and billing

Before you begin

Create a map ID: To use cloud-based maps styling, your map must be loaded using a map ID.
Update from hard-coded styling: Before adding a map ID to use cloud-based maps styling on an existing map that is customized with hard-coded styling, such as JSON or URL query parameters, remove the hard-coded styling to avoid a potential conflict with future features. You can import your JSON styling into a new map style.
- On Android, update MapStyleOptions
- On iOS, update the GMSMapStyle class
- On JavaScript, remove the MapTypeStyle styling
- On Maps Static, remove the style parameter

* Upgrade the Maps SDK for Android: To use cloud-based maps styling, you must be using 18.0.0 or later of the Maps SDK for Android and use the latest Maps SDK for Android renderer.

Billing

Using cloud-based maps styling requires a map ID. On Maps SDK for Android, Maps SDK for iOS, and JavaScript, using a map ID incurs a charge against the Dynamic Maps SKU. On the Maps Static API, using a map ID incurs a charge against the Static Maps SKU.