總覽

標記是放置在地圖表面上特定位置的圖示。

標記的圖示是以裝置螢幕方向為根據，而非地圖表面；也就是說，標記圖示不一定會因地圖旋轉、傾斜或縮放而改變方向。

靜態公開成員函式
(instancetype)	+ markerWithPosition：
	預設標記的便利建構函式。
(UIImage *)	+ markerImageWithColor：
	建立預設標記圖片的色調版本，做為圖示。
資源
CLLocationCoordinate2D	位置
	標記位置。
NSString *	摘要
	選取後，文字片段會顯示在資訊視窗標題下方。
UIImage *	圖示
	要算繪的標記圖示。
UIView *	iconView
	要算繪的標記檢視。
BOOL	tracksViewChanges
	控制此標記的圖示是否應在每個頁框重新繪製。
BOOL	tracksInfoWindowChanges
	控制此標記的資訊視窗是否應在每個頁框中重新繪製。
CGPoint	groundAnchor
	地面錨點會指定圖示圖片中的點，該點會固定在標記在地球表面上的位置。
CGPoint	infoWindowAnchor
	資訊視窗錨定標記會指定圖示圖片中固定資訊視窗的點，該點將直接顯示在這個點上方。
GMSMarkerAnimation	lookAnimation
	控制放置此標記時所採用的動畫GMSMapView (預設 kGMSMarkerAnimationNone，無動畫)。
BOOL	可拖曳
	控制是否以互動方式拖曳此標記 (預設值為 NO)。
BOOL	平面
	控制此標記應平放於地球表面 (YES) 或面向攝影機的看板 (NO，預設值)。
CLLocationDegrees	旋轉
	設定標記錨定點的順時針旋轉角度。
浮點值	不透明度
	設定標記的不透明度，範圍介於 0 (完全透明) 和 1 (預設) 之間 (含首尾)。
GMSMarkerLayer *	圖層
	提供這個核心動畫圖層GMSMarker。
GMSPanoramaView *	panoramaView
	`panoramaView` 會指定要嘗試顯示這個標記的全景檢視。
NSString *	title
	標題，這是重疊廣告的簡短說明。
GMSMapView *	地圖
	這個疊加層開啟的地圖
BOOL	可輕觸
	如果這張重疊元素應導致輕觸通知。
int	zIndex
	較高的 `zIndex` 值疊加層會繪製在較低 `zIndex` 值的圖塊圖層和疊加層之上。
ID	使用者資料
	重疊資料。

成員功能說明文件

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) 位置

預設標記的便利建構函式。

+ (UIImage *) markerImageWithColor： (可為空值的 UIColor *) color [顏色]

建立預設標記圖片的色調版本，做為圖示。

屬性說明文件

- (CLLocationCoordinate2D) position [read, write, assign]

標記位置。

動畫。

- (NSString*) 程式碼片段 [read, write, copy]

選取後，文字片段會顯示在資訊視窗標題下方。

- (UIImage*) 圖示 [read, write, assign]

要算繪的標記圖示。

如果留空，系統會使用預設的 SDK 地點標記。

支援動畫圖片，但每個影格的大小必須相同，或是行為未定義。

支援使用 AlignmentRectInsets 來指定縮減的輕觸區域。這會重新定義錨點的指定方式。如果是動畫圖片，它會使用動畫的值，而非個別影格的值。

- (UIView*) iconView [read, write, assign]

要算繪的標記檢視。

如果留空，系統會改用 icon 屬性。

支援 UIView 所有可動畫屬性的動畫 (frame 和 center 除外)。不支援變更這些屬性或其對應的 CALayer 版本，包括 position。

請注意，無論實際值為何，檢視畫面的行為都會視為 clipsToBounds 設為 YES 時運作。

- (BOOL) tracksViewChanges [read, write, assign]

控制此標記的圖示是否應在每個頁框重新繪製。

請注意，當這個圖示從 NO 變更為 YES 時，系統一定會在下一個頁框中重新繪製圖示。

預設為 YES。如果 iconView 為 nil，則無效。

- (BOOL) tracksInfoWindowChanges [read, write, assign]

控制此標記的資訊視窗是否應在每個頁框中重新繪製。

請注意，當從 NO 變更為 YES 時，資訊視窗會重新繪製下一個頁框。

預設值為 NO。

- (CGPoint) groundAnchor [read, write, assign]

地面錨點會指定圖示圖片中的點，該點會固定在標記在地球表面上的位置。

這個點是在連續空間 [0.0, 1.0] x [0.0, 1.0] 內指定，其中 (0,0) 是圖片的左上角，(1,1) 則是右下角。

如果圖片包含非零的對齊 RectInsets，上述中左上角和右下角都代表圖片的插邊部分。

- (CGPoint) infoWindowAnchor [read, write, assign]

資訊視窗錨定標記會指定圖示圖片中固定資訊視窗的點，該點將直接顯示在這個點上方。

這個點的指定空間與 groundAnchor 相同。

- (GMSMarkerAnimation) 一覽動畫 [read, write, assign]

控制放置此標記時所採用的動畫GMSMapView (預設 kGMSMarkerAnimationNone，無動畫)。

- (BOOL) 可拖曳 [read, write, assign]

控制是否以互動方式拖曳此標記 (預設值為 NO)。

- (BOOL) 平面 [read, write, assign]

控制此標記應平放於地球表面 (YES) 或面向攝影機的看板 (NO，預設值)。

- (CLLocationDegrees) 旋轉 [read, write, assign]

設定標記錨定點的順時針旋轉角度。

旋轉軸適用於標記。旋轉 0 會對應至標記的預設位置。動畫。

當標記平放在地圖上時，預設位置是朝北對齊，且旋轉時標記永遠保持平放在地圖上。當標記是看板廣告時，預設位置為朝上，且旋轉時標記始終面對攝影機。

- (浮動) 透明度 [read, write, assign]

設定標記的不透明度，範圍介於 0 (完全透明) 和 1 (預設) 之間 (含首尾)。

- (GMSMarkerLayer*) 圖層 [read, assign]

提供這個核心動畫圖層GMSMarker。

- (GMSPanoramaView*) panoramaView [read, write, assign]

panoramaView 會指定要嘗試顯示這個標記的全景檢視。

請注意，如果標記的 position 與 panoramaView 目前的全景位置距離太遠，就不會顯示因為標記太小。

可設為 nil，從任何已套用的全景檢視中移除標記。

全景和地圖可以同時顯示標記。

- (NSString*) 名稱 [read, write, copy, inherited]

標題，這是重疊廣告的簡短說明。

部分疊加層 (例如標記) 會在地圖上顯示標題。標題也是預設的無障礙文字。

- (GMSMapView*) map [read, write, assign, inherited]

這個疊加層開啟的地圖

設定這個屬性會將疊加層加入地圖。將其設為 nil 則會從地圖中移除這個疊加層。一次最多只能在一張地圖上啟用疊加層。

- (BOOL) 適用 [read, write, assign, inherited]

如果這張重疊元素應導致輕觸通知。

部分疊加層 (例如標記) 會預設為可輕觸。

- (int) zIndex [read, write, assign, inherited]

較高的 zIndex 值疊加層會繪製在較低 zIndex 值的圖塊圖層和疊加層之上。

相等值會產生未定義的繪製順序。唯一的例外是，無論 zIndex 為何，標記一律會繪製在圖塊圖層和其他非標記疊加層上方；系統實際上會將這類標記視為獨立的 Z-index 群組，而非其他疊加層。

- (ID) userData [read, write, assign, inherited]

重疊資料。

您可以使用這個屬性，將任意物件與此疊加層建立關聯。Google Maps SDK for iOS 不會讀取或寫入這個屬性。

請注意，userData 不應保留任何 Maps 物件的強式參照，否則可建立保留週期 (防止物件釋放)。

GMSMarker 類別參考資料

總覽

靜態公開成員函式

資源

成員功能說明文件

屬性說明文件