相機和檢視畫面

您可以使用 Maps SDK for iOS，變更地圖的相機，變更使用者的地圖視角。

有了 Maps SDK for iOS，使用者就能傾斜和旋轉地圖，並將地圖調整成適合其使用的方向。在任何縮放等級下，使用者可以平移地圖或變更視角。

調整相機不會變更已加入的標記、折線或其他圖形，不過建議您配合新視角修改加入的項目，呈現精確的地圖。

地圖的視圖

Maps SDK for iOS 使用麥卡托投影代表裝置螢幕上的世界表面 (球體)。

相機位置

地圖檢視是模擬向下俯瞰平面的相機。相機的位置 (以及連帶的地圖算繪方式) 是由下列屬性來指定：目標 (經緯度位置)、方位、傾斜角度和縮放。

目標 (位置)

相機目標是地圖的中心位置，透過經緯度座標指定。

方位 (方向)

相機方位指的是指南針方向 (以度為單位，從正北算起，對應至地圖頂端邊緣)。如果您從地圖的中心點到頂端邊緣繪製一條垂直線，方位會對應到相對於正北的相機方向 (以度為單位)。

方位 0 表示地圖頂端指向正北。方位值 90 表示地圖頂端朝向正東 (在指南針上顯示為 90 度)，方位值 180 表示地圖頂端朝向正南。

Maps API 能讓您改變地圖的方位。舉例來說，汽車駕駛常常會翻轉道路地圖，使地圖與其行進方向一致；但同時使用地圖和指南針的健行者，則通常會讓地圖上的垂直線保持指向北方。

傾斜角度 (視角)

傾斜角度是指在地圖中心位置正上方的弧形上，以度為單位從天底 (相機正下方的方向) 測量至相機位置所得的值。值為 0 時，相機朝向正下方。值大於 0 時，相機依指定角度朝地平線傾斜。當您改變視角時，地圖會以視角呈現，較遠的地圖項目看起來較小，鄰近的地圖項目看起來則較大。請參閱下方範例的說明。

在下圖中，視角為 0 度。第一張圖是相關示意圖，1 是相機位置，2 則是目前地圖的位置。最終地圖則如下所示。

在下圖中，視角為 45 度。請注意，相機會在地圖正上方 (0 度) 和地面 (90 度) 之間的弧形上移動至中間，也就是 3 的位置。相機仍然會指向地圖的中心點，但位置 4 的線條代表的區域現在就會出現在地圖中。

在此螢幕截圖中，地圖的中心點仍與原始地圖相同，但地圖頂端顯示了更多地圖項目。若您將視角調整至 45 度以上，相機和地圖位置之間的地圖項目看起來會較大，而地圖位置以外的地圖項目則看起來較小，因而產生 3D 效果。

Zoom

地圖比例取決於相機的縮放等級。縮放等級較大時，螢幕上會顯示較多細節；縮放等級較小時，則能在螢幕上顯示較大的範圍。 縮放等級為 0 時，地圖比例是整個世界的寬度大約為 256 點。

將縮放等級提升 1，螢幕上的世界寬度就會加倍。因此，縮放等級若為 N，世界的寬度就大約是 256 * 2^N 點。舉例來說，縮放等級為 2 時，整個世界的寬度大約是 1024 點。

縮放等級不需要是整數。地圖允許的縮放等級範圍取決於許多因素，包括目標、地圖類型和螢幕大小。範圍外的任何數字都會轉換為下一個最接近的有效值，可能是最小或最大縮放等級。以下清單列出各縮放等級大致可顯示的精細程度：

• 1：全世界
• 5：自然景觀/大陸
• 10：城市
• 15：街道
• 20：建築

設定初始相機位置

使用 GMSCameraPosition 物件設定初始相機位置，即可設定目標的緯度和經度，以及方位、傾斜和縮放。

如要設定初始相機位置，請建立 GMSCameraPosition 物件，然後將該物件傳遞至 GMSMapView 便利建構函式。

let camera = GMSCameraPosition(
  latitude: -33.8683,
  longitude: 151.2086,
  zoom: 16
)
mapView = GMSMapView(frame: self.view.bounds, camera: camera)
      

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:16];
mapView = [GMSMapView mapWithFrame:self.view.bounds camera:camera];
      

您也可以使用預設的 UIView init 方法建立 GMSMapView 物件。在此情況下，相機位置會在預設位置開始，並在建立後加以變更。

mapView = GMSMapView(frame: self.view.bounds)
      

mapView = [[GMSMapView alloc] initWithFrame:self.view.bounds];
      

變更相機位置

您可以透過程式輔助方式來變更相機位置，藉此設定位置、方位、傾斜和縮放設定。雖然 GMSMapView 提供多種可用於變更相機位置的方法，但一般都會使用 GMSCameraPosition 或 GMSCameraUpdate：

• GMSCameraPosition 包含用於變更每個相機位置參數的屬性和方法：目標、方位、傾斜和縮放設定。

• GMSCameraUpdate 可讓您變更目標、方位、傾斜和縮放，同時提供其他便利方法，支援捲動、進階縮放、將相機置中在預先定義邊界等。

移動相機時，您可以選擇將相機「移動」至新的位置，也就是沒有動畫或動畫移動動作。舉例來說，如果您動畫對相機的目標位置變更，動畫就會從舊位置平移到新位置。

動畫會插入目前相機屬性和新相機屬性之間。您可以使用核心動畫控制動畫時間長度。

使用 GMSCameraPosition

如要使用 GMSCameraPosition 變更相機，您可以建立新物件或複製現有物件，然後在 GMSMapView 物件上設定該物件。使用 GMSCameraPosition 物件，讓相機貼有動畫或沒有動畫的新位置。

使用 GMSCameraPosition 物件來設定任何相機屬性，例如緯度、經度、縮放、方位和視角。然後，使用該物件來設定 GMSMapView 的 camera 屬性。

let fancy = GMSCameraPosition(
  latitude: -33,
  longitude: 151,
  zoom: 6,
  bearing: 270,
  viewingAngle: 45
)
mapView.camera = fancy
      

GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                       longitude:151.2086
                                                            zoom:6
                                                         bearing:30
                                                    viewingAngle:45];
[mapView setCamera:fancy];
      

省略要設為預設值的 GMSCameraPosition 屬性。

如要為動畫加上動畫效果，請使用 animateToCameraPosition: 方法，而非設定 camera 屬性。

使用 GMSCameraUpdate

GMSCameraUpdate 可讓您更新相機位置，並選擇是否對齊或建立動畫到該新位置。GMSCameraUpdate 的優勢很便利。您可以使用 GMSCameraPosition 執行與 GMSCameraUpdate 相同的工作，但 GMSCameraUpdate 會提供其他輔助方法，方便您操控相機。

舉例來說，如要使用 GMSCameraPosition 增加目前的縮放等級，您必須先建立目前的縮放等級，然後建立 GMSCameraPosition 物件，並將縮放比例設為大於目前縮放值。

或者，您也可以使用 zoomIn: 方法建構 GMSCameraUpdate 物件。然後將 GMSCameraUpdate 物件傳遞至 GMSMapView animateWithCameraUpdate: 方法，藉此更新相機。

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

請改用 GMSMapView moveCamera: 方法，將相機對齊新的位置。

在下一個範例中，您會使用 GMSCameraUpdate 為相機動作製作動畫效果，將溫哥華為中央。

// Center the camera on Vancouver, Canada
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let vancouverCam = GMSCameraUpdate.setTarget(vancouver)
mapView.animate(with: vancouverCam)
      

// Center the camera on Vancouver, Canada
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver];
[mapView animateWithCameraUpdate:vancouverCam];
      

建構 GMSCameraUpdate 物件

使用其中一種方法建構 GMSCameraUpdate 物件。

zoomIn:和zoomOut:

將目前的縮放等級變更為 1.0，所有其他屬性則保持不變。

zoomTo:

將縮放等級變更為指定值，所有其他屬性則保持不變。

zoomBy:

提高 (以負值為負數) 的指定縮放等級。

zoomBy:atPoint:

增加 (或降低至負數) 指定值時的縮放等級，同時保留指定點的位置。

setTarget:

變更相機的緯度和經度，同時保留所有其他屬性。

setTarget:zoom:

變更相機的緯度、經度和縮放，同時保留所有其他屬性。

setCamera:

設定新的 GMSCameraPosition。

scrollByX:Y:

變更相機的緯度和經度，以特定點數移動地圖。正 x 值會使相機向右移動，使地圖看起來已經向左移。正值 y 值會使相機向下移動，因此地圖看起來會向上移動。捲動是相對於相機目前的方位。舉例來說，如果相機的航向為 90 度，則正東為「向上」。

fitBounds:

轉換相機，以指定的最大縮放等級顯示螢幕上的邊界。將預設邊框間距套用至 64 點的邊界。

fitBounds:withPadding:

轉換相機，以指定的最大縮放等級顯示螢幕上的邊界。使用這個方法，可以為定界框兩側的所有點指定相同的邊框間距。

fitBounds:withEdgeInsets:

轉換相機，以指定的最大縮放等級顯示螢幕上的邊界。使用 UIEdgeInsets 即可分別指定定界框的邊框間距。

使用 GMSMapView 變更單一屬性

GMSMapView 提供多種方法，讓您無需使用 GMSCameraPosition 物件或 GMSCameraUpdate 物件即可移動相機。使用這些方法 (例如 animateToLocation: 或 animateToZoom:) 時，您可以對單一相機屬性的變更建立動畫效果。

舉例來說，使用 toViewingAngle: 方法可將相機傾斜角度的動畫製作成動畫。

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

設定目標 (位置)

位置會決定地圖中心。位置會以經緯度指定，並以 CLLocationCoordinate2D 以程式表示，以 CLLocationCoordinate2DMake 建立。

使用 GMSCameraPosition 變更位置。在這個範例中，地圖會對齊新的位置。

let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208)
mapView.camera = GMSCameraPosition(target: target, zoom: 6)
      

CLLocationCoordinate2D target =
    CLLocationCoordinate2DMake(-33.868, 151.208);
mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
      

如要為動畫建立動畫並平移地圖到新的位置，您可以使用 animateToCameraPosition: 方法，不必設定 camera 屬性。或者，在 GMSMapView 上使用 animateToLocation: 方法。

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
      

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
      

您也可以建立 GMSCameraUpdate 物件來移動相機。使用它的內建方法 scrollByX:Y: 指定在 X 和 Y 方向捲動相機的時間點。在這個範例中，您可以將相機 200 點向右捲動，並將 100 點向下移動：

// Move the camera 200 points to the right, and 100 points downwards
let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100)
mapView.animate(with: downwards)
      

// Move the camera 200 points to the right, and 100 points downwards
GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0];
[mapView animateWithCameraUpdate:downwards];
      

設定方位 (方向)

方位指的是指南針方向 (以度為單位，從正北算起，直到地圖頂端邊緣)。舉例來說，方位為 90 度的路線，會使頂端邊緣指向正東的地圖。

使用 GMSCameraPosition 或 GMSCameraUpdate 或 GMSMapView 的 animateToBearing: 方法，以程式輔助方式設定方位。

mapView.animate(toBearing: 0)
      

[mapView animateToBearing:0];
      

設定傾斜角度 (視角)

視野是指在地圖中心位置正上方和地球表面之間的弧形上，以天底 (相機正下方的方向) 測量至相機位置所得的值 (單位為度)。當您改變視角時，地圖會以視角呈現，其中相機和地圖位置的比例較大，而地圖位置顯示的尺寸則以較小尺寸顯示，進而產生 3D 效果。

視角可設定 0 (指向地圖正下方) 的範圍，最高可設為縮放等級上限。縮放等級為 16 以上時，最大角度為 65 度。縮放等級為 10 以下時，最大角度為 30 度。

使用 GMSCameraPosition 或 GMSCameraUpdate 或 GMSMapView 的 animateToViewingAngle: 方法，透過程式輔助方式設定檢視角度。

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

設定縮放功能

地圖比例取決於相機的縮放等級。縮放等級較大時，螢幕上會顯示較多細節；縮放等級較小時，您會看到更多世界。

使用 GMSCameraPosition 或 GMSCameraUpdate 或 GMSMapView 的 animateToZoom: 方法，以程式輔助方式設定縮放比例。

mapView.animate(toZoom: 12)
      

[mapView animateToZoom:12];
      

以下範例使用 zoomIn: 方法建構 GMSCameraUpdate 物件，為目前地圖放大一個縮放等級中的動畫。

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

設定界線

如要移動相機，以最可能的縮放等級顯示整個感興趣的區域，請設定相機檢視畫面的邊界。例如，如果您想顯示使用者目前位置周圍五英里內的所有加油站，請移動相機，讓所有加油站都顯示在畫面上：

1. 計算要在畫面上顯示的 GMSCoordinateBounds。
2. 使用 GMSMapView 的 cameraForBounds:insets: 方法傳回新的 GMSCameraPosition。

設定這些邊界，可確保指定的 GMSCoordinateBounds 完全符合目前地圖的大小。請注意，這個方法會將地圖傾斜和方位設定為 0。

下例示範如何變更相機，以相同檢視畫面顯示溫哥華和卡加利市。

let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05)
let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary)
let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())!
mapView.camera = camera
      

CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05);
GMSCoordinateBounds *bounds =
    [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary];
GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero];
mapView.camera = camera;
      

限制將使用者平移至指定區域

在上述情境中，您設定了地圖的邊界，但使用者可以捲動或平移至這些邊界之外。或者，您可能會想要限制地圖的焦點 (例如相機目標) 的經緯度中心邊界，讓使用者只能在這些邊界內捲動和平移。

舉例來說，購物中心或機場的零售應用程式可將地圖限制為特定範圍，讓使用者在這些邊界內捲動和平移。

如要限制平移至特定邊界，請將 GMSMapView 的 cameraTargetBounds 屬性設為定義必要邊界的 GMSCoordinateBounds 物件。如要稍後移除限制，請將 cameraTargetBounds 設為 nil。

mapView.cameraTargetBounds = bounds
      

mapView.cameraTargetBounds = bounds;
      

下圖說明將攝影機目標限制在比可視區域稍大範圍的情況。只要攝影機目標仍在限制區域內，使用者就能捲動及平移地圖。交叉符號代表攝影機目標：

即使可視區域會顯示超出定義邊界的區域，地圖仍會將可視區域填滿。舉例來說，如果您將相機目標放在限制區域的角落，可視區域中就會出現該角落以外的區域，但使用者無法捲動至該區域。請參考下圖說明。交叉符號代表攝影機目標：

在下圖中，相機目標的範圍非常有限，讓使用者幾乎無法捲動或平移地圖。交叉符號代表攝影機目標：

設定最小或最大變焦

全域常數 kGMSMinZoomLevel 和 kGMSMaxZoomLevel 會定義最小或最大縮放值。根據預設，GMSMapView 的 minZoom 和 maxZoom 屬性會設為這些常數。

如要限制地圖可用的縮放等級範圍，請設定縮放等級下限和上限。下列程式碼會將縮放等級限制在 10 到 15 之間。

let camera = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 12
)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.setMinZoom(10, maxZoom: 15)
      

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887
                                                       longitude:-87.622
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero
                                        camera:camera];
[mapView setMinZoom:10 maxZoom:15];
      

您必須使用 setMinZoom:maxZoom: 方法設定縮放範圍；不過，您可以使用 minZoom 和 maxZoom 屬性讀取目前的值。如果限制其中一個值，這種做法就能派上用場。下列程式碼只會變更最小縮放等級。

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
      

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
      

如果在更新最小和最大縮放後，相機的縮放等級設為新範圍外的值，目前的變焦就會自動更新以顯示最接近的有效值。例如，在下列程式碼中，原始縮放等級定義為 4。稍後將縮放範圍設為 10-15 時，目前的縮放比例會更新為 10。

// Sets the zoom level to 4.
let camera2 = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 4
)
let mapView2 = GMSMapView(frame: .zero, camera: camera)

// The current zoom, 4, is outside of the range. The zoom will change to 10.
mapView.setMinZoom(10, maxZoom: 15)
      

// Sets the zoom level to 4.
GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887
                                                         longitude:-87.622
                                                              zoom:4];
GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero
                                         camera:camera];
// The current zoom, 4, is outside of the range. The zoom will change to 10.
[mapView setMinZoom:10 maxZoom:15];