總覽
進階標記是指放置在地圖表面上特定點的圖示。
繼承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 不應保留任何與地圖物件相關的強式參照，否則可以建立保留週期 (防止物件被釋放)。