地図を設定する

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

この概要では、iOS アプリに追加された地図を Maps SDK for iOS を使って設定する方法について説明します。

概要

アプリに地図を追加したら、地図の初期設定オプションとランタイム設定を行います。地図コンテナの追加について詳しくは、地図を追加するをご覧ください。

地図の初期設定には、以下の設定が含まれます。

ランタイムに GMSMapView オブジェクトを更新することで、これらの設定と追加の設定を行うことができます。

地図のオプション

地図表示を初期化するとき、設定オプションは GMSMapViewOptions で設定されます。オプション プロパティには、framecameramapIDbackgroundColor などがあります。

地図のオプション
フレーム
値: CGRect
地図のフレーム。デフォルトは CGRectZero です。
カメラ
値: GMSCameraPosition
地図のデフォルトのカメラ位置。
mapID
値: GMSMapID
Google マップ ID。省略可能なパラメータ。
backgroundColor
値: UIColor
デフォルトは UIColor.lightGray

地図のオプションを設定する

独自のオプション プロパティを設定するか、デフォルト値を持つインスタンス化された GMSMapViewOptionsGMSMapView に直接渡すことができます。

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

デフォルト値を含む GMSMapViewOptions オブジェクトを GMSMapView に直接渡す例を次に示します。

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

背景色を設定する

ダークモードで作業する場合や、地図ビューを切り替える場合は、地図のデフォルトの背景色をオーバーライドすることをおすすめします。そのためには、地図オプションの backgroundColor プロパティを設定します。

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

地図タイプ

地図は各種マップ タイプのいずれかを使用してカスタマイズできます。地図のタイプによって、地図の全体的な表現を管理します。たとえば、通常、アトラスには境界線の表示に重点を置いた政治地図や、特定の都市や地域のすべての道路を示す道路地図が含まれています。Maps SDK for iOS では、次のタイプの地図を使用できます。

地図の種類
標準
値: kGMSTypeNormal
通常の道路地図。道路、一部の人工の対象物、川などの重要な自然対象物を表示します。道路と対象物のラベルも表示されます。
ハイブリッド
値: kGMSTypeHybrid
航空写真データに道路地図を加えたもの。道路と対象物のラベルも表示されます。
衛星
値: kGMSTypeSatellite
航空写真データ。道路と対象物のラベルは表示されません。
地形
値: kGMSTypeTerrain
地勢データ。マップには、色、等高線とラベル、遠近陰影が含まれます。一部の道路とラベルも表示されます。
なし
値: kGMSTypeNone
マップ タイルなし。ベース マップ タイルは表示されません。このモードは、タイルレイヤと組み合わせて使用すると便利です。マップタイプが [なし] に設定されている場合、交通データの表示は無効になります。

地図タイプの変更

地図のタイプを設定するには、GMSMapView.mapType プロパティに新しい値を割り当てます。たとえば、航空写真マップタイプを表示するには、次のようにします。

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

以下の選択ツールには、同じ場所の地形、標準、地図+写真の比較が表示されます。

インドアマップ

Maps SDK for iOS では、ズームレベルが高い場合、空港、ショッピング モール、大規模小売店、駅などの屋内空間の構内図が表示されます。屋内構内図は「標準」マップタイプ(kGMSTypeNormal)のデフォルトの地図タイルに統合され、ユーザーがズームインすると自動的に有効になり、地図がズームアウトするとフェードアウトします。

インドアマップを無効にするには、GMSMapViewindoorEnabled プロパティを NO に設定します。

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

または、階数選択ツール コントロールのみを無効にすることもできます。

構内図を追加する

構内図は一部の地域でご利用いただけます。アプリでハイライト表示する建物の構内図データがない場合は、次のようにします。

  • Google マップに直接構内図を追加できます。これにより、Google マップのすべてのユーザーがプランを利用できるようになります。
  • 構内図をグラウンド オーバーレイとして表示する。これにより、アプリケーションのユーザーのみが構内図を表示できるようになります。

交通状況レイヤ

地図上に交通量情報を重ねて表示する機能を、ユーザーに提供することができます。これにより、ユーザーが地域の交通状況を視覚的に把握できるようになります。交通状況レイヤのオンとオフを切り替えるには、trafficEnabled メソッドを呼び出します。地図上に表示される交通状況レイヤの例を次に示します。

交通状況レイヤを示す Google マップ

ユーザー補助

ユーザー補助要素はデフォルトでは地図上に表示されないようになっています。ユーザー補助を有効にするには、GMSMapViewaccessibilityElementsHidden プロパティを NO に設定します。これにより、オーバーレイ オブジェクト(GMSMarker、情報ウィンドウ、GMSPolyline など)のユーザー補助要素が生成されます。

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

このプロパティは、非公式の UIAccessibility プロトコルに従います。ただし、Maps SDK for iOS のデフォルト値は YES です。

ユーザーのロケーション

デフォルトでは、位置情報は地図に表示されません。GMSMapViewmyLocationEnabled を設定すると、「現在地」を示す青い点とコンパスの方向を有効にできます。

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

この機能を有効にすると、myLocation プロパティを通じてユーザーの現在地を取得できます。たとえば、ユーザーが iOS からこのデータへのアクセスを許可するよう求められた場合、このプロパティはすぐに利用できないことがあります。この場合は nil です。

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

建物の 3D 表示

多くの都市は、拡大して見ると 3D の建物が表示されます。下の図は、ワシントン州シアトルの画像です。

ワシントン州シアトルの建物の 3D 地図。

次のように、Swift または Objective-C で対応する GMSMapView プロパティを設定することで、建物の 3D 表示を無効にできます。

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

地図のパディング

Google マップは、GMSMapView で定義された領域全体に表示されるように設計されています。地図の表示と動作のいくつかは、ビューのディメンションによって定義されます。

  • カメラのターゲットは、パディングされた領域の中心を反映します。
  • 地図のコントロールは、地図の端を基準として配置されます。
  • 著作権に関する通知や Google ロゴなどの法的情報は、地図の下端に沿って表示されます。

地図の周囲にパディングを追加するには、GMSMapView.padding プロパティ。地図は引き続きコンテナ全体に表示されますが、テキストとコントロールの位置、地図操作、カメラの移動は、小さなスペースに配置されているかのように動作します。これにより、次の変更が行われます。

  • API 呼び出しやボタンの押下(コンパス、現在地など)を使用したカメラの移動は、パディングされた領域を基準として行われます。
  • GMSMapView.projection は、パディングされた領域のみを含む投影を返します。
  • UI コントロールは、コンテナの端から指定したポイント数だけオフセットされます。

パディングは、地図の一部に重ねて表示される UI を設計する際に便利です。たとえば、この画像では、地図の上部と右側にパディングが追加されています。地図のコントロールと法的テキストは、パディングされた領域(緑色で表示)の端に沿って表示されますが、地図は引き続きコンテナ全体(青色で表示)に表示されます。この例では、地図のコントロールを隠すことなく、メニューを地図の右側にフローティングできます。

地図のパディング

地図にパディングを追加するには、UIEdgeInsets オブジェクトを作成して GMSMapView に渡します。padding プロパティ。

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;