Google Maps Platform 的全新地图样式

西雅图的两幅地图,一幅是旧版地图样式,水域为深蓝色,道路为黄色;另一幅是更新后的地图样式,水域为青绿色,道路为灰色

从 2024 年 5 月到 2025 年 3 月 18 日,Google Maps Platform 将会针对以下 API 和 SDK 更新默认地图样式。您可以根据所使用的产品提前进行版本更新,看看新版地图样式是否与您的地图体验兼容。如需了解详情,请继续阅读下文。

对于使用地图 ID 的应用

如果您的应用使用地图 ID,那么从 2024 年 3 月 21 日开始,您便可以更新到云端地图样式设置的最新版本。借助云端地图样式设置,您可以预览并选择采用更新后的最新地图样式,并结合定制选项来满足您的特定需求。如需了解详情,请参阅将地图样式更新到最新版本

2025 年 3 月 18 日,默认地图样式将更新到最新版本,新版本采用新的调色板,并改进了地图体验和易用性。自定义样式的优先级将高于默认地图样式。

对于不使用地图 ID 的应用

Google Maps Platform 将按照下方的时间表发布每个 API 和 SDK 的新版本,其中将包含更新后的默认地图样式。如果您的应用不使用地图 ID,您可以选择这些新版本(或后续版本),以便使用新的默认地图样式。

产品 更新详细信息 发布日期
Maps JavaScript API v3.58

注意:如果您没有直接指定版本号或渠道,那么日后您的应用可能会受到影响。

如需了解详情,请参阅 Maps JavaScript API 中的版本控制。此外,您也可以提前采用更新后的地图样式
Beta 渠道:2024 年 3 月

每周渠道:2024 年 8 月

季度渠道:2024 年 11 月
Maps SDK for Android v19.0.0

如需详细了解如何更新版本,请参阅 Maps SDK for Android 版本
2024 年 6 月
Maps SDK for iOS v9.0.0

如需详细了解如何更新版本,请参阅 Maps SDK for iOS 版本
2024 年 5 月
Navigation SDK for Android v6.0.0

如需详细了解如何更新版本,请参阅将 Navigation SDK 添加到您的项目
2024 年 9 月
Navigation SDK for iOS v9.0.0

如需详细了解如何更新版本,请参阅安装 Navigation SDK
2024 年 5 月
Maps Static API 新版地图样式将在可用时自动生效。 2024 年 8 月
Maps Embed API 新版地图样式将在可用时自动生效。 2024 年 8 月
Map Tiles API - 2D 路线图 新版地图样式将在可用时自动生效。

如要提前采用,请参阅 Map Tiles API - 2D 路线图
2025 年 3 月

提前采用更新后的地图样式

对于大多数产品,您可以通过使用云端地图样式设置,选择采用更新后的地图样式。如需了解详情,请参阅应用和网站要求。如需详细了解云端地图样式设置,请参阅云端地图样式设置概览

如果您的应用不使用地图 ID,部分产品支持在 2025 年 3 月之前选择采用更新后的地图样式。

Maps JavaScript API

从 2024 年 3 月下旬开始,即可通过 Beta 渠道测试采用新颜色方案的网站。如需了解详情,请参阅选择 Beta 渠道

Map Tiles API - 2D 路线图

从 2024 年 4 月开始,您可以通过将以下内容添加到会话令牌请求来选择采用新样式:

{
// Sample session token request
"apiOptions": ["MCYJ5E517XR2JC"]
}

或者,您也可以添加 &apiOptions=MCYJ5E517XR2JC 来作为查询参数。

使用返回的会话令牌发出的所有 2D 图块请求都将具有新样式。

选择不采用

对于 Maps JavaScript API,无论您选择哪个渠道,使用 v3.57 即可不采用新样式。

对于所有其他 API,不使用最新版本即可。

在 2025 年 3 月 18 日之后,您将无法选择不采用。不过,开发者仍然可以创建与当前默认样式类似的自定义地图样式。