地面オーバーレイ

プラットフォームを選択: Android iOS JavaScript

地面オーバーレイは緯度と経度の座標に紐付いたマップ上のオーバーレイで、マップをドラッグしたりズームしたりすると連動して動きます。

はじめに

地面オーバーレイは、地図に固定されている画像です。マーカーとは異なり、地面オーバーレイは画面ではなく地表面に平行に配置されるため、地図を回転、傾斜、ズームすると画像の向きが変わります。

地面オーバーレイを追加するには、アイコンと境界の両方を定義する GMSGroundOverlay オブジェクトを作成します。どちらかを指定しないと、地面オーバーレイは地図に表示されません。必要に応じて、マップ上の画像の位置に影響を与える追加設定を指定できます。必要なオプションを定義したら、このオブジェクトの map プロパティを設定してオーバーレイを追加します。

オーバーレイを追加する

  1. GMSGroundOverlay オブジェクトの新しいインスタンスを生成します。
  2. icon プロパティを UIImage のインスタンスに設定します。
  3. bounds プロパティを GMSCoordinateBounds のインスタンスに設定します。bounds は、画像の南西と北東の角を表します。
  4. 必要に応じて、bearing や zoomLevel などの省略可能なプロパティを設定します。
  5. map プロパティを設定すると、マップ上に画像が表示されます。

既存の GMSMapView オブジェクトに地面オーバーレイを追加する方法を示したコードの例を次に示します。

Swift

let southWest = CLLocationCoordinate2D(latitude: 40.712216, longitude: -74.22655)
let northEast = CLLocationCoordinate2D(latitude: 40.773941, longitude: -74.12544)
let overlayBounds = GMSCoordinateBounds(coordinate: southWest, coordinate: northEast)

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
let icon = UIImage(named: "newark_nj_1922")

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

Objective-C

CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655);
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544);
GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest
                                                                        coordinate:northEast];

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
UIImage *icon = [UIImage imageNamed:@"newark_nj_1922"];
GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

オーバーレイの削除

地面オーバーレイをマップから削除するには、GMSGroundOverlay の map プロパティを nil に設定します。または、GMSMapView clear メソッドを呼び出すと、現在マップ上にあるすべてのオーバーレイ（地面オーバーレイを含む）を除去できます。

Swift

mapView.clear()

Objective-C

[mapView clear];

地図に追加した後で地面オーバーレイを変更する場合は、GMSGroundOverlay オブジェクトを保持しておきます。このオブジェクトを変更することで、後から地面オーバーレイを変更できます。

Swift

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

// ...

overlay.isTappable = true

Objective-C

GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

// ...
overlay.tappable = YES;

イベント

マップで発生するイベントは、リッスンすることができます。イベントは、たとえばユーザーがオーバーレイをタップすることなどで発生します。イベントをリッスンするには、GMSMapViewDelegate プロトコルを実装する必要があります。イベントのガイドと GMSMapViewDelegate のメソッドの一覧をご覧ください。