Between May 2024 and March 18, 2025, Google Maps Platform will update the default map style for the following APIs and SDKs. To confirm compatibility with your maps experience, you can opt in to update to the new map style earlier, depending on the product you use. For more information, see the following sections.
For apps that use map IDs
Starting March 21, 2024, if your app uses map IDs, you can update to the latest version of cloud-based maps styling. With cloud-based maps styling, you can preview and opt in to the latest updated map styles with customization options to align with your specific requirements. For more information, see Update a map style to the latest version.
On March 18, 2025, the default map style will update to the latest version, with a new color palette, improved map experiences, and better usability. Your custom styles will sit on top of the default map style.
For apps that don't use map IDs
Google Maps Platform will release new versions for each of the APIs and SDKs with the updated default map style according to the schedule in the following table. If your app doesn't use map IDs, you can choose these new versions (or subsequent) in order to use the new default map style.
| Product | Update details | Date available |
|---|---|---|
| Maps JavaScript API | v3.58 Note: If you don't specify the version number or channel directly, this may impact your application at a later date. For more information, see Versioning in the Maps JavaScript API. Alternatively, you can opt in to the updated map style early. |
beta channel: March 2024
weekly channel: August 2024 quarterly channel: November 2024 |
| Maps SDK for Android | v19.0.0 For more information on updating versions, see Maps SDK for Android versions. |
June 2024 |
| Maps SDK for iOS | v9.0.0 For more information on updating versions, see Maps SDK for iOS versions. |
May 2024 |
| Navigation SDK for Android | v6.0.0 For more information on updating versions, see Add Navigation SDK to your project. |
September 2024 |
| Navigation SDK for iOS | v9.0.0 For more information on updating versions, see Install the Navigation SDK |
May 2024 |
| Maps Static API | The updated map style will be applied when available. | August 2024 |
| Maps Embed API | The updated map style will be applied when available. | August 2024 |
| Map Tiles API - 2D Roadmap | The updated map style will be applied when
available. To opt in earlier, see Map Tiles API - 2D Roadmap. |
March 2025 |
Opt in to the updated map style early
For most products, you can opt in to the updated map style by using cloud-based maps styling. For more information, see Application and Website Requirements. To learn more about cloud-based maps styling, see Cloud-based maps styling overview.
If your app doesn't use map IDs, some products have the option to opt in to the updated map style before March 2025.
Maps JavaScript API
Starting late March 2024, test your site with the new colors in the beta channel. For more information, see Choosing the beta channel.
Map Tiles API - 2D Roadmap
Starting April 2024, you can opt in by adding the following to your session token request:
{
// Sample session token request
"apiOptions": ["MCYJ5E517XR2JC"]
}
Alternatively, you can also add &apiOptions=MCYJ5E517XR2JC as a query
parameter.
Any 2D Tiles requests made with the returned session token will have the new style.
Opt out
For Maps JavaScript API, you can opt out by using v3.57, regardless of which channel you use.
For all other APIs, opt out by not adopting the latest version.
You will no longer be able to opt out after March 18, 2025. However, developers are welcome to create custom map styles reminiscent of the current default map styles.