之前写了一篇关于获取当前位置的文章。现在这篇文章将探讨一下,如何用地图显示地理信息,以及我们怎么自定义地图的Annotation,也就是地图图钉。

接下来的叙述都是为了实现下面的效果:

上图显示的内容包括:

1. 在界面显示一副地图;

2. 在地图上显示一个“笑脸”图标,笑脸所在的位置就是你的当前位置,或者你自己任意设定的地理位置;

3. 点击“笑脸”图标之后,会弹出一个类似标签(Annotation)的东西,标签上有三种内容:左边一副蝙蝠侠的图片,中间文字内容,以及最右边的按钮。

其中2和3都是属于自定义地图Annotation。

下面我们就一步步来实现上图的效果吧。

===显示地图===

第一步:

首先在你的工程的frameworks下面加入Mapkit.framework。至于如何加入一个framework,请参考之前的一篇文章

加入Mapkit.framework之后,在需要用到地图的类的头文件中加入“#import <MapKit/MapKit.h>”。这时候便可以使用所有关于地图的功能了。

显示地图十分简单,只要在xib文件里面,将一个MKMapView拖进容纳这幅地图的View当中即可。这时候进行调试,将出现一个全球的地图。原因是因为你没有给地图一个显示的地理信息,所以初始化的地图只能显示一个全球的范围。

那么下一步便是将地图跳转到你需要显示的地理位置。加入你通过之前文章的阅读,已经获取到了当前位置,保存到checkinLocation(一个CLLocation的指针)当中了。

第二步:

在需要显示地图的View类中定义一个mapView:IBOutlet MKMapView *mapView。并且在xib中将之前拖进来的MKMapView和这个mapView成员变量建立outlets的关系(什么?不懂?那就从头学一下xcode吧)。

在类的实现文件(.m)中加入以下代码(方法名自己起吧,我这里起的是initMapView):

  1. – (void) initMapView {
  2.     MKCoordinateSpan theSpan;
  3.     //设置地图的范围,越小越精确
  4.     theSpan.latitudeDelta = 0.02;
  5.     theSpan.longitudeDelta = 0.02;
  6.     MKCoordinateRegion theRegion;
  7.     theRegion.center = [checkinLocation coordinate]; //让地图跳到之前获取到的当前位置checkinLocation
  8.     theRegion.span = theSpan;
  9.     [mapView setRegion:theRegion];
  10. }

然后,你在显示这个View的时候(比如在viewDidLoad函数中)调用initMapView,地图便可以跳到你要显示的位置了。这里关键的函数是setRegion,已经被MKMapView类封装好了。

至此,你的应用就可以显示地图,并且跳到你设定的任何位置了。是不是特简单?简直简单到我在怀疑我是否有写这篇文章的需要了。不过,废话少说。下面还是来看看如何自定义Annotation吧。

===自定义Annotation===

如果不采取自定义的Annotation,ios默认的是一个图钉的形状,如下图(一个紫色的图钉):

当然,千里执行始于足下,我们还是首先来看看如何在特定的位置显示以上的默认的小图钉吧。

第一步:

先定义一个自己的Annotation的类:

  1. @interface MyMapAnnotation : NSObject<MKAnnotation> {
  2.     CLLocationCoordinate2D location;
  3.     NSString *title;
  4.     NSString *subtitle;
  5.     NSString *headImage;
  6. }
  7. @property CLLocationCoordinate2D location;
  8. @property (nonatomic, copy) NSString *title;
  9. @property (nonatomic, copy) NSString *subtitle;
  10. @property (nonatomic, copy) NSString *headImage;
  11. @end

从上面代码可以看到,MyMapAnnotation类继承于MKAnnotation。里面包含四个成员变量。其中location保存要显示这个Annotation的位置。其他三个变量对应我们之前那个效果图的几点内容:头像、文字内容。

这个类的实现文件(.m)文件很简单,就定义好dealloc和init方法就好,这里不再赘述。

第二步:

在要显示地图的View类中实现MKMapViewDelegate,并实现viewForAnnotation函数,代码如下:

  1. – (MKAnnotationView *)mapView:(MKMapView *)theMapView viewForAnnotation:(id <MKAnnotation>)annotation {
  2.     if ([annotation isKindOfClass:[MKUserLocation class]])
  3.         return nil;
  4.     // 处理我们自定义的Annotation
  5.     if ([annotation isKindOfClass:[MyMapAnnotation class]]) {
  6.         static NSString* travellerAnnotationIdentifier = @”TravellerAnnotationIdentifier”;
  7.         MKPinAnnotationView* pinView = (MKPinAnnotationView *)
  8.         [mapView dequeueReusableAnnotationViewWithIdentifier:travellerAnnotationIdentifier];
  9.         if (!pinView)
  10.         {
  11.             // if an existing pin view was not available, create one
  12.             MKAnnotationView* customPinView = [[[MKAnnotationView alloc]
  13.                                                 initWithAnnotation:annotation reuseIdentifier:travellerAnnotationIdentifier] autorelease];
  14.             customPinView.pinColor = MKPinAnnotationColorPurple;
  15.             customPinView.animatesDrop = YES;  //如果不需要这个从天而降的效果,设置为NO即可。
  16.             customPinView.canShowCallout = NO;
  17.             return customPinView;
  18.         }
  19.         else
  20.         {
  21.             pinView.annotation = annotation;
  22.         }
  23.         return pinView;
  24.     }
  25.     return nil;
  26. }

这段代码将实现默认的一个图钉的效果。

细心地你会发现,上面的代码似乎没有涉及到地理位置,那么地图将怎么知道将这个Annotation放到合适的位置呢?稍安勿躁,稍候将会介绍如何设置Annotation的位置,同时设置Annotation的其他内容(还记得Annotation的定义里面有位置信息,还有几项内容信息吧)。

如果我不喜欢图钉,我想把它换成之前效果图中的笑脸呢?那就把上述代码改成如下:

  1. – (MKAnnotationView *)mapView:(MKMapView *)theMapView viewForAnnotation:(id <MKAnnotation>)annotation {
  2.     if ([annotation isKindOfClass:[MKUserLocation class]])
  3.         return nil;
  4.     if ([annotation isKindOfClass:[TravellerMapAnnotation class]]) {
  5.         static NSString* travellerAnnotationIdentifier = @”TravellerAnnotationIdentifier”;
  6.         MKPinAnnotationView* pinView = (MKPinAnnotationView *)
  7.         [mapView dequeueReusableAnnotationViewWithIdentifier:travellerAnnotationIdentifier];
  8.         if (!pinView)
  9.         {
  10.             // if an existing pin view was not available, create one
  11.             MKAnnotationView* customPinView = [[[MKAnnotationView alloc]
  12.                                                 initWithAnnotation:annotation reuseIdentifier:travellerAnnotationIdentifier] autorelease];
  13.             UIImage *image = [UIImage imageNamed:@”smileFace.png”];
  14.             customPinView.image = image;  //将图钉变成笑脸。
  15.             [image release];
  16.             return customPinView;
  17.         }
  18.         else
  19.         {
  20.             pinView.annotation = annotation;
  21.         }
  22.         return pinView;
  23.     }
  24.     return nil;
  25. }

从上述代码看出,也就是将定义pinColor的代码段去掉,换成设置image的代码:customPinView.image = image.

同样很简单吧。哎,我还有没有写下去的必要呢。(画外音:废话少说!!!)

第三步:

正如之前的疑问,哪里定义Annotation的地理位置以及其他内容呢?不仅仅如此,还有,怎么让用户点击笑脸(或者图钉)之后,弹出一个标签,显示定义好的内容呢。下面我们先看看最后一个问题,怎么让用户点击笑脸(或者图钉)之后,弹出一个标签,显示定义好的内容呢?

还是上面那段代,将它进一步改成:

  1. – (MKAnnotationView *)mapView:(MKMapView *)theMapView viewForAnnotation:(id <MKAnnotation>)annotation {
  2.     if ([annotation isKindOfClass:[MKUserLocation class]])
  3.         return nil;
  4.     if ([annotation isKindOfClass:[TravellerMapAnnotation class]]) {
  5.         // try to dequeue an existing pin view first
  6.         static NSString* travellerAnnotationIdentifier = @”TravellerAnnotationIdentifier”;
  7.         MKPinAnnotationView* pinView = (MKPinAnnotationView *)
  8.         [mapView dequeueReusableAnnotationViewWithIdentifier:travellerAnnotationIdentifier];
  9.         if (!pinView)
  10.         {
  11.             // if an existing pin view was not available, create one
  12.             MKAnnotationView* customPinView = [[[MKAnnotationView alloc]
  13.                                                 initWithAnnotation:annotation reuseIdentifier:travellerAnnotationIdentifier] autorelease];
  14.             customPinView.canShowCallout = YES;  //很重要,运行点击弹出标签
  15.             UIButton* rightButton = [UIButton buttonWithType:UIButtonTypeDetailDisclosure];
  16.             [rightButton addTarget:self
  17.                             action:@selector(showDetails:)  //点击右边的按钮之后,显示另外一个页面
  18.                             forControlEvents:UIControlEventTouchUpInside];
  19.             customPinView.rightCalloutAccessoryView = rightButton;
  20.             MyMapAnnotation *travellerAnnotation = (TravellerMapAnnotation *)annotation;
  21.             UIImageView *headImage = [[UIImageView alloc] initWithImage:[UIImage imageNamed:travellerAnnotation.headImage]];
  22.             customPinView.leftCalloutAccessoryView = headImage; //设置最左边的头像
  23.             [headImage release];
  24.             UIImage *image = [UIImage imageNamed:@”smileFace.png”];
  25.             customPinView.image = image;
  26.             customPinView.opaque = YES;
  27.             [travellerImage release];
  28.             return customPinView;
  29.         }
  30.         else
  31.         {
  32.             pinView.annotation = annotation;
  33.         }
  34.         return pinView;
  35.     }
  36.     return nil;
  37. }

上面的代码很容易理解(加上我的注释之后),有点objective-C以及cocoa基础的朋友都会看懂。如果你看不懂,拜托,我这里不负责扫盲啊。

也许你有个疑问,似乎没见到设置文字信息呀。其实,之前自定义的MyMapAnnotation继承自MKAnnotation,所以只要你给一个MyMapAnnotation对象的title和subtitle填上内容之后,它会自动显示,不需要你手动让它显示。

下面我们就来看看如何添加MyMapAnnotation的内容吧。

其实这也十分简单,就是创建一个新的MyMapAnnotation,然后往里面添加内容即可。比如:

  1. TravellerMapAnnotation *travellerAnnotation = [[TravellerMapAnnotation alloc] init];
  2. travellerAnnotation.location = checkinlocation.coordinate;
  3. travellerAnnotation.title = [travellerNames objectAtIndex:i];
  4. travellerAnnotation.subtitle = [scores objectAtIndex:i];
  5. travellerAnnotation.headImage = [headImages objectAtIndex:i];

现在还残留的一个问题是(这是历史遗留的问题,由于某种原因,我们暂时忽略了它。。。!跑题了吧,大叔。。。):

如何将创建好的一个或者多个甚至成千上万个MyMapAnnotation加入地图并显示它呢。

这个问题更加简单。加入建立了100个MyMapAnnotations,并且全部存进了一个NSArray中,MyMapAnnotationsArray,那么我们需要做的就十分简单了:

mapView addAnnotations:MyMapAnnotationsArray

也就是调用MKMapView的addAnnotations方法将所有创建好的Annotations加进来即可。

至此(真的是至此了),所有的工作都完成了。调试,便可看到一开头展示的那个效果了。(呼,好累)。

基础性的技术文章不好写,写得详细太累人,写得简单怕误导别人,sigh。

Advertisements