云端地图样式设置

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Google Maps Platform 提供云端地图样式设置功能,可让您轻松地使用 Google Cloud 控制台设置地图样式、自定义和管理地图,从而为用户提供自定义地图体验,并且无需在每次更改样式时更新应用的代码。

2020 年 9 月 15 日之前创建的样式不会显示 Google 地图增强后的自然地貌。若要在地图样式中使用 Google 地图增强后的自然地貌,您必须创建地图样式

借助云端地图样式设置,您可以为使用 Google 地图的所有应用创建和修改地图样式,并且无需对代码进行任何更改,只要您拥有地图 ID 便可使用其关联的地图样式。所有样式更改都可以在 Cloud 控制台中完成,您无需具备任何编码技能。您可以更改众多地图元素(例如道路、建筑物、水体、地图注点和公共交通路线)的外观和颜色。

这些功能包括:

  • 云端地图样式设置:您可以在 Cloud 控制台中使用地图 ID 和地图样式来管理动态或静态地图,并为其设置样式,而不需要在代码中使用 JSON 设置地图样式。
  • 矢量地图:JavaScript 开发者可以选择在自己的 Web 应用中直接使用 maps.google.com 上提供的同一 WebGL 加速矢量地图。
  • 商家地图注点过滤:可以根据需要移除五种商家地图注点,不让它们显示在地图上。
  • 地图注点密度控制:可以调整地图注点在基本地图上的显示密度,以增加或减少默认显示的地图注点。

虽然云端地图样式设置适用于 Maps SDK for Android1Maps SDK for iOSJavaScriptMaps Static API,但部分功能不会在所有平台上显示。

准备工作

* 升级 Maps SDK for Android
如需使用云端地图样式设置功能,您必须使用 18.0.0 或更高版本的 Maps SDK for Android,并使用最新的 Maps SDK for Android 渲染程序

结算

如需使用云端地图样式设置,您需要拥有地图 ID。在 Maps SDK for Android、Maps SDK for iOS 和 JavaScript 上,使用地图 ID 会产生动态地图 SKU 费用。在 Maps Static API 中,使用地图 ID 会产生静态地图 SKU 费用。

示例

Android

运行 ApiDemos 示例应用

如需运行 ApiDemos 示例应用,请参阅 GitHub 示例 (Java | Kotlin) 并查看 CloudBasedMapStylingDemoActivity 演示 (Java | Kotlin)。

您可以查找 JavaKotlin 示例应用,了解如何通过云端设置 Android 地图的样式。

已知问题

将应用交付给客户后,可以通过 Google Cloud 控制台更新具有地图 ID 的地图的自定义样式。新样式将在几小时内显示在您的应用中。

为了确保新的自定义样式能够立即显示以进行测试,请清除测试设备中的应用数据。如需详细了解如何清除设备中的数据,请参阅 Android 帮助文章 - 释放存储空间

请注意,设置方法可能因手机而异。如需了解详情,请与您的设备制造商联系

iOS

运行 ApiDemos 示例应用

如需运行 ApiDemos 示例应用,请参阅 GitHub 示例应用 GoogleMap 示例应用并查看 CloudBasedMapStylingViewController 项目(GitHub 示例:Swift | Objective-C)。

可选的 Cloud 样式设置 CocoaPod 或 GitHub 演示

除了从头开始,您还可以试用我们的 Objective-C 示例应用,该应用演示了如何从云端设置 iOS 地图的样式。

构建 Beta 版演示应用

在 Xcode 中,按编译按钮进行构建,然后运行当前架构。 构建会产生错误,提示您在 SDKDemoAPIKey.h 文件中输入 API 密钥。

如果您还没有 API 密钥,请按照这些说明在 Cloud Console 上设置项目并获取 API 密钥。在 Cloud Console 上配置密钥时,您可以指定应用的软件包标识符,以确保只有您的应用可以使用该密钥。SDK 示例应用的默认软件包标识符为 com.example.GoogleMapsDemos

修改 SDKDemoAPIKey.h 文件,并将您的 API 密钥粘贴到 kAPIKey 常量的定义中:

```
static NSString *const kAPIKey = @"YOUR_API_KEY";
```

如果 Xcode 提示您解锁 SDKDemoAPIKey.h 文件进行修改,请选择 Unlock(解锁)。

移除以下代码行:

```
#error Register for API Key and insert here.
```

构建并运行项目。

云端地图样式设置地图演示

CloudStyling 演示展示了如何使用在 Google Cloud Console 中设置的样式来设置地图样式。

演示应用启动时,点击列表顶部的“Beta 版示例”部分中的地图自定义演示。

点击样式地图,查看加载不同地图 ID 的效果。

您也可以尝试添加自己的样式(“样式地图”>“添加新的地图 ID”),然后使用自定义样式的地图查看地图更新。

JavaScript

这是一个使用地图 ID 加载自定义样式地图的基本示例。在本例中,Maps JavaScript 会在地图加载时引用地图 ID 8e0a97af9386fef,并自动应用当前与该地图 ID 相关联的地图样式。

TypeScript

function initMap(): void {
  new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      mapId: "8e0a97af9386fef",
      center: { lat: 48.85, lng: 2.35 },
      zoom: 12,
    } as google.maps.MapOptions
  );
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;

JavaScript

function initMap() {
  new google.maps.Map(document.getElementById("map"), {
    mapId: "8e0a97af9386fef",
    center: { lat: 48.85, lng: 2.35 },
    zoom: 12,
  });
}

window.initMap = initMap;
查看示例

试用示例

Maps Static API

地图 ID 是与特定地图样式或地图项相关联的标识符。在 Google Cloud Console 中配置地图样式,并将其与地图 ID 相关联。然后,当您在代码中引用地图 ID 时,相关联的地图样式便会显示在您的应用中。您后续进行的任何样式更新都会自动显示在您的应用中,无需客户进行任何更新。

  1. 如果您对基于 style 参数自定义的现有地图使用云端地图样式设置,请务必将其移除,以免与未来功能发生冲突。

  2. 如需将地图 ID 添加到使用我们的某个 Web API 的新地图或现有地图,请附加 map_id 网址参数并将其设置为您的地图 ID。此示例展示了如何使用 Maps Static API 将地图 ID 添加到地图中。

    <img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />
    


  1. Android 精简模式不支持云端地图样式设置。