總覽
進階標記是指放置在地圖表面上特定點的圖示。
繼承GMSMarker 。
靜態成員函式 | |
(instancetype) | + markerWithPosition: |
預設標記的便利建構函式。 | |
(UIImage *) | + markerImageWithColor: |
建立預設標記圖片的色調,做為圖示使用。 | |
資源 | |
GMSCollisionBehavior | collisionBehavior |
標記的衝突行為,可判斷標記的顯示設定是否可受其他標記或地圖上的標籤內容影響。 | |
CLLocationCoordinate2D | position |
標記位置。 | |
NSString * | 文字片段 |
網站簡介文字,已選取後會在資訊視窗的標題下方顯示。 | |
UIImage * | 圖示 |
算繪的標記圖示。 | |
UIView * | iconView |
要算繪的標記檢視畫面。 | |
BOOL | tracksViewChanges |
控制是否應在每個頁框中重新繪製這個標記的圖示。 | |
BOOL | tracksInfoWindowChanges |
控制是否應在每個頁框中重新繪製這個標記的資訊視窗。 | |
CGPoint | groundAnchor |
地面錨點會指定圖示圖片中的點,該點會固定在地球表面上標記的位置。 | |
CGPoint | infoWindowAnchor |
資訊視窗錨定標記會在圖示圖片中指定錨定標記的點,資訊視窗會顯示在這個點正上方。 | |
GMSMarkerAnimation | appearAnimation |
控制此標記放置於此標記時使用的動畫GMSMapView(默認 kGMSMarkerAnimationNone,無動畫)。 | |
BOOL | 可拖曳 |
控制這個標記是否可用互動式拖曳 (預設為 NO)。 | |
BOOL | 平鋪式 |
控制這個標記是否應平貼於地球表面 (YES) 或面向相機的看板廣告 (否,預設值)。 | |
CLLocationDegrees | 旋轉 |
設定標記錨點的順時針旋轉度數。 | |
float | 不透明度 |
設定標記的不透明度,介於 0 (完全透明) 和 1 (預設) 之間 (含首尾)。 | |
GMSMarkerLayer * | 圖層 |
提供此位置的核心動畫圖層GMSMarker 。 | |
GMSPanoramaView * | panoramaView |
panoramaView 會指定用來顯示這個標記的全景檢視畫面。 | |
NSString * | title |
標題:重疊的簡短說明。 | |
GMSMapView * | 地圖 |
這個疊加層開啟的地圖。 | |
BOOL | 可 tappable |
如果疊加元素應造成輕觸通知。 | |
int | zIndex |
zIndex 值較高的疊加層會繪製在較低的 zIndex 值圖塊圖層和疊加層之上。 | |
ID | userData |
重疊資料。 |
成員函式說明文件
+ (執行個體類型) markerWithPosition: | (CLLocationCoordinate2D) | position |
預設標記的便利建構函式。
+ (UIImage *) markerImageWithColor: | (nullable UIColor *) | color [顏色] |
建立預設標記圖片的色調,做為圖示使用。
資源說明文件
- (GMSCollisionBehavior) collisionBehavior [read, write, assign] |
標記的衝突行為,可判斷標記的顯示設定是否可受其他標記或地圖上的標籤內容影響。
- (CLLocationCoordinate2D) position [read, write, assign, inherited] |
標記位置。
動畫。
- (NSString*) 程式碼片段 [read, write, copy, inherited] |
網站簡介文字,已選取後會在資訊視窗的標題下方顯示。
- (UIImage*) 圖示 [read, write, assign, inherited] |
算繪的標記圖示。
如果左 nil,使用預設的 SDK 地點標記。
支援動畫圖片,但每個影格的大小必須相同,或行為未定義。
支援使用 alignRectInsets 指定縮小的輕觸區域。這會重新定義錨點的指定方式。如果是動畫圖片,系統會使用動畫的值,而非個別影格。
- (UIView*) iconView [read, write, assign, inherited] |
要算繪的標記檢視畫面。
如果留空,就會改用 icon
屬性。
支援 UIView 所有動畫屬性的動畫,但 frame
和 center
除外。無法變更這些屬性或其對應的 CALayer 版本,包括 position
。
請注意,無論實際值為何,檢視畫面運作方式與 clipsToBounds
設為 YES 時相同。
- (BOOL) tracksViewChanges [read, write, assign, inherited] |
控制是否應在每個頁框中重新繪製這個標記的圖示。
請注意,當這項變更從 NO 變更為 YES 時,系統會保證在下一個頁框中重新繪製該圖示。
預設為 YES。如果 iconView
為 nil,則不具任何效力。
- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited] |
控制是否應在每個頁框中重新繪製這個標記的資訊視窗。
請注意,當此值從 NO 變更為 YES 時,系統會保證在下一個頁框中重新繪製資訊視窗。
預設值為 NO。
- (CGPoint) groundAnchor [read, write, assign, inherited] |
地面錨點會指定圖示圖片中的點,該點會固定在地球表面上標記的位置。
這個點是在連續空間 [0.0, 1.0] x [0.0, 1.0] 內指定,其中 (0,0) 是圖片的左上角,(1,1) 是右下角。
如果圖片的 alignRectInsets 並非零,上述的左上角和右下方是指圖片的插邊部分。
- (CGPoint) infoWindowAnchor [read, write, assign, inherited] |
資訊視窗錨定標記會在圖示圖片中指定錨定標記的點,資訊視窗會顯示在這個點正上方。
這個點是在與 groundAnchor 相同的空間內指定。
- (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited] |
控制此標記放置於此標記時使用的動畫GMSMapView(默認 kGMSMarkerAnimationNone,無動畫)。
- (BOOL) 可拖曳 [read, write, assign, inherited] |
控制這個標記是否可用互動式拖曳 (預設為 NO)。
- (BOOL) 平面 [read, write, assign, inherited] |
控制這個標記是否應平貼於地球表面 (YES) 或面向相機的看板廣告 (否,預設值)。
- (CLLocationDegrees) 旋轉 [read, write, assign, inherited] |
設定標記錨點的順時針旋轉度數。
旋轉軸與標記垂直。旋轉 0 對應至標記的預設位置。動畫。
當標記平放在地圖上時,預設位置為朝北,而旋轉則是地圖上始終將標記保持平放。當標記是看板時,預設方向為朝上,且旋轉時標記始終面對攝影機。
- (浮點值) 不透明度 [read, write, assign, inherited] |
設定標記的不透明度,介於 0 (完全透明) 和 1 (預設) 之間 (含首尾)。
- (GMSMarkerLayer*) 圖層 [read, assign, inherited] |
提供此位置的核心動畫圖層GMSMarker 。
- (GMSPanoramaView*) panoramaView [read, write, assign, inherited] |
panoramaView
會指定用來顯示這個標記的全景檢視畫面。
請注意,如果標記的 position
與 panoramaView
目前的全景位置距離太遠,則不會顯示,因為標記太小。
只要將標記設為 nil,即可從任何目前所附加的全景檢視中移除標記。
全景和地圖可以同時顯示標記。
- (NSString*) 名稱 [read, write, copy, inherited] |
標題:重疊的簡短說明。
部分疊加層 (例如標記) 會在地圖上顯示標題。標題也是預設的無障礙文字。
- (GMSMapView*) 地圖 [read, write, assign, inherited] |
這個疊加層開啟的地圖。
設定此屬性會將疊加層加入地圖。將其設為 nil 會從地圖中移除此疊加層。在任何特定時間內,疊加層都只能啟用在一張地圖上。
- (BOOL) 適用 [read, write, assign, inherited] |
如果疊加元素應造成輕觸通知。
部分疊加層 (例如標記) 預設為可輕觸。
- (整數) zIndex [read, write, assign, inherited] |
zIndex
值較高的疊加層會繪製在較低的 zIndex
值圖塊圖層和疊加層之上。
等值會產生未定義的繪製順序。標記是例外情況,無論 zIndex
為何,標記一律會繪製在圖塊圖層和其他非標記疊加層上方;系統實際上會將標記視為單獨的 Z-index 群組進行處理,獨立於其他疊加層。
- (ID) userData [read, write, assign, inherited] |
重疊資料。
您可以使用這個屬性,將任意物件與此疊加層建立關聯。Google Maps SDK for iOS 既不會讀取也不會寫入這個屬性。
請注意,userData 不應保留任何與地圖物件相關的強式參照,否則可以建立保留週期 (防止物件被釋放)。