iPhoneアプリで位置情報と地図を使うための基礎知識：iOSでジオ（GEO）プログミラング入門（1）（3/3 ページ）

» 2011年04月04日 00時00分公開

[郷田まり子，株式会社鳥人間]

アノテーションを追加するには

　次は、アノテーションを追加してみます。

　表示すべきデータのモデル（Model）と、それを実際に表示するときの見た目（View）は分離されます。モデルを表すのが「MKAnnotation」プロトコル、見た目を実装するのが「MKAnnotationView」クラスです。

　簡単なアノテーションの作成のために、「CustomAnnotation」クラスを追加します。座標とタイトル・サブタイトルを持ったシンプルなクラスで、「MKAnnotation」に定義されているプロパティを備えます。

#import <Foundation/Foundation.h>
#import <MapKit/MapKit.h>
 
@interface CustomAnnotation : NSObject <MKAnnotation> {
    CLLocationCoordinate2D coordinate;  
    NSString *annotationTitle;  
    NSString *annotationSubtitle;
}  
 
@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;  
@property (nonatomic, retain) NSString *annotationTitle;  
@property (nonatomic, retain) NSString *annotationSubtitle;
- (id)initWithLocationCoordinate:(CLLocationCoordinate2D) _coordinate 
    title:(NSString *)_annotationTitle subtitle:(NSString *)_annotationannSubtitle;
- (NSString *)title;
- (NSString *)subtitle;
 
@end

CustomAnnotation.h

#import "CustomAnnotation.h"
 
@implementation CustomAnnotation
@synthesize coordinate;
@synthesize annotationTitle;
@synthesize annotationSubtitle;
 
- (NSString *)title {  
    return annotationTitle;
}
 
- (NSString *)subtitle {  
    return annotationSubtitle;
}
 
- (id)initWithLocationCoordinate:(CLLocationCoordinate2D) _coordinate
    title:(NSString *)_annotationTitle subtitle:(NSString *)_annotationSubtitle {
    coordinate = _coordinate;
    self.annotationTitle = _annotationTitle;
    self.annotationSubtitle = _annotationSubtitle;
    return self;
}
 
- (void) dealloc {
    [annotationTitle release];
    [annotationSubtitle release];
    [super dealloc];
}
 
@end

CustomAnnotation.m

　「MKMapView#adAnnotation」メソッドを使ってアノテーションを追加します。

    [mapView addAnnotation:
        [[[CustomAnnotation alloc]initWithLocationCoordinate:CLLocationCoordinate2DMake(35.685623,139.763153)
            title:@"大手町駅"
            subtitle:@"千代田線・半蔵門線・丸ノ内線・東西線・三田線"]autorelease]];
    [mapView addAnnotation:
        [[[CustomAnnotation alloc]initWithLocationCoordinate:CLLocationCoordinate2DMake(35.690747,139.756866)
            title:@"竹橋駅"
            subtitle:@"東西線"]autorelease]];
    [mapView addAnnotation:
        [[[CustomAnnotation alloc]initWithLocationCoordinate:CLLocationCoordinate2DMake(35.681666,139.764869)
            title:@"東京駅"
            subtitle:@"いっぱい"]autorelease]];

GeoPhotoViewController#viewDidLoad

　動かしてみたところ、ピンをタップすると、タイトルとサブタイトルが表示されるます。

デフォルトの赤いピンをカスタマイズするには

　アノテーションをカスタマイズすることもできます。オリジナルのアノテーションを作るためには、「MKAnnotationView」クラスを拡張します。

　今回は、デフォルトの赤いピンの代わりに、リソースファイルとして追加した画像「flag.png」を表示するという簡単なカスタマイズを行います。

#import <Foundation/Foundation.h>
#import <MapKit/MapKit.h>
 
@interface CustomAnnotationView : MKAnnotationView {
}
 
@end

CustomAnnotationView.h

#import "CustomAnnotationView.h"
@implementation CustomAnnotationView
 
- (id)initWithAnnotation:(id <MKAnnotation>)annotation reuseIdentifier:(NSString *)reuseIdentifier {
    [super initWithAnnotation:annotation reuseIdentifier:reuseIdentifier];
    self.image = [UIImage imageNamed:@"flag.png"];
    return self;
}
 
@end

CustomAnnotationView.m

　「MKMapView」にデリゲート（「MKMapViewDelegate」プロトコルを実装）をセットすると、アノテーションを表示する必要が生じたタイミングで、そのデリゲートの「viewForAnnotation」メソッドが呼ばれます。そこで、「MKAnnotationView」を返せば、地図上に表示されます。「nil」を返せば、デフォルトのビュー（赤いピンと黒い半透明の吹き出し）が表示されます。

　MKAnnotationView（および、そのサブクラス）は、種類ごとに再利用し、「使い回し」する仕組みがあります。「MKMapView#dequeueReusableAnnotationViewWithIdentifier」メソッドを使うと、「その種類のアノテーションビューで、使い回しできるもの」が返されます。

　再利用可能なアノテーションビューがあれば、そのビューを取得し、必要ならばアノテーションの内容に合わせてデータの流し込みなどを行います。再利用可能なアノテーションビューがなければ「nil」が返されるので、そのときだけ、新しいMKAnnotationViewインスタンスを生成する、という使い方をします。

　「UITableView」「UITableViewCell」を使ったことのある方なら、「セルの再利用」で似たような実装をしたことがあるでしょう。

　「GeoPhotoViewController.h」宣言部分に下記の太字部分を追加します。

@interface GeoPhotoViewController : UIViewController <CLLocationManagerDelegate, MKMapViewDelegate> {

　GeoPhotoViewController#viewDidLoadに追加します。

    [mapView setDelegate: self];

　GeoPhotoViewController.mに「viewForAnnotation」メソッドを追加します。

-(MKAnnotationView*)mapView:(MKMapView*)mapView 
viewForAnnotation:(id <MKAnnotation>)annotation {
 
    if (annotation == mapView.userLocation) { //……【2】
        return nil;
    } else {
        CustomAnnotationView *annotationView;
        NSString* identifier = @"flag"; // 再利用時の識別子
 
        // 再利用可能な MKAnnotationView を取得
        annotationView = (CustomAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:identifier];
 
        if(nil == annotationView) {
            //再利用可能な MKAnnotationView がなければ新規作成
            annotationView = [[[CustomAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:identifier] autorelease];
        }
        annotationView.annotation = annotation;
        return annotationView;
    }
}