この概要では、Maps SDK for iOS を使って iOS アプリに追加した地図を設定する方法について説明します。
概要
アプリに地図を追加したら、地図の初期設定とランタイム設定を設定できます。地図コンテナの追加について詳しくは、地図を追加するをご覧ください。
地図の初期設定には、以下の設定が含まれます。
- カメラの位置(場所、ズーム、方角、傾斜を含む)。カメラの位置指定について詳しくは、カメラとビューをご覧ください。
- 地図の背景色。
- 地図タイプ。
- 表示する UI コンポーネント(ズームボタンやコンパスなど)。
- 有効にする操作。
実行時に GMSMapView
オブジェクトを更新することで、これらの設定および追加の設定を行うことができます。
地図のオプション
マップビューを初期化するときに、GMSMapViewOptions
で構成オプションを設定します。オプションのプロパティには、frame
、camera
、mapID
、backgroundColor
があります。
地図のオプション | |
---|---|
フレーム | 値:
CGRect 地図フレーム。デフォルトは CGRectZero です。
|
カメラ | 値:
GMSCameraPosition 地図のデフォルトのカメラ位置。
|
mapID | 値:
GMSMapID Google マップ ID。省略可能なパラメータ。
|
backgroundColor | 値:
UIColor デフォルトは UIColor.lightGray です
|
地図のオプションを設定する
独自のオプション プロパティを設定するか、デフォルト値を持つインスタンス化された GMSMapViewOptions
を GMSMapView
に直接渡すことができます。
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 マップ タイルなし。ベース マップ タイルは表示されません。このモードは、タイルレイヤと組み合わせて使用すると便利です。地図タイプが none に設定されている場合、交通状況データの表示は無効になります。 |
地図タイプを変更する
地図のタイプを設定するには、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
)のデフォルトの地図タイルに統合され、ユーザーがズームインすると自動的に有効になり、地図がズームアウトするとフェードアウトします。
GMSMapView
の indoorEnabled
プロパティを NO
に設定すると、インドアマップを無効にできます。
Swift
mapView.isIndoorEnabled = false
Objective-C
mapView.indoorEnabled = NO;
または、階数ピッカー コントロールのみを無効にすることもできます。
構内図の追加
構内図は一部の場所でのみご利用いただけます。 アプリケーションでハイライト表示したい建物の構内図データが利用できない場合は、次の方法を使用できます。
- Google マップに直接構内図を追加できます。これにより、Google マップのすべてのユーザーがプランを利用できるようになります。
- 構内図をグラウンド オーバーレイとして表示する。これにより、アプリケーションのユーザーのみが構内図を表示できます。
交通状況レイヤ
地図上に交通量情報を重ねて表示する機能を、ユーザーに提供することができます。これにより、ユーザーが地域の交通状況を視覚的に把握できるようになります。交通状況レイヤをオンまたはオフにするには、trafficEnabled
メソッドを呼び出します。地図上に表示される交通状況レイヤの例を次に示します。
ユーザー補助
ユーザー補助要素はデフォルトでは地図上に表示されないようになっています。ユーザー補助機能を有効にするには、GMSMapView
の accessibilityElementsHidden
プロパティを NO
に設定します。これにより、オーバーレイ オブジェクト(GMSMarker
、情報ウィンドウ、GMSPolyline
など)のユーザー補助要素が生成されます。
Swift
mapView.accessibilityElementsHidden = false
Objective-C
mapView.accessibilityElementsHidden = NO;
このプロパティは、非公式の UIAccessibility
プロトコルに従いますが、Maps SDK for iOS のデフォルト値は YES
です。
ユーザーのロケーション
デフォルトでは、位置情報は地図に表示されません。GMSMapView
で myLocationEnabled
を設定することで、青い点とコンパスの方向を有効にできます。
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
プロパティを設定します。
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;
地図のカラーパターン
標準タイプと地形タイプの地図では、地図のカラーパターンをダークやライトに設定するか、現在のシステム設定を使用できます。たとえば、デバイスの時間帯や屋内や屋外での使用に応じて、地図のカラーパターンを暗くしたり明るくしたりできます。
GMSMapView
overrideUserInterfaceStyle:
を使って、地図のカラーパターンを設定、更新します。
Swift
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
Objective-C
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;