本頁面由 Cloud Translation API 翻譯而成。

使用地圖 ID

地圖 ID 是指與特定地圖樣式或地圖項目相關聯的 ID。您可以先設定地圖樣式，並將地圖樣式與 Google Cloud 控制台中的地圖 ID 建立關聯。這樣一來，當您在程式碼中參照該地圖 ID 時，相關的地圖樣式就會顯示在應用程式中。後續的任何樣式更新也會自動顯示在應用程式中，客戶不需要進行任何更新。

建立完成之後，地圖 ID 會與專案建立關聯，也只能用於單一平台 (Android、iOS、JavaScript) 或 Maps Static API。

如要在 Cloud 控制台中建立或管理任何地圖 ID，您必須具備專案擁有者或專案編輯者身分與存取權管理角色。

所需權限

如要在特定 Google Cloud 專案中建立或管理任何地圖 ID 或地圖樣式，您必須具備專案的「擁有者」或「編輯者」IAM 角色。

建立地圖 ID

「地圖 ID」是一組不重複識別碼，每組代表一個 Google 地圖例項。您可隨時在 Cloud 控制台中建立地圖 ID，並更新與地圖 ID 相關聯的樣式。

如要建立地圖 ID，請按照下列步驟操作：

前往 Cloud Console 中的「地圖管理」頁面。
按一下 [建立新地圖 ID]，系統即會顯示「建立新地圖 ID」表單。

在表單中執行以下操作：
- 為地圖命名。
- 指定地圖類型或平台。
- 如果是 JavaScript 地圖，請選擇光柵或向量地圖類型。
- 輸入地圖說明。
- 選取「Next」(下一步)，系統即會顯示新的地圖 ID。

將地圖 ID 與地圖樣式建立關聯

這些操作說明假設您的專案中目前至少有一個地圖樣式。

前往 Cloud Console 中的「地圖管理」頁面。
在這個頁面的「地圖名稱」欄中選取現有的地圖 ID。
在這個表單的底部，從 [與這組地圖 ID 相關聯的地圖樣式] 下拉式選單中選擇地圖樣式。
選取「儲存」。

在應用程式中加入地圖 ID

Android

您可以使用 MapView 類別 (或藉由程式輔助方式使用 GoogleMapOptions 類別)，透過活動版面配置檔案中的 <fragment> 元素新增地圖 ID。

舉例來說，假設您建立了名為 map_id 的地圖 ID，並以字串值形式儲存於 res/values/strings.xml 中：

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

如果是透過活動版面配置檔案中的 <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 類別將 ID 傳送至 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 的地圖。

iOS

如要使用地圖 ID 將地圖例項化，請執行下列操作：

透過 Cloud 控制台建立包含地圖 ID 字串的 GMSMapID。
建立 GMSMapView，指定您剛才建立的地圖 ID。

Swift

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

Objective-C

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，可以隨時在 Cloud 控制台設定地圖 ID，將樣式更新為新樣式，且地圖檢視會在大約六小時內自動反映在地圖檢視中。

如果您想立即查看變更，可以關閉應用程式，然後從最近使用的應用程式清單中強制結束應用程式，再重新開啟應用程式。更新後的地圖隨即會顯示。

JavaScript

如要在應用程式程式碼中建立含有地圖 ID 的地圖，請按照下列步驟操作：

如果您目前使用嵌入式 JSON 程式碼自訂地圖，請從 MapOptions 物件中移除 styles 屬性；否則請略過這個步驟。
使用 mapId 屬性在地圖中加入地圖 ID。例如：

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

靜態地圖介面集

如要在使用任一網路服務 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" />

地圖以美國紐約州紐約市布魯克林大橋為中心，並在右下角顯示地圖控制項。地圖會在道路、水域和陸地上顯示自訂樣式。

如果在新增地圖 ID 之前，Maps Static 網址中有數位簽章，則您必須在新增地圖 ID 後建立及新增數位簽章。產生新的網址簽署密鑰時，請務必從網址中移除先前的數位簽章。

使用地圖 ID 時可用的功能

雲端式地圖樣式設定：使用 Google Cloud 控制台設定地圖樣式，以及自訂和管理地圖。
適用於所有平台 (Android、JavaScript、iOS 和 Maps Static API)

向量地圖：由向量圖塊組成的地圖，會在載入時使用 WebGL 在用戶端繪製。
適用於 JavaScript