使用地图 ID

Android

通过 activity 的 <fragment> 元素添加地图 ID 使用 MapView 类创建布局文件，或以编程方式使用 GoogleMapOptions 类。

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

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

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

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

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

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

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

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

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

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

iOS

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

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

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

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

如果您使用的是自己的地图 ID，则可以设置地图 ID 以便随时采用新样式 该样式将自动体现在地图视图中 在大约 6 个小时内向用户发出通知。

如果您想立即查看更改，可以关闭应用并重新启动它，具体方法是退出应用，从最近用过的应用列表中强制退出应用，然后重新打开它。更新后的地图即会显示出来。

JavaScript

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

1. 如果您当前正在使用嵌入的 JSON 代码自定义地图，请删除 styles 属性 （来自 MapOptions 对象）；否则，请跳过此步骤。

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

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

静态地图

如需向使用某个 Web 服务 API 的新地图或现有地图添加地图 ID，请附加 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" />