GMSCameraPosition 類別參考資料

GMSCameraPosition 類別參考

總覽

匯總所有相機位置參數的不可變類別。

由繼承GMSMutableCameraPosition

公開成員函式

(執行個體類型)- initWithTarget:zoom:bearing:viewingAngle:
 指定初始化器。
(執行個體類型)- initWithTarget:zoom:
 特定目標和縮放等級的便利初始化器GMSCameraPosition
(執行個體類型)- initWithLatitude:longitude:zoom:
 特定經緯度的便利初始化器GMSCameraPosition
(執行個體類型)- initWithLatitude:longitude:zoom:bearing:viewingAngle:
 GMSCameraPosition的便利初始化器,根據 -initWithTarget:zoom:bearing:viewingAngle:.

靜態公開成員函式

(執行個體類型)+ cameraWithTarget:zoom:
 特定目標和縮放等級的GMSCameraPosition的便利建構函式。
(執行個體類型)+ cameraWithLatitude:longitude:zoom:
 GMSCameraPosition的便利建構函式,根據 cameraWithTarget:zoom:.
(執行個體類型)+ cameraWithTarget:zoom:bearing:viewingAngle:
 GMSCameraPosition 的便利建構函式,具有所有相機屬性,如 initWithTarget:zoom:bearing:viewingAngle:
(執行個體類型)+ cameraWithLatitude:longitude:zoom:bearing:viewingAngle:
 GMSCameraPosition的便利建構函式,附有經緯度和所有其他相機屬性,如 initWithTarget:zoom:bearing:viewingAngle:
(float) + zoomAtCoordinate:forMeters:perPoints:
 取得縮放等級,在地球上指定 coordmeters 距離,對應指定畫面 points 的縮放等級。

資源

CLLocationCoordinate2D目標
 在地球上放置攝影機的位置。
float 縮放
 縮放等級。
CLLocationDirection聲音
 相機方位,以正北為時針角度,以度為單位。
DoubleviewingAngle
 從天底 (直接朝向地球) 相機的角度,以度為單位。

成員函式說明文件

- (instancetype) initWithTarget: (CLLocationCoordinate2D)  目標
縮放: (float)  縮放
方位: (CLLocationDirection) 聲音
viewAngle: (雙精度浮點數) viewingAngle

指定初始化器。

設定這GMSCameraPosition具備所有可用的相機屬性。透過此初始化器 (或下列便利建構函式) 建構GMSCameraPosition將會隱含相機的值。

參數:
目標攝影機指向的地表位置。
zoom畫面中央附近的縮放等級。
方位以正北為時針方向的相機方位,以度為單位。
viewingAngle從天底 (直接朝向地球) 相機角度的角度,以度為單位
- (instancetype) initWithTarget: (CLLocationCoordinate2D)  目標
縮放: (float)  zoom

特定目標和縮放等級的便利初始化器GMSCameraPosition

這會將此攝影機的航向和 viewAngle 屬性設為零預設值 (即直接面對地球表面,螢幕頂端指向北方)。

參數:
目標攝影機指向的地表位置。
zoom畫面中央附近的縮放等級。
- (instancetype) initWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
縮放: (float)  zoom

特定經緯度的便利初始化器GMSCameraPosition

這會將此攝影機的航向和 viewAngle 屬性設為零預設值 (即直接面對地球表面,螢幕頂端指向北方)。

參數:
latitude攝影機指向的位置緯度元件。
longitude攝影機指向的位置緯度元件。
zoom畫面中央附近的縮放等級。
- (instancetype) initWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
縮放: (float)  縮放
方位: (CLLocationDirection) 聲音
viewAngle: (雙精度浮點數) viewingAngle

GMSCameraPosition的便利初始化器,根據 -initWithTarget:zoom:bearing:viewingAngle:.

參數:
latitude攝影機指向的位置緯度元件。
longitude攝影機指向的位置緯度元件。
zoom畫面中央附近的縮放等級。
方位以正北為時針方向的相機方位,以度為單位。
viewingAngle從天底 (直接朝向地球) 相機角度的角度,以度為單位
+ (例項類型) cameraWithTarget: (CLLocationCoordinate2D)  目標
縮放: (float)  zoom

特定目標和縮放等級的GMSCameraPosition的便利建構函式。

這會將此攝影機的航向和 viewAngle 屬性設為零預設值 (即直接面對地球表面,螢幕頂端指向北方)。

+ (例項類型) cameraWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
縮放: (float)  zoom

GMSCameraPosition的便利建構函式,根據 cameraWithTarget:zoom:.

+ (例項類型) cameraWithTarget: (CLLocationCoordinate2D)  目標
縮放: (float)  縮放
方位: (CLLocationDirection) 聲音
viewAngle: (雙精度浮點數) viewingAngle

GMSCameraPosition 的便利建構函式,具有所有相機屬性,如 initWithTarget:zoom:bearing:viewingAngle:

+ (例項類型) cameraWithLatitude: (CLLocationDegrees) latitude
longitude: (CLLocationDegrees) longitude
縮放: (float)  縮放
方位: (CLLocationDirection) 聲音
viewAngle: (雙精度浮點數) viewingAngle

GMSCameraPosition的便利建構函式,附有經緯度和所有其他相機屬性,如 initWithTarget:zoom:bearing:viewingAngle:

+ (float)zoomAtCoordinate: (CLLocationCoordinate2D)  座標
ForMeter: (CLLocationDistance) 公尺
perPoints: (CGFloat) points

取得縮放等級,在地球上指定 coordmeters 距離,對應指定畫面 points 的縮放等級。

如果是非常大或偏小的距離,傳回的縮放等級可能會小於或大於相機允許的最小或最大縮放等級。

如果您要建構的相機位置包含地球上的特定實際區域,這個輔助方法就非常實用。


屬性說明文件

- (CLLocationCoordinate2D) 目標 [read, assign]

在地球上放置攝影機的位置。

實作於GMSMutableCameraPosition

- (浮點) zoom [read, assign]

縮放等級。

Zoom 採用指數比例,其中縮放等級 0 代表整個世界,也就是 256 x 256 的正方形。每個連續縮放等級會將放大倍率增加 2 倍。因此,縮放等級為 1 時,世界為 512x512,縮放等級為 2 時,整個世界則為 1024x1024。

實作於GMSMutableCameraPosition

- (CLLocationDirection) bearing [read, assign]

相機方位,以正北為時針角度,以度為單位。

實作於GMSMutableCameraPosition

- (雙倍精度) viewingAngle [read, assign]

從天底 (直接朝向地球) 相機的角度,以度為單位。

0 為垂直向下,90 則與地面平行。請注意,允許的最大角度視縮放等級而定。您可以將此視為一系列的線段,做為縮放的函數,而非步數函式。在縮放 16 以上時,最大角度為 65 度。在縮放 10 以下時,最大角度為 30 度。

實作於GMSMutableCameraPosition