標記是用來標出地圖上的某個位置,
根據預設,標記會使用標準圖示,具有常見的 Google 地圖外觀和風格。如要自訂標記,您可以變更預設標記的顏色、以自訂圖示取代標記圖片,或是變更標記的其他屬性。
如要回應標記的點擊事件,您可以開啟資訊視窗。資訊視窗會在標記上方的對話方塊中顯示文字或圖片,您可以使用預設資訊視窗來顯示文字,也可以建立自訂資訊視窗,完全控制其內容。
新增標記
如要新增標記,請建立包含 position
和 title
的 GMSMarker
物件,並設定其 map
。
以下範例說明如何將標記新增至現有的 GMSMapView
物件。標記是在座標 10,10
建立,當使用者按一下標記,資訊視窗中就會顯示「Hello world」字串。
Swift
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.title = "Hello World" marker.map = mapView
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.title = @"Hello World"; marker.map = mapView;
只要將 marker.appearAnimation
屬性設為:
kGMSMarkerAnimationPop
可在新增標記時從其groundAnchor
彈出。kGMSMarkerAnimationFadeIn
:使標記在新增時淡入。
移除標記
如要將標記從地圖中移除,您可以將 GMSMarker
的 map
屬性設為 nil
。或者,您也可以呼叫 GMSMapView
clear
方法,移除地圖上目前的所有疊加層 (包括標記)。
Swift
let camera = GMSCameraPosition.camera( withLatitude: -33.8683, longitude: 151.2086, zoom: 6 ) let mapView = GMSMapView.map(withFrame: .zero, camera: camera) // ... mapView.clear()
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6]; mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; // ... [mapView clear];
如果您在將標記加入地圖後想修改標記,請務必保留 GMSMarker
物件,您稍後可以變更這個物件來修改標記。
Swift
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.map = mapView // ... marker.map = nil
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.map = mapView; // ... marker.map = nil;
變更標記顏色
如要自訂預設標記圖片的顏色,請使用 markerImageWithColor:
要求色調版本的預設圖示,並將產生的圖片傳遞至 GMSMarker
的圖示屬性。
Swift
marker.icon = GMSMarker.markerImage(with: .black)
Objective-C
marker.icon = [GMSMarker markerImageWithColor:[UIColor blackColor]];
自訂標記圖片
如要變更預設標記圖片,您可以使用標記的 icon
或 iconView
屬性設定自訂圖示。如果設定了 iconView
,API 會忽略 icon
屬性。
使用標記的 icon
屬性
下列程式碼片段會建立一個標記,其中包含在 icon
屬性中做為 UIImage
提供的自訂圖示。該圖示以英國倫敦為中心。這段程式碼假設您的應用程式含有名為「house.png」的圖片。
Swift
let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let london = GMSMarker(position: positionLondon) london.title = "London" london.icon = UIImage(named: "house") london.map = mapView
Objective-C
CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127); GMSMarker *london = [GMSMarker markerWithPosition:positionLondon]; london.title = @"London"; london.icon = [UIImage imageNamed:@"house"]; london.map = mapView;
如果您要使用相同圖片建立多個標記,請為每個標記使用相同的 UIImage
執行個體。這有助於改善應用程式顯示許多標記時的效能。
這張圖片可能有多個畫面。此外,系統也遵循 alignmentRectInsets
屬性,這在標記包含陰影或其他無法使用的區域時相當實用。
使用標記的 iconView
屬性
下列程式碼片段會透過設定標記的 iconView
屬性,建立包含自訂圖示的標記,並加上標記顏色變化的動畫效果。The snippet assumes that your application contains an image named "house.png".
Swift
import CoreLocation import GoogleMaps class MarkerViewController: UIViewController, GMSMapViewDelegate { var mapView: GMSMapView! var london: GMSMarker? var londonView: UIImageView? override func viewDidLoad() { super.viewDidLoad() let camera = GMSCameraPosition.camera( withLatitude: 51.5, longitude: -0.127, zoom: 14 ) let mapView = GMSMapView.map(withFrame: .zero, camera: camera) view = mapView mapView.delegate = self let house = UIImage(named: "House")!.withRenderingMode(.alwaysTemplate) let markerView = UIImageView(image: house) markerView.tintColor = .red londonView = markerView let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let marker = GMSMarker(position: position) marker.title = "London" marker.iconView = markerView marker.tracksViewChanges = true marker.map = mapView london = marker } func mapView(_ mapView: GMSMapView, idleAt position: GMSCameraPosition) { UIView.animate(withDuration: 5.0, animations: { () -> Void in self.londonView?.tintColor = .blue }, completion: {(finished) in // Stop tracking view changes to allow CPU to idle. self.london?.tracksViewChanges = false }) } }
Objective-C
@import CoreLocation; @import GoogleMaps; @interface MarkerViewController : UIViewController <GMSMapViewDelegate> @property (strong, nonatomic) GMSMapView *mapView; @end @implementation MarkerViewController { GMSMarker *_london; UIImageView *_londonView; } - (void)viewDidLoad { [super viewDidLoad]; GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:51.5 longitude:-0.127 zoom:14]; _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; self.view = _mapView; _mapView.delegate = self; UIImage *house = [UIImage imageNamed:@"House"]; house = [house imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate]; _londonView = [[UIImageView alloc] initWithImage:house]; _londonView.tintColor = [UIColor redColor]; CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127); _london = [GMSMarker markerWithPosition:position]; _london.title = @"London"; _london.iconView = _londonView; _london.tracksViewChanges = YES; _london.map = self.mapView; } - (void)mapView:(GMSMapView *)mapView idleAtCameraPosition:(GMSCameraPosition *)position { [UIView animateWithDuration:5.0 animations:^{ self->_londonView.tintColor = [UIColor blueColor]; } completion:^(BOOL finished) { // Stop tracking view changes to allow CPU to idle. self->_london.tracksViewChanges = NO; }]; } @end
iconView
接受 UIView
,因此您可以使用階層式 UI 控制項來定義標記,因此每個檢視畫面都會有一組標準動畫功能。您可以加入變更標記大小、顏色和 Alpha 等級,也可以套用任意轉換。iconView
屬性支援 UIView
所有動畫屬性的動畫,但 frame
和 center
除外。
- 當
tracksViewChanges
設為YES
時,UIView
可能會耗用資源,而這可能會增加電池用量。相較之下,單一影格UIImage
是靜態的,不需要重新轉譯。 - 如果螢幕上有多個標記,且每個標記都有各自的
UIView
,且所有標記會同時追蹤變化,某些裝置可能無法順利算繪地圖。 iconView
是檢視畫面的快照,因此不會回應使用者互動。- 無論實際值為何,檢視畫面都會以
clipsToBounds
設為YES
的方式運作。您可以套用不在範圍範圍內的轉換,但您繪製的物件必須在物件邊界內。系統會監控並套用所有轉換/位移。簡單來說,子檢視畫面必須包含在檢視畫面中。
如要決定設定 tracksViewChanges
屬性的時機,您應評估效能考量,以及自動重新繪製標記的好處。例如:
- 如果您要進行一系列變更,可以將屬性變更為
YES
,然後再回NO
。 - 當動畫執行中或內容以非同步方式載入時,您應將屬性維持設為
YES
,直到動作完成為止。
變更標記不透明度
您可以使用標記的 opacity
屬性控制標記的不透明度。您應將不透明度指定為介於 0.0 和 1.0 之間的浮動值,其中 0 表示完全透明,1 表示完全不透明。
Swift
marker.opacity = 0.6
Objective-C
marker.opacity = 0.6;
您可使用 GMSMarkerLayer
為標記不透明度的 [Core Animation]Core 動畫 建立動畫。
平放標記
標記圖示通常會依據裝置螢幕方向 (而非地圖表面) 繪製方向,因此旋轉、傾斜或縮放地圖不一定會改變標記的方向。
你可以設置一個標記的方向是平貼在地上。地圖旋轉時,平放標記會旋轉;地圖傾斜時,標記也會改變角度。和一般標記一樣,縮放地圖時,平放標記的大小不會改變。
如要變更標記的方向,請將標記的 flat
屬性設為 YES
或 true
。
Swift
let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let londonMarker = GMSMarker(position: positionLondon) londonMarker.isFlat = true londonMarker.map = mapView
Objective-C
CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127); GMSMarker *londonMarker = [GMSMarker markerWithPosition:positionLondon]; londonMarker.flat = YES; londonMarker.map = mapView;
旋轉標記
如要讓標記繞著錨點旋轉,請設定 rotation
屬性。將旋轉指定為 CLLocationDegrees
類型 (以從預設位置順時針角度測量)。如果標記平放在地圖上,則預設方向為朝北。
以下範例會將標記旋轉 90°。將 groundAnchor
屬性設為 0.5,0.5
後,標記將圍繞其中心旋轉,而非其基底。
Swift
let degrees = 90.0 londonMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5) londonMarker.rotation = degrees londonMarker.map = mapView
Objective-C
CLLocationDegrees degrees = 90; londonMarker.groundAnchor = CGPointMake(0.5, 0.5); londonMarker.rotation = degrees; londonMarker.map = mapView;
處理標記上的事件
你可以監聽地圖上發生的事件 (例如使用者輕觸標記時),如要監聽事件,您必須實作 GMSMapViewDelegate
通訊協定。請參閱「標記事件和手勢」一文,瞭解如何處理特定標記事件。事件指南也提供 GMSMapView 委派 方法清單。如需街景服務事件,請參閱 GMSPanoramaViewDelegate
。