如何创建地图 ID

请选择平台： Android Android 3D iOS iOS 3D JavaScript Web 服务

地图 ID 是表示存储在 Google Cloud 中的 Google 地图样式和配置设置的唯一标识符。您可以使用地图 ID 在网站和应用中启用功能或管理地图，也可以设置地图样式。您可以在 Google Cloud 控制台项目的地图管理 页面中，为所需的每个平台（JavaScript、Android、iOS 或静态地图）创建地图 ID。

如需了解详情以及使用地图 ID 的功能， 请参阅地图 ID 概览。

所需权限

如需在项目中创建或管理任何地图 ID，您必须使用在 Cloud 控制台 IAM 页面上对项目具有相应角色级权限（编辑者或所有者）的主账号。如需了解 详情，请参阅 IAM 基本角色和预定义角色参考文档。

创建地图 ID

按照以下步骤在 Cloud 控制台中创建地图 ID：

  1. 登录并打开具有 所需权限的 Cloud 控制台项目。

  2. 在 Cloud 控制台中，转到 “地图管理”页面。

  3. 点击创建地图 ID 。

    创建新的地图 ID

  4. 在创建新的地图 ID 页面上，执行以下操作：

    1. 在名称部分，为地图 ID 命名。
    2. 可选：在说明部分，描述地图 ID 的用途。
    3. 在地图类型部分，选择您计划使用地图 ID 的平台。 如果您选择 JavaScript，还需选择光栅 （默认）或矢量 地图类型。如需详细了解矢量地图，请参阅 矢量地图。
    4. 点击保存 ，系统会显示新的地图 ID。

将地图 ID 与地图样式相关联

如果您使用的是云端地图样式设置，则需要将地图样式与地图 ID 相关联。如需了解详情，请参阅将样式与地图 ID 相关联。

为您的应用添加地图 ID

Android

您可以使用 MapView 类（或以编程方式使用 GoogleMapOptions 类），通过 activity's 布局文件中的 <fragment> 元素添加地图 ID。

例如，假设您创建了地图 ID，它作为一个名为 map_id 的字符串值存储在 res/values/strings.xml 中：

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>

对于通过 activity 布局文件中的 <fragment> 元素添加的地图， 所有应具有自定义样式的地图 fragment 都必须在 map:mapId 属性中指定 地图 ID：

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    map:name="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

您还可以使用 MapView 类的 map:mapId 属性来指定地图 ID：

<com.google.android.gms.maps.MapView
    xmlns:map="http://schemas.android.com/apk/res-auto"
    ....
    map:mapId="@string/map_id" />

如需以编程方式指定地图 ID，请使用 GoogleMapOptions 类将其传递给 MapFragment 实例：

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

在 Android Studio 中，像往常一样构建并运行应用。在第一步中配置的自定义样式会应用于具有指定地图 ID 的所有地图。

Android 3D

以编程方式或使用布局属性将 mapId 字符串属性设置为 Map3DOptions。系统会在实例化期间将 Map3DOptions 提供给 Map3DView 对象，并且在构建 Map3DView 后无法更改。

开发者可以选择实现新的 OnMapIdErrorListener，以便在地图 ID 无效或未找到时收到通知并做出响应。

添加地图 ID，以编程方式创建地图，并设置 OnMapIdErrorListener：

import com.google.android.gms.maps3d.GoogleMap3D
import com.google.android.gms.maps3d.Map3DOptions
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.OnMap3DViewReadyCallback
import com.google.android.gms.maps3d.model.Map3DMode

class MainActivity : Activity(), OnMap3DViewReadyCallback, OnMapIdError {
  fun onCreate(...) {
    val map3DOptions = Map3DOptions(mapMode = Map3DMode.HYBRID, mapId = "MAP_ID")
    val map3DView = Map3DView(context, map3DOptions)
    map3DView.getMap3dViewAsync(this)
  }

  override fun onMap3DViewReady(googleMap3D: GoogleMap3D) {
    googleMap3D.setMapIdErrorListener(
      object : OnMapIdErrorListener {
        override fun onMapIdError() {
          // Handle error event.
        }
      }
    )
  }
}

使用布局属性添加地图 ID：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:map3d="http://schemas.android.com/apk/res-auto"
   android:layout_width="match_parent" android:layout_height="match_parent">
 <com.google.android.gms.maps3d.Map3DView
     android:id="@+id/map3dView"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent"
     map3d:mode="hybrid"
     map3d:mapId="MAP_ID"/>
</LinearLayout>

iOS

如需使用地图 ID 实例化地图，请执行以下操作：

  1. 使用 Cloud 控制台中的地图 ID 字符串创建 GMSMapID。
  2. 创建 GMSMapView，并指定您刚刚创建的地图 ID。

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

如果您使用的是自己的地图 ID，则可以随时在 Cloud 控制台中设置地图 ID 以使用新样式，并且该样式会在大约 6 小时内自动反映在您和用户的地图视图中。

如果您想立即查看更改，可以关闭并重启应用：退出应用，从最近使用的应用列表中强制关闭应用，然后重新打开应用。随后，您将看到更新后的地图。

iOS 3D

iOS 开发者可以在 Map 上设置新的 style 修饰符。此修饰符接受地图 ID，并且可以选择接受在地图 ID 无效或未找到时调用的闭包。

import SwiftUI
import GoogleMaps3D

struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }
  var body: some View {
    Map(initialCamera: .init(
        latitude: 0.0,
        longitude: 0.0,
      ),
      mode: .hybrid
    )
    .style(
      with: "MAP_ID",
      error: {
        // Handle styling error.
      }
    )
    // Could also use trailing closure syntax
    //  .style(with: "MAP_ID") {
    //     // Handle styling error.
    //  }
  }
}

JavaScript

如需在应用代码中使用地图 ID 创建地图，请执行以下操作：

  1. 如果您已使用嵌入式 JSON 代码自定义地图，请移除 the styles property from your MapOptions object；否则，请跳过此步骤。

  2. 使用 mapId 属性将地图 ID 添加到地图。例如：

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

JavaScript 3D

如需在应用中使用地图 ID 创建地图，请使用 mapId 属性将地图 ID 添加到地图。例如：

async function init() {
    const { Map3DElement } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
        center: {
            lat: 37.75183154601466,
            lng: -119.52369070507672,
            altitude: 2200,
        },
        tilt: 67.5,
        heading: 108.94057782079429,
        range: 6605.57279990986,
        mapId: 'bcce776b92de1336e22c569f', // Styles are associated with map IDs.
        mode: 'HYBRID',
    });

    document.body.append(map);
}

void init();

静态地图

如需将地图 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=MAP_ID&signature=YOUR_SIGNATURE" />

一张以美国纽约州纽约市的布鲁克林大桥为中心的地图，地图控件位于右下角。地图显示了道路、水域和陆地的自定义样式。

如果您在添加地图 ID 之前在 Maps Static 网址中添加了数字签名， 则需要在添加地图 ID 后创建 并添加新的数字签名。 生成新的网址签名密钥时，请务必从网址中移除之前的数字签名。