情報ウィンドウでは、マーカーをタップしたユーザーに情報を表示できます。
情報ウィンドウは、関連付けられているマーカーを中心としてその真上に、デバイス画面の左右に広がるように描画されます。デフォルトの情報ウィンドウでは、タイトルが太字で表示され、スニペット テキストがタイトルの下に表示されます。
情報ウィンドウのコンテンツは、マーカーの title プロパティと snippet プロパティによって定義されます。title プロパティと snippet プロパティの両方が空白または nil の場合、マーカーをクリックしても情報ウィンドウが表示されません。
情報ウィンドウは一度に 1 つのみ表示されます。ユーザーが別のマーカーをタップすると、現在のウィンドウが非表示になり、新しいウィンドウが開きます。情報ウィンドウが表示されているマーカーをユーザーがクリックすると、その情報ウィンドウが閉じて再度開きます。
テキストや画像を追加するカスタム情報ウィンドウを作成します。カスタム情報ウィンドウでは、ポップアップの外観を詳細に制御できます。
情報ウィンドウを追加する
次のスニペットは、情報ウィンドウのテキストのタイトルのみを含む単純なマーカーを作成します。
Swift
let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
let london = GMSMarker(position: position)
london.title = "London"
london.map = mapView
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127);
GMSMarker *london = [GMSMarker markerWithPosition:position];
london.title = @"London";
london.map = mapView;
snippet プロパティを使用すると、タイトルの下に小さなフォントでテキストをさらに追加できます。情報ウィンドウの幅より長い文字列は、複数行に自動的にラップされます。非常に長いメッセージは切り捨てられる可能性があります。
Swift
london.title = "London"
london.snippet = "Population: 8,174,100"
london.map = mapView
Objective-C
london.title = @"London";
london.snippet = @"Population: 8,174,100";
london.map = mapView;
情報ウィンドウを表示または非表示にする
情報ウィンドウは、マーカー上でのユーザー タッチ イベントに応答するように設計されています。情報ウィンドウを表示または非表示にするには、GMSMapView の selectedMarker プロパティを設定します。
- 表示するマーカーの名前を
selectedMarkerに設定します。 - 非表示にするには、
selectedMarkerをnilに設定します。
Swift
london.title = "London"
london.snippet = "Population: 8,174,100"
london.map = mapView
// Show marker
mapView.selectedMarker = london
// Hide marker
mapView.selectedMarker = nil
Objective-C
london.title = @"London";
london.snippet = @"Population: 8,174,100";
london.map = mapView;
// Show marker
mapView.selectedMarker = london;
// Hide marker
mapView.selectedMarker = nil;
自動的に更新される情報ウィンドウの設定
情報ウィンドウが非表示になってから再度表示されるのを待つのではなく、マーカーの新しい tracksInfoWindowChanges を YES または true に設定すると、情報ウィンドウまたはコンテンツが変更されたときにすぐに表示されます。デフォルトは NO または false です。
Swift
london.tracksInfoWindowChanges = true
Objective-C
london.tracksInfoWindowChanges = YES;
tracksInfoWindowChanges プロパティを設定するタイミングを判断するには、情報ウィンドウが自動的に再描画されるメリットとパフォーマンスに関する考慮事項を比較する必要があります。例:
- 一連の変更を行う必要がある場合は、プロパティを
YESに変更し、NOに戻すことができます。 - アニメーションの実行中に、またはコンテンツが非同期で読み込まれる場合は、アクションが完了するまでプロパティを
YESに設定したままにする必要があります。
マーカーの iconView プロパティを使用する際は、考慮事項もご覧ください。
情報ウィンドウの位置を変更する
情報ウィンドウは、関連付けられているマーカーを中心としてその真上に、デバイス画面の左右に広がるように描画されます。マーカーに対する情報ウィンドウの位置は、infoWindowAnchor プロパティを設定することで変更できます。このプロパティは CGPoint（x、y）オフセットで定義され、x と y の範囲は 0.0 ～ 1.0 です。デフォルトのオフセットは（0.5、0.0）、つまり中央上です。infoWindowAnchor オフセットを設定すると、情報ウィンドウをカスタム アイコンに合わせることができます。
Swift
london.infoWindowAnchor = CGPoint(x: 0.5, y: 0.5)
london.icon = UIImage(named: "house")
london.map = mapView
Objective-C
london.infoWindowAnchor = CGPointMake(0.5, 0.5);
london.icon = [UIImage imageNamed:@"house"];
london.map = mapView;
情報ウィンドウでイベントを処理する
以下の情報ウィンドウ イベントをリッスンできます。
mapView:markerInfoWindow:- マーカーが選択される直前に呼び出されます。必要に応じて、マーカーに使用するカスタム情報ウィンドウをUIViewとして返すことができます。詳しくは、以下のカスタム 情報ウィンドウをご覧ください。mapView:markerInfoContents:-mapView:markerInfoWindowが nil を返した場合に呼び出されます。mapView:didCloseInfoWindowOfMarker:- マーカーの情報ウィンドウを閉じると呼び出されます。mapView:didLongPressInfoWindowOfMarker:- マーカーの情報ウィンドウが長押しされた後で呼び出されます。
イベントをリッスンするには、GMSMapViewDelegate プロトコルを実装する必要があります。イベントガイドと GMSMapViewDelegate のメソッドのリストをご覧ください。
GitHub には、情報ウィンドウのイベントを処理する方法を示すサンプルが含まれています。
カスタム情報ウィンドウ
カスタム情報ウィンドウのレイアウトを定義する UIView のサブクラスを作成して、情報ウィンドウのコンテンツをカスタマイズします。このサブクラスで、ビューを任意に定義します。たとえば、カスタム UILabel インスタンスを使用して、タイトルやスニペット テキストなどのビュー（UIImageView インスタンスなど）を表示し、情報ウィンドウに表示する画像を追加できます。
ViewController が GMSIndoorDisplayDelegate プロトコルを実装し、mapView:markerInfoWindow: イベントのリスナーを定義していることを確認します。このイベント リスナーは、マーカーが選択しようとしているときに呼び出されます。これにより、カスタムの UIView クラスのインスタンスを返して、マーカーで使用されるカスタム情報ウィンドウを定義できます。
デフォルトの情報ウィンドウ、カスタマイズされたコンテンツを表示している情報ウィンドウ、フレームと背景がカスタマイズされている情報ウィンドウの画像を、以下に示します。
Maps SDK for iOS に付属している GitHub のコードサンプルには、カスタム情報ウィンドウのサンプルが含まれています。たとえば、MarkerInfoWindowViewController.m （Objective-C）または MarkerInfoWindowViewController.swift（Swift）の定義をご覧ください。
これらのサンプルのダウンロードと実行については、コードサンプルをご覧ください。