Public Member Functions

<BMMapViewDelegate> Protocol Reference

The BMMapViewDelegate protocol methods can notify you of changes related to the map. More...

#import <BMMapView.h>

List of all members.

Public Member Functions

(void) - mapView:regionWillChangeAnimated:
 Called just before the map view region is about to change.
(void) - mapView:regionDidChangeAnimated:
 Called just after the map view region changed.
(void) - mapViewWillStartLoadingMap:
 Called just before the map view makes requests to get map data.
(void) - mapViewDidFinishLoadingMap:
 Called just after the map view finishes getting map data.
(void) - mapViewDidFailLoadingMap:withError:
 Called when the map view encountered an error while trying to get map data.
(BMMarkerView *) - mapView:viewForMarker:
 Returns the view of the given marker object.
(void) - mapView:didAddMarkerViews:
 Called after the marker views have been added and positioned on the map.
(void) - mapView:markerView:calloutAccessoryControlTapped:
 Called when the user taps on left and right callout accessory UIControls.

Detailed Description

The BMMapViewDelegate protocol methods can notify you of changes related to the map.

BMMapViewDelegate The BMMapViewDelegate methods are called when map tiles are being loaded, if the map view changes, and also after certain marker events.


Member Function Documentation

- (void) mapView: (BMMapView *)  mapView
didAddMarkerViews: (NSArray *)  views 
[optional]

Called after the marker views have been added and positioned on the map.

Parameters:
mapViewThe map view.
viewsAn array containing marker views that were added. The delegate can implement this method to animate the adding of the markers' views. Use the current positions of the marker views as the destinations of the animation.
- (void) mapView: (BMMapView *)  mapView
markerView: (BMMarkerView *)  view
calloutAccessoryControlTapped: (UIControl *)  control 
[optional]

Called when the user taps on left and right callout accessory UIControls.

Parameters:
mapViewThe map view.
viewMarker view that was tapped.
controlThe control that was tapped.
- (void) mapView: (BMMapView *)  mapView
regionDidChangeAnimated: (BOOL)  animated 
[optional]

Called just after the map view region changed.

Parameters:
mapViewThe map view.
animatedIndicates whether the change was animated.
- (void) mapView: (BMMapView *)  mapView
regionWillChangeAnimated: (BOOL)  animated 
[optional]

Called just before the map view region is about to change.

Parameters:
mapViewThe map view.
animatedInidicates whether the map view change is animated.
- (BMMarkerView *) mapView: (BMMapView *)  mapView
viewForMarker: (id< BMMarker >)  marker 
[optional]

Returns the view of the given marker object.

Parameters:
mapViewThe map view.
markerThe marker.
Returns:
The view of the given marker object.
- (void) mapViewDidFailLoadingMap: (BMMapView *)  mapView
withError: (NSError *)  error 
[optional]

Called when the map view encountered an error while trying to get map data.

Parameters:
mapViewThe map view.
errorThe error.

Use this method if you want to notify users that map data is unavailable. This method is called when there is no network connection or if other errors occurred while trying to retrieve map data.

- (void) mapViewDidFinishLoadingMap: (BMMapView *)  mapView [optional]

Called just after the map view finishes getting map data.

Parameters:
mapViewThe map view.

This method is called after map tiles are downloaded from the server. For example, when panning and zooming, new map data is retrieved from the server to display the new region.

- (void) mapViewWillStartLoadingMap: (BMMapView *)  mapView [optional]

Called just before the map view makes requests to get map data.

Parameters:
mapViewThe map view.

The documentation for this protocol was generated from the following file: