<GMSMapViewDelegate> 协议参考

公开成员函数

<GMSMapViewDelegate> 协议参考

---

概览

委托 GMSMapView 上的事件。

公开成员函数
(void)	- mapView:willMove:
	无论是在手势、动画（例如，用户点按“我的位置”按钮）之后，还是通过相机或图层上的零长度动画进行明确更新，在地图发生变化前被调用。
(void)	- mapView:didChangeCameraPosition:
	在地图上的任何动画或手势期间重复调用（或者，如果明确设置了相机，则调用一次）。
(void)	- mapView:idleAtCameraPosition：
	在地图变为空闲状态、所有未完成的手势或动画完成（或明确设置摄像头后）时调用。
(void)	- mapView:didTapAtCoordinate:
	在特定坐标处点按手势后调用，但仅在未点按标记时调用。
(void)	- mapView:didLongPressAtCoordinate:
	在特定坐标处长按手势后调用。
（布尔值）	- mapView:didTapMarker:
	在用户点按标记后调用。
(void)	- mapView:didTapInfoWindowOfMarker:
	在用户点按标记信息窗口后调用。
(void)	- mapView:didLongPressInfoWindowOfMarker:
	在长按标记的信息窗口后调用。
(void)	- mapView:didTapOverlay:
	在点按叠加层后调用。
(void)	- mapView:didTapPOIWithPlaceID:name:location:
	在用户点按某个地图注点后调用。
（可为 null 的 UIView *）	- mapView:markerInfoWindow:
	在标记即将被选择时调用，并在相应方法返回 UIView 时提供可用于该标记的可选自定义信息窗口。
（可为 null 的 UIView *）	- mapView:markerInfoContents:
	在 mapView:markerInfoWindow: 返回 nil 时调用。
(void)	- mapView:didCloseInfoWindowOfMarker:
	在标记的信息窗口关闭时调用。
(void)	- mapView:didBeginDraggingMarker：
	在相应标记上启动拖动时调用。
(void)	- mapView:didEndDraggingMarker:
	在标记拖动完毕后调用。
(void)	- mapView:didDragMarker:
	在拖动标记时调用。
（布尔值）	- didTapMyLocationButtonForMapView：
	在用户点按“我的位置”按钮时调用。
(void)	- mapView:didTapMyLocation:
	当用户点按“我的位置”圆点时调用。
(void)	- mapViewDidStartTileRendering:
	在刚刚请求图块或标签刚刚开始渲染时调用。
(void)	- mapViewDidFinishTileRendering:
	当所有图块均已加载（或永久失败）且标签已呈现时调用。
(void)	- mapViewSnapshotReady:
	在地图稳定（已加载图块、呈现标签、相机空闲）和叠加层对象呈现时调用。
(void)	- mapView:didChangeMapCapabilities:
	在每次地图功能更改时调用。

---

成员函数文档

- (void) mapView：		(GMSMapView *)	mapView
WillMove：		（布尔值）	手势
			[optional]

无论是在手势、动画（例如，用户点按“我的位置”按钮）之后，还是通过相机或图层上的零长度动画进行明确更新，在地图发生变化前被调用。

参数：

地图视图	点按的地图视图。
手势	如果为“是”，这是由用户手势引起的。

- (void) mapView：		(GMSMapView *)	mapView
doChangeCameraPosition：		(GMSCameraPosition *)	职位
			[optional]

在地图上的任何动画或手势期间重复调用（或者，如果明确设置了相机，则调用一次）。

并非所有中间相机位置都能调用此方法。始终针对动画或手势的最终位置调用它。

- (void) mapView：		(GMSMapView *)	mapView
idAtCameraPosition：		(GMSCameraPosition *)	职位
			[optional]

在地图变为空闲状态、所有未完成的手势或动画完成（或明确设置摄像头后）时调用。

- (void) mapView：		(GMSMapView *)	mapView
doTapAtCoordinate：		(CLLocationCoordinate2D)	坐标
			[optional]

在特定坐标处点按手势后调用，但仅在未点按标记时调用。

此方法是在取消选择当前所选的任何标记（点按地图的隐式操作）之前调用的。

- (void) mapView：		(GMSMapView *)	mapView
doLongPressAtCoordinate：		(CLLocationCoordinate2D)	坐标
			[optional]

在特定坐标处长按手势后调用。

参数：

地图视图	点按的地图视图。
坐标	点按位置。

- (BOOL) mapView：		(GMSMapView *)	mapView
doTapMarker：		(GMSMarker *)	标记
			[optional]

在用户点按标记后调用。

参数：

地图视图	点按的地图视图。
标记	点按的标记。

返回：

如果该代理处理了点按事件，可以阻止地图执行其默认选择行为，则为“是”；如果地图应继续使用默认选择行为，则为“否”。

- (void) mapView：		(GMSMapView *)	mapView
doTapInfoWindowOfMarker：		(GMSMarker *)	标记
			[optional]

在用户点按标记信息窗口后调用。

- (void) mapView：		(GMSMapView *)	mapView
doLongPressInfoWindowOfMarker：		(GMSMarker *)	标记
			[optional]

在长按标记的信息窗口后调用。

- (void) mapView：		(GMSMapView *)	mapView
doTapOverlay：		(GMSOverlay *)	重叠式广告
			[optional]

在点按叠加层后调用。

系统不会为点按标记的操作调用此方法。

参数：

地图视图	点按的地图视图。
叠加层	点按的叠加层。

- (void) mapView：		(GMSMapView *)	mapView
doTapPOIWithPlaceID：		(NSString *)	地点 ID
name:		(NSString *)	name
位置：		(CLLocationCoordinate2D)	地理位置
			[optional]

在用户点按某个地图注点后调用。

参数：

地图视图	点按的地图视图。
地点 ID	点按的地图注点的 placeID。
name	点按的 POI 的名称。
位置	点按的地图注点的位置。

-（可为 null 的 UIView *）mapView：		(GMSMapView *)	mapView
markerInfoWindow：		(GMSMarker *)	标记
			[optional]

在标记即将被选择时调用，并在相应方法返回 UIView 时提供可用于该标记的可选自定义信息窗口。

如果您在调用此方法后更改此视图，这些更改不一定会在呈现的版本中显示。

返回的 UIView 在任何维度上的边界都不得超过 500 点。由于一次只能显示一个信息窗口，因此返回的视图可以在其他信息窗口之间重复使用。

在调用期间从地图中移除标记或更改地图所选的标记将导致未定义的行为。

返回：

指定标记的自定义信息窗口，默认为 nil

-（可为 null 的 UIView *）mapView：		(GMSMapView *)	mapView
markerInfoContents：		(GMSMarker *)	标记
			[optional]

在 mapView:markerInfoWindow: 返回 nil 时调用。

如果此方法返回视图，它会置于默认信息窗口框架内。如果此方法返回 nil，则使用默认呈现。

参数：

地图视图	按下的地图视图。
标记	已按下的标记。

返回：

要在信息窗口中显示为内容的自定义视图，或者为 nil 以使用默认内容呈现功能

- (void) mapView：		(GMSMapView *)	mapView
doCloseInfoWindowOfMarker：		(GMSMarker *)	标记
			[optional]

在标记的信息窗口关闭时调用。

- (void) mapView：		(GMSMapView *)	mapView
doBeginDraggingMarker：		(GMSMarker *)	标记
			[optional]

在相应标记上启动拖动时调用。

- (void) mapView：		(GMSMapView *)	mapView
doEndDraggingMarker：		(GMSMarker *)	标记
			[optional]

在标记拖动完毕后调用。

- (void) mapView：		(GMSMapView *)	mapView
doDragMarker：		(GMSMarker *)	标记
			[optional]

在拖动标记时调用。

- (BOOL) didTapMyLocationButtonForMapView：

(GMSMapView *)

mapView

[optional]

在用户点按“我的位置”按钮时调用。

返回：

如果监听器已处理事件（即不应发生默认行为），则为“YES”（否），否则（即应发生默认行为）。默认行为是让摄像头在设备位置移动。

- (void) mapView：		(GMSMapView *)	mapView
doTapMyLocation：		(CLLocationCoordinate2D)	地理位置
			[optional]

当用户点按“我的位置”圆点时调用。

参数：

地图视图	点按的地图视图。
位置	点按位置点时的设备位置。

- (void) mapViewDidStartTileRendering:

(GMSMapView *)

mapView

[optional]

在刚刚请求图块或标签刚刚开始渲染时调用。

- (void) mapViewDidFinishTileRendering:

(GMSMapView *)

mapView

[optional]

当所有图块均已加载（或永久失败）且标签已呈现时调用。

- (void) mapViewSnapshotReady:

(GMSMapView *)

mapView

[optional]

在地图稳定（已加载图块、呈现标签、相机空闲）和叠加层对象呈现时调用。

- (void) mapView：		(GMSMapView *)	mapView
doChangeMapCapabilities：		(GMSMapCapabilitiesFlags)	mapCapabilities
			[optional]

在每次地图功能更改时调用。

参数：

地图视图	更改了 mapCapabilities 的地图视图。
mapCapabilities	这些标记表示当前地图上的功能。