- @interface MKMapView : UIView <NSCoding>
-
- @property (nonatomic, assign) id <MKMapViewDelegate> delegate;
-
- @property (nonatomic) MKMapType mapType;
-
- @property (nonatomic) MKCoordinateRegion region;
- - (void)setRegion:(MKCoordinateRegion)region animated:(BOOL)animated;
-
- @property (nonatomic) CLLocationCoordinate2D centerCoordinate;
- - (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;
-
- - (MKCoordinateRegion)regionThatFits:(MKCoordinateRegion)region;
-
- @property (nonatomic) MKMapRect visibleMapRect;
- - (void)setVisibleMapRect:(MKMapRect)mapRect animated:(BOOL)animate;
-
- - (MKMapRect)mapRectThatFits:(MKMapRect)mapRect;
-
- - (void)setVisibleMapRect:(MKMapRect)mapRect edgePadding:(UIEdgeInsets)insets animated:(BOOL)animate;
- - (MKMapRect)mapRectThatFits:(MKMapRect)mapRect edgePadding:(UIEdgeInsets)insets;
-
- - (CGPoint)convertCoordinate:(CLLocationCoordinate2D)coordinate toPointToView:(UIView *)view;
- - (CLLocationCoordinate2D)convertPoint:(CGPoint)point toCoordinateFromView:(UIView *)view;
- - (CGRect)convertRegion:(MKCoordinateRegion)region toRectToView:(UIView *)view;
- - (MKCoordinateRegion)convertRect:(CGRect)rect toRegionFromView:(UIView *)view;
-
- @property(nonatomic, getter=isZoomEnabled) BOOL zoomEnabled;
- @property(nonatomic, getter=isScrollEnabled) BOOL scrollEnabled;
-
- @property (nonatomic) BOOL showsUserLocation;
-
- @property (nonatomic, readonly) MKUserLocation *userLocation;
-
-
- @property (nonatomic) MKUserTrackingMode userTrackingMode NS_AVAILABLE(NA, 5_0);
- - (void)setUserTrackingMode:(MKUserTrackingMode)mode animated:(BOOL)animated NS_AVAILABLE(NA, 5_0);
-
- @property (nonatomic, readonly, getter=isUserLocationVisible) BOOL userLocationVisible;
-
- - (void)addAnnotation:(id <MKAnnotation>)annotation;
- - (void)addAnnotations:(NSArray *)annotations;
-
- - (void)removeAnnotation:(id <MKAnnotation>)annotation;
- - (void)removeAnnotations:(NSArray *)annotations;
-
- @property (nonatomic, readonly) NSArray *annotations;
- - (NSSet *)annotationsInMapRect:(MKMapRect)mapRect NS_AVAILABLE(NA, 4_2);
-
- - (MKAnnotationView *)viewForAnnotation:(id <MKAnnotation>)annotation;
-
- - (MKAnnotationView *)dequeueReusableAnnotationViewWithIdentifier:(NSString *)identifier;
-
- - (void)selectAnnotation:(id <MKAnnotation>)annotation animated:(BOOL)animated;
- - (void)deselectAnnotation:(id <MKAnnotation>)annotation animated:(BOOL)animated;
- @property (nonatomic, copy) NSArray *selectedAnnotations;
-
- @property (nonatomic, readonly) CGRect annotationVisibleRect;
-
- @end
- @protocol MKMapViewDelegate <NSObject>
- @optional
-
- - (void)mapView:(MKMapView *)mapView regionWillChangeAnimated:(BOOL)animated;
- - (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated;
-
- - (void)mapViewWillStartLoadingMap:(MKMapView *)mapView;
- - (void)mapViewDidFinishLoadingMap:(MKMapView *)mapView;
- - (void)mapViewDidFailLoadingMap:(MKMapView *)mapView withError:(NSError *)error;
-
- - (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id <MKAnnotation>)annotation;
-
- - (void)mapView:(MKMapView *)mapView didAddAnnotationViews:(NSArray *)views;
-
- - (void)mapView:(MKMapView *)mapView annotationView:(MKAnnotationView *)view calloutAccessoryControlTapped:(UIControl *)control;
-
- - (void)mapView:(MKMapView *)mapView didSelectAnnotationView:(MKAnnotationView *)view NS_AVAILABLE(NA, 4_0);
- - (void)mapView:(MKMapView *)mapView didDeselectAnnotationView:(MKAnnotationView *)view NS_AVAILABLE(NA, 4_0);
-
- - (void)mapViewWillStartLocatingUser:(MKMapView *)mapView NS_AVAILABLE(NA, 4_0);
-
- - (void)mapViewDidStopLocatingUser:(MKMapView *)mapView NS_AVAILABLE(NA, 4_0);
-
- - (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation NS_AVAILABLE(NA, 4_0);
-
- - (void)mapView:(MKMapView *)mapView didFailToLocateUserWithError:(NSError *)error NS_AVAILABLE(NA, 4_0);
-
- - (void)mapView:(MKMapView *)mapView annotationView:(MKAnnotationView *)view didChangeDragState:(MKAnnotationViewDragState)newState
- fromOldState:(MKAnnotationViewDragState)oldState NS_AVAILABLE(NA, 4_0);
-
- - (MKOverlayView *)mapView:(MKMapView *)mapView viewForOverlay:(id <MKOverlay>)overlay NS_AVAILABLE(NA, 4_0);
-
- - (void)mapView:(MKMapView *)mapView didAddOverlayViews:(NSArray *)overlayViews NS_AVAILABLE(NA, 4_0);
-
- - (void)mapView:(MKMapView *)mapView didChangeUserTrackingMode:(MKUserTrackingMode)mode animated:(BOOL)animated NS_AVAILABLE(NA, 5_0);
-
- @end
1. 概述
- 插入MapView,设置Delegate(一般为Controller),Annotations记录兴趣位置点(AnnotationView用来显示兴趣位置点),
- annotation是可选的,选中的annotation会显示callout,用来显示信息。
2. 设置地图显示类型:
- mapView.mapType = MKMapTypeStandard;
- mapView.mapType = MKMapTypeSatellite;
- mapView.mapType = MKMapTypeHybrid;
3. 显示用户位置
- 设置为可以显示用户位置:
- mapView.showsUserLocation = YES;
- 判断用户当前位置是否可见(只读属性):
- userLocationVisible
- 得到用户位置坐标:当userLocationVisible为YES时
- CLLocationCoordinate2D coords = mapView.userLocation.location.coordinate;
4.坐标范围
- MKCoordinateRegion用来设置坐标显示范围。包括两部分:
-
- a. Center(CLLocationCoordinate2D struct,包括latitude和longitude),坐标中心
- b. Span(MKCoordinateSpan struct,包括latitudeDelta和longitudeDelta),缩放级别
-
- //创建一个以center为中心,上下各1000米,左右各1000米得区域,但其是一个矩形,不符合MapView的横纵比例
- MKCoordinateRegion viewRegion = MKCoordinateRegionMakeWithDistance(center,2000, 2000);
-
- //以上代码创建出来一个符合MapView横纵比例的区域
- MKCoordinateRegion adjustedRegion = [mapView regionThatFits:viewRegion];
-
- //以上代码为:最终显示该区域
- [mapView setRegion:adjustedRegion animated:YES];
5. delegate
- 使用MapView须符合MKMapViewDelegate协议
- 5.1、地图加载Delegate
-
- 当需要从Google服务器取得新地图时
- mapViewWillStartLoadingMap:
- 当成功地取得地图后
- mapViewDidFinishLoadingMap:
- 当取得地图失败后(建议至少要实现此方法)
- mapViewDidFailLoadingMap:withError:
-
- 5.2、范围变化Delegate
-
- 当手势开始(拖拽,放大,缩小,双击)
- mapView:regionWillChangeAnimated:
- 当手势结束(拖拽,放大,缩小,双击)
- mapView:regionDidChangeAnimated:
- 判断坐标是否在MapView显示范围内:
- CLLocationDegrees leftDegrees = mapView.region.center.longitude –(mapView.region.span.longitudeDelta / 2.0);
- CLLocationDegrees rightDegrees = mapView.region.center.longitude +(mapView.region.span.longitudeDelta / 2.0);
- CLLocationDegrees bottomDegrees = mapView.region.center.latitude –(mapView.region.span.latitudeDelta / 2.0);
- CLLocationDegrees topDegrees = self.region.center.latitude +(mapView.region.span.latitudeDelta / 2.0);
-
- if (leftDegrees > rightDegrees)
- { // Int‘l Date Line in View
- leftDegrees = -180.0 - leftDegrees;
- if (coords.longitude > 0) // coords to West of Date Line
- coords.longitude = -180.0 - coords.longitude;
- }
-
- if (leftDegrees <= coords.longitude
- && coords.longitude <= rightDegrees
- && bottomDegrees <= coords.latitude
- && coords.latitude <= topDegrees)
- {
- // 坐标在范围内
- }
6.Annotation
- Annotation包含两部分:Annotation Object和Annotation View
- Annotation Object必须符合协议MKAnnotation,包括两个方法:title和subtitle,分别用于显示注释的标题和子标题。还有coordinate属性,返回CLLocationCoordinate2D,表示Annotation的位置
- 然后,需使用mapView:viewForAnnotation: 方法来返回MKAnnotationView或者MKAnnotationView的子类用来显示Annotation(注意:这里显示的不是选中Annotation后的弹出框)
- 你可以子类化MKAnnotationView,然后再drawRect:方法里面进行自己的绘制动作(这个方法很蠢)
- 你完全可以实例化一个MKAnnotationView,然后更改它的image属性,这样很简单。
7.添加移除Annotation
- 添加一个Annotation
- [mapView addAnnotation:annotation];
- 添加一个Annotation数组
- [mapView addAnnotations:[NSArray arrayWithObjects:annotation1, annotation2, nil]];
- 移除一个Annotation
- removeAnnotation:
- 移除一个Annotation数组
- removeAnnotations:
- 移除所有Annotation
- [mapView removeAnnotations:mapView.annotations];
8. 选中Annotation
- 一次只能有一个Annotation被选中,选中后会出现CallOut(浮动框)
- 简单的CallOut显示Title和SubTitle,但你也可以自定义一个UIView作为CallOut(与自定义的TableViewCell一样)
- 可通过代码选中Annotation:
- selectAnnotation:animated:
- 或者取消选择:
- deselectAnnotation:animated:
9. 显示Annotation
- 通过mapView:viewForAnnotation: 方法显示Annotation,每在MapView中加入一个Annotation,就会调用此方法
- 示例(与tableView:cellForRowAtIndexPath: 很相似)
-
- - (MKAnnotationView *) mapView:(MKMapView *)theMapView viewForAnnotation:(id <MKAnnotation>) annotation
- {
- static NSString *placemarkIdentifier = @"my annotation identifier";
- if ([annotation isKindOfClass:[MyAnnotation class]])
- {
- MKAnnotationView *annotationView = [theMapView dequeueReusableAnnotationViewWithIdentifier:placemarkIdentifier];
- if (annotationView == nil)
- {
- annotationView = [[MKAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:placemarkIdentifier];
- annotationView.image = [UIImage imageNamed:@"blood_orange.png"];
- }
- else
- annotationView.annotation = annotation;
- return annotationView;
- }
- return nil;
- }
10. 取得真实地址
- 示例:
-
- 初始化MKReverseGeocoder
- MKReverseGeocoder *geocoder = [[MKReverseGeocoder alloc] initWithCoordinate:coordinates];
- geocoder.delegate = self;
- [geocoder start];
-
- 如果无法处理坐标,则调用reverseGeocoder:didFailWithError: 方法
- - (void)reverseGeocoder:(MKReverseGeocoder *)geocoder didFailWithError:(NSError *)error
- {
- NSLog(@"Error resolving coordinates: %@", [error localizedDescription]);
- geocoder.delegate = nil;
- [geocoder autorelease];
- }
- 如果成功,则调用reverseGeocoder:didFindPlacemark: 并把信息存储在MKPlacemark 中
- didFindPlacemark:(MKPlacemark *)placemark
- {
- NSString *streetAddress = placemark.thoroughfare;
- NSString *city = placemark.locality;
- NSString *state = placemark.administrativeArea;
- NSString *zip = placemark.postalCode;
- // Do something with information
- geocoder.delegate = nil;
- [geocoder autorelease];
- }
MKMapView和MKMapViewDelegate
原文:http://www.cnblogs.com/zhaoguowen/p/4187403.html