設定地圖

本總覽說明如何設定已加進 iOS 應用程式的地圖 或是使用 Maps SDK for iOS

總覽

在應用程式中加入地圖後，您可以設定初始選項和執行階段 的地圖設定。如要進一步瞭解如何加入地圖容器，請參閱「新增 對應。

初始地圖設定包括下列項目：

• The camera position, including: location, zoom, bearing and tilt. 詳情請見 攝影機和檢視畫面：進一步瞭解攝影機位置。
• 地圖背景顏色。
• 地圖類型。
• 要顯示的 UI 元件，例如縮放按鈕和 指南針
• 要啟用的手勢。

在執行階段中，您可以選取 更新 GMSMapView敬上 物件。

地圖選項

初始化地圖檢視時，設定選項會設為 GMSMapViewOptions。選項屬性包括 frame、camera、mapID 或 backgroundColor。

設定地圖選項

您可以自行設定選項屬性，也可以將例項化的 將預設值 GMSMapViewOptions 直接設為 GMSMapView。

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

以下示範如何傳送含有預設值的 GMSMapViewOptions 物件 直接與 GMSMapView 分享。

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

設定背景顏色

使用深色模式或切換地圖檢視時，實用的 覆寫預設的地圖背景顏色。只需設定 地圖選項 backgroundColor 屬性。

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

地圖類型

你可以用幾種地圖類型中的一種自定義地圖。地圖的類型規範 地圖的整體表示法。舉例來說，圖集通常包含 著重於顯示界線的政治地圖，以及地圖顯示的道路地圖 城市或地區的所有道路Maps SDK for iOS 提供 下列地圖類型：

變更地圖類型

如要設定地圖類型，請將新的值指派給 GMSMapView.mapType 資源。例如，要顯示的衛星地圖類型：

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

下面的選擇器顯示地形、正常和混合地圖的地形比較： 相同位置：

室內地圖

高倍縮放時，Maps SDK for iOS 會顯示其樓層平面圖 機場、購物中心、大型零售商店和大眾運輸等室內空間 電台。室內平面圖已整合到 「正常」地圖類型 (kGMSTypeNormal)，且在 使用者放大，而縮小地圖時淡出。

只要設定 indoorEnabled 屬性，即可停用室內地圖 GMSMapView 到 NO。

mapView.isIndoorEnabled = false
      

mapView.indoorEnabled = NO;
      

或者，您也可以只停用 樓層挑選器控制項。

新增樓層平面圖

平面圖可於選取 地點。 如果樓層平面圖資料沒有您想要的建築物的資料 在應用程式中醒目顯示，你可以：

• 新增樓層數 方案 分享到 Google 地圖如此一來，下列專案的所有使用者都能夠使用： Google 地圖。
• 顯示一個平面圖作為地面覆蓋 。這只會啟用 您的平面圖。

路況圖層

您可以讓使用者查看疊加在地圖上的車流量資訊，清楚呈現當地的路況。您可以呼叫 這個 trafficEnabled敬上 方法。以下範例顯示路況圖層在地圖上的可能顯示方式。

無障礙設定

默認情況下，在地圖上可訪問的元素是隱藏的。你可以啟用 只要將 accessibilityElementsHidden 屬性設為 GMSMapView 到 NO。這會導致系統產生 疊加層物件 (例如 GMSMarker 和資訊視窗、GMSPolyline 等)。

mapView.accessibilityElementsHidden = false
      

mapView.accessibilityElementsHidden = NO;
      

這個屬性是採用正規的 UIAccessibility 通訊協定，除了 Maps SDK for iOS 的預設值為 YES。

我的位置

根據預設，地圖上不會顯示任何位置資料。您可以啟用藍色的「我的 位置」設定 myLocationEnabled，以顯示圓點和指南針方向 GMSMapView。

mapView.isMyLocationEnabled = true
      

mapView.myLocationEnabled = YES;
      

啟用此功能後，使用者即可透過 myLocation 屬性。這個房源可能無法立即存取 - 適用 例如，如果 iOS 提示使用者允許存取這類資料。是 在本例中nil。

print("User's location: \(String(describing: mapView.myLocation))")
      

NSLog(@"User's location: %@", mapView.myLocation);
      

3D 建築物

許多城市的地圖在近距離查看時，會顯示 3D 建築物 (僅供檢視) 如下圖所示

只需設定對應的 GMSMapView敬上 ，如下所示：

mapView.isBuildingsEnabled = false
      

[mapView setBuildingsEnabled:NO];
      

地圖邊框間距

Google 地圖的設計會填滿 GMSMapView 定義的整個區域。 地圖的部分顯示方式和行為是由尺寸所定義。 ：

• 攝影機的目標反映了設有邊框間距區域的中心。
• 地圖控制項是相對於地圖的邊緣。
• 著作權聲明或 Google 標誌等法律資訊，沿著地圖的底部邊緣顯示。

您可以使用 GMSMapView.padding 資源。地圖會繼續填入資料 整個容器，但文字和控制項位置、地圖手勢及相機 就會表現出 把它放在較小的空間裡。這會產生 下列變更：

• 使用 API 呼叫或按下按鈕 (例如「指南針」、「我的 位置) 是相對於填充區域。
• GMSMapView.projection 會傳回僅包含邊框間距的投影 區域。
• UI 控制項是由指定的 點數

設計與地圖中特定部分重疊的使用者介面時，邊框間距是頗為實用的功能。 例如，在圖片中，地圖的頂部邊緣和右邊緣都設有邊框間距。 可見地圖控制項和法律文字會顯示在邊框間距的邊緣 綠色顯示區域，則地圖繼續填滿整個容器。 以藍色顯示在這個範例中，您可以讓選單浮動在 沒有遮蓋地圖控制項的內容

如要在地圖中加入邊框間距，請建立 UIEdgeInsets 物件並傳遞至 GMSMapView。padding 屬性。

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

地圖色彩配置

如果是法線和地形類型的地圖，您可以將地圖的色彩配置設為深色。 燈光，或使用目前的系統設定。例如，您可以調暗或 根據時段或室內/室外使用時間，調亮地圖的色彩配置 完整連結

使用 GMSMapView overrideUserInterfaceStyle: 來設定並更新地圖的色彩配置。

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;