地図を設定する

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

概要

アプリに地図を追加したら、地図の初期オプションと実行時の設定を行うことができます。地図コンテナの追加について詳しくは、地図を追加するをご覧ください。

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

• カメラの位置（場所、ズーム、方角、傾斜を含む）。カメラの位置指定について詳しくは、カメラとビューをご覧ください。
• 地図の背景色。
• 地図タイプ。
• 表示する UI コンポーネント（ズームボタンやコンパスなど）。
• 有効にする操作。

実行時に、GMSMapView オブジェクトを更新して、これらの設定および追加の設定を行うことができます。

地図のオプション

マップビューを初期化するときに、構成オプションは GMSMapViewOptions で設定されます。オプション プロパティには、frame、camera、mapID、backgroundColor があります。

地図のオプションを構成する

独自のオプション プロパティを設定するか、インスタンス化された GMSMapViewOptions をデフォルト値とともに GMSMapView に直接渡します。

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

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

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

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

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

背景色を設定

ダークモードで作業する場合や、地図表示を切り替える場合は、デフォルトの地図の背景色をオーバーライドすると便利です。これは、地図オプションの backgroundColor プロパティを設定することで実現できます。

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

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

地図タイプ

地図は各種マップ タイプのいずれかを使用してカスタマイズできます。地図の全体的な表示方法は、その地図のタイプによって決まります。たとえば、地図帳には通常、境界を示すことに焦点を置いた政治的な地図が含まれていますし、道路地図には、ある都市や地域のすべての道路が示されています。Maps SDK for iOS では、次の種類の地図が用意されています。

地図タイプを変更する

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

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

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）のマップタイルに統合されています。これは、ユーザーがズームインすると自動的に有効になり、マップがズームアウトされると徐々に非表示になります。

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

mapView.isIndoorEnabled = false
      

mapView.indoorEnabled = NO;
      

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

構内図を追加する

構内図は、一部の地域でのみご利用いただけます。アプリで表示したい建物の構内図データを使用できない場合は、以下の方法を使用します。

• Google マップに直接構内図を追加します。この場合、Google マップのユーザー全員が、その構内図を使用できるようになります。
• 構内図をグラウンド オーバーレイとして表示する。この方法では、アプリのユーザーにのみ構内図が表示されるようになります。

交通状況レイヤ

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

ユーザー補助

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

mapView.accessibilityElementsHidden = false
      

mapView.accessibilityElementsHidden = NO;
      

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

現在地

デフォルトでは、マップに位置データは表示されていません。GMSMapView で myLocationEnabled を設定すると、「現在地」を示す青い点とコンパスの方向を有効にすることができます。

mapView.isMyLocationEnabled = true
      

mapView.myLocationEnabled = YES;
      

この機能を有効にすると、myLocation プロパティからユーザーの現在の位置情報を取得できます。iOS がこのデータへのアクセス許可をユーザーに求める場合など、このプロパティが即座に有効とならないことがあります。この場合は nil です。

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

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

建物の 3D 表示

多くの都市は、拡大表示していくと 3D の建物が表示されます。ワシントン州シアトルの画像の例を以下に示します。

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

mapView.isBuildingsEnabled = false
      

[mapView setBuildingsEnabled:NO];
      

地図のパディング

Google マップは、GMSMapView で定義された領域全体に表示されるように設計されています。マップの表示と動作には、ビューの寸法によって定義される部分もあります。

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

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

• API 呼び出しやボタンのタップ（コンパス、現在地など）によるカメラの移動は、パディングが追加された領域に対して相対的に行われます。
• GMSMapView.projection は、パディングされた領域のみを反映した結果を返します。
• UI コントロールは、コンテナの端から、指定されたポイント分のスペースを空けて表示されます。

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

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

// 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
      

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

地図のカラーパターン

標準地図と地形地図の場合、地図のカラーパターンをダークまたはライトになるよう設定するか、システム設定を使用するように設定することができます。たとえば、時間帯や屋内 / 屋外でのデバイスの使用に基づいて、地図のカラーパターンをダークにしたりライトにしたりできます。

GMSMapView overrideUserInterfaceStyle: を使用して、地図の配色を設定および更新します。

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;