GMSMapView クラス リファレンス


概要

これは Google Maps SDK for iOS のメインクラスで、地図に関連するすべてのメソッドのエントリ ポイントです。

地図は、-init または -initWithOptions: のいずれかのコンストラクタを使用してインスタンス化する必要があります。

GMSMapView は、すべての UIKit オブジェクトと同様に、メインスレッドからのみ読み取りおよび変更できます。別のスレッドからこれらのメソッドを呼び出すと、例外または未定義の動作が発生します。

パブリック メンバーの関数

(instancetype)- init
 CGRectZero とデフォルトのオプションで初期化します。
(instancetype)- initWithOptions:
 指定されたオプションで新しいマップビューを作成します。
(instancetype)- initWithFrame:
(null 値許容の instancetype)- initWithCoder:
(instancetype)- initWithFrame:camera:
 フレームとカメラ ターゲットを含むマップビューをビルドして返します。
(instancetype)- initWithFrame:mapID:camera:
 フレーム、マップ ID、カメラ ターゲットを含むマップビューをビルドして返します。
(void) - startRendering
 この地図にレンダラを起動するように指示します。
(void) - stopRendering(レンダリングを停止)
 レンダラの電源を切るようこのマップに指示します。
(void) - クリア
 地図に追加されたすべてのマークアップ(マーカー、ポリライン、地面オーバーレイを含む)を消去します。
(void) - setMinZoom:maxZoom:
 minZoommaxZoom を設定します。
(null 値許容の GMSCameraPosition *)- cameraForBounds:insets:
 paddingbounds を表示する GMSCameraPosition を作成します。
(void) - moveCamera:
 update に応じてカメラを変更します。
(BOOL)- areEqualForRenderingPosition:position:
 内部で使用される精度と変換のレベルを考慮して、指定されたカメラ位置によってカメラが実質的に同じレンダリングされるかどうかを確認します。
GMSFeatureLayer
<GMSPlaceFeature * >*)
- featureLayerOfFeatureType:
 指定されたタイプの対象物レイヤを返します。
GMSDatasetFeatureLayer *)- datasetFeatureLayerOfDatasetID:
 指定されたデータセットのデータセット対象物レイヤを返します。
(void) - animateToCameraPosition:
 この地図のカメラを cameraPosition にアニメーション化します。
(void) - animateToLocation:
 AnimationToCameraPosition: のように、カメラの位置のみを変更します(現在の位置から location に変更)。
(void) - animateToZoom:
 AnimationToCameraPosition: ですが、カメラのズームレベルのみを変更します。
(void) - animateToBearing:
 AnimationToCameraPosition: ですが、カメラの bearing のみ(度数)を変更します。
(void) - animateToViewingAngle:
 AnimationToCameraPosition: として、カメラの傾斜角(度数)のみを変更します。
(void) - animateWithCameraUpdate:
 cameraUpdate を現在のカメラに適用し、activateToCameraPosition: に従って結果を使用します。

静的パブリック メンバー関数

(instancetype)+ mapWithFrame:camera:
 フレームとカメラ ターゲットを含むマップビューをビルドして返します。
(instancetype)+ mapWithFrame:mapID:camera:
 フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返すコンビニエンス イニシャライザ。

プロパティ

IBOutlet ID<GMSMapViewDelegate >委任
 GMSMapView デリゲート。
GMSCameraPosition *カメラ
 カメラを制御し、地図の向きを定義します。
GMSProjection *projection
 画面の座標と緯度と経度の座標間の変換に使用できる GMSProjection オブジェクトを返します。
BOOL myLocationEnabled
 現在地のドットと精度の円を有効にするかどうかを指定します。
CLLocation *myLocation
 現在地が有効になっている場合、デバイスの位置情報のドットが描画されている場所が表示されます。
GMSMarker *selectedMarker
 選択されたマーカー。
BOOL trafficEnabled
 交通状況データがある場合に、地図に交通状況データを描画するかどうかを制御します。
GMSMapViewTypemapType
 表示する地図タイルの種類を制御します。
GMSMapStyle *mapStyle
 地図のスタイルを制御します。
UIUserInterfaceStyleoverrideUserInterfaceStyle
 地図を目的の [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc)に変更します。
浮動小数点数minZoom
 最小ズーム(カメラから最も遠いものがズームアウトされる場合があります)。
浮動小数点数maxZoom
 最大ズーム(カメラと地球に最も近いもの)。
BOOL buildingsEnabled
 設定すると、利用可能な地域で建物が 3D 表示されます。
BOOL indoorEnabled
 インドアマップを表示するかどうかを設定します(利用可能な場合)。
GMSIndoorDisplay *indoorDisplay
 屋内データ表示のさまざまな側面の監視や制御を可能にする GMSIndoorDisplay インスタンスを取得します。
GMSUISettings *設定
 地図のユーザー インターフェースの設定を制御する GMSUISettings オブジェクトを取得します。
UIEdgeInsetsパディング
 「可視」状態をビューを選択できます。
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 セーフエリア インセットをパディング値に追加する方法を制御します。
BOOL accessibilityElementsHidden
 デフォルトは YES です。
GMSMapLayer *レイヤ
 レイヤに使用されるカスタム CALayer タイプのアクセサー。
GMSFrameRatepreferredFrameRate
 レンダリングのフレームレートを制御します。
GMSCoordinateBounds *cameraTargetBounds
 nil でない場合、ジェスチャーによって指定された境界から外れることがないように、カメラ ターゲットが制約されます。
GMSMapCapabilityFlagsmapCapabilities
 MapID やその他の地図の設定に応じて、その時点で利用可能な条件付きでご利用いただけるすべての機能。

(これらはメンバー関数ではありません)。

NSString *constkGMSAccessibilityCompass
 コンパスボタンのユーザー補助 ID。
NSString *constkGMSAccessibilityMyLocation
 「現在地」のユーザー補助 ID] ボタンを離します。
NSString *constkGMSAccessibilityOutOfQuota
 「容量不足」のユーザー補助 ID表示されます。

メンバー関数のドキュメント

- (instancetype) init

CGRectZero とデフォルトのオプションで初期化します。

- (instancetype) initWithOptions: (nonnull GMSMapViewOptions *) options

指定されたオプションで新しいマップビューを作成します。

オプション オブジェクトの値は、このメソッドによってコピーされます。

- (instancetype) initWithFrame: (CGRect) フレーム
-(null 値を許容する instancetype)initWithCoder: (NSCoder *) コーダー
+ (instancetype) mapWithFrame: (CGRect) フレーム
camera: GMSCameraPosition *) カメラ

フレームとカメラ ターゲットを含むマップビューをビルドして返します。

+ (instancetype) mapWithFrame: (CGRect) フレーム
mapID: GMSMapID *) mapID
camera: GMSCameraPosition *) カメラ

フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返すコンビニエンス イニシャライザ。

- (instancetype) initWithFrame: (CGRect) フレーム
camera: GMSCameraPosition *) カメラ

フレームとカメラ ターゲットを含むマップビューをビルドして返します。

注:
これは非推奨です。代わりに -init または -initWithOptions: を使用してください。
- (instancetype) initWithFrame: (CGRect) フレーム
mapID: GMSMapID *) mapID
camera: GMSCameraPosition *) カメラ

フレーム、マップ ID、カメラ ターゲットを含むマップビューをビルドして返します。

注:
これは非推奨です。代わりに -init または -initWithOptions: を使用してください。
- (void) startRendering

この地図にレンダラを起動するように指示します。

これはオプションであり、べき等です。

注:
これは非推奨です。この方法は廃止され、今後のリリースで削除される予定です。
- (void) stopRendering

レンダラの電源を切るようこのマップに指示します。

これはオプションであり、べき等です。

注:
これは非推奨です。この方法は廃止され、今後のリリースで削除される予定です。
- (void) 明確

地図に追加されたすべてのマークアップ(マーカー、ポリライン、地面オーバーレイを含む)を消去します。

この操作では、表示されている位置ドットがクリアされたり、現在の mapType がリセットされたりすることはありません。

- (void) setMinZoom: (浮動小数点数) minZoom
maxZoom: (浮動小数点数) maxZoom

minZoommaxZoom を設定します。

このメソッドは、最小値が最大値以下であると想定し、そうでない場合は NSRangeException という名前の例外をスローします。

- (null 許容の GMSCameraPosition *)cameraForBounds: GMSCoordinateBounds *) 境界
insets: (UIEdgeInsets) インセット

paddingbounds を表示する GMSCameraPosition を作成します。

カメラの方向指定と傾斜がゼロになります(つまり、北を向き、地面をまっすぐ見ている状態)。この GMSMapView のフレームとパディングが考慮されます。

境界が無効な場合、このメソッドは nil カメラを返します。

- (void) moveCamera: GMSCameraUpdate *) update

update に応じてカメラを変更します。

カメラの変更は瞬時に行われます(アニメーションはありません)。

-(BOOL) areEqualForRenderingPosition: GMSCameraPosition *) position
position: GMSCameraPosition *) otherPosition

内部で使用される精度と変換のレベルを考慮して、指定されたカメラ位置によってカメラが実質的に同じレンダリングされるかどうかを確認します。

指定されたタイプの対象物レイヤを返します。

特徴量レイヤは Cloud コンソールで構成する必要があります。

指定されたタイプのレイヤがこの地図に存在しない場合、データドリブン スタイル設定が有効になっていない場合、またはメタル レンダリング フレームワークが使用されない場合、結果のレイヤの `isAvailable` は NO となり、どの呼び出しにも応答しません。

Metal レンダラが必要です。Metal を有効にする方法については、https://developers.google.com/maps/documentation/ios-sdk/config#use-metal をご覧ください。

指定されたデータセットのデータセット対象物レイヤを返します。

データセット ID は Cloud コンソールで構成する必要があります。

指定された ID のデータセットがこの地図に存在しない場合、またはデータドリブンのスタイル設定が有効になっていない場合、結果のレイヤの「isAvailable」は NO になり、どの呼び出しにも応答しません。

- (void) animateToCameraPosition: GMSCameraPosition *) cameraPosition

この地図のカメラを cameraPosition にアニメーション化します。

- (void) animateToLocation: (CLLocationGeocoding2D) location

AnimationToCameraPosition: のように、カメラの位置のみを変更します(現在の位置から location に変更)。

- (void) animateToZoom: (浮動小数点数) ズーム

AnimationToCameraPosition: ですが、カメラのズームレベルのみを変更します。

この値は [kGMSMinZoomLevel, kGMSMaxZoomLevel] で固定されます。

- (void) animateToBearing: (CLLocationDirection) bearing

AnimationToCameraPosition: ですが、カメラの bearing のみ(度数)を変更します。

ゼロは真北を示します。

- (void) animateToViewingAngle: (double) viewingAngle

AnimationToCameraPosition: として、カメラの傾斜角(度数)のみを変更します。

この値は、地球との相対的な近さに応じて、最小 0 (真下)と地平線に対して 30 ~ 45 度の間の値に固定されます。

- (void) animateWithCameraUpdate: GMSCameraUpdate *) cameraUpdate

cameraUpdate を現在のカメラに適用し、activateToCameraPosition: に従って結果を使用します。


-(NSString* 定数)kGMSAccessibilityCompass [related]

コンパスボタンのユーザー補助 ID。

-(NSString* 定数)kGMSAccessibilityMyLocation [related]

「現在地」のユーザー補助 ID] ボタンを離します。

-(NSString* 定数)kGMSAccessibilityOutOfQuota [related]

「容量不足」のユーザー補助 ID表示されます。


プロパティのドキュメント

- (IBOutlet id<GMSMapViewDelegate>) delegate [read, write, assign]

GMSMapView デリゲート。

- (GMSCameraPosition*) camera [read, write, copy]

カメラを制御し、地図の向きを定義します。

このプロパティの変更は瞬時に行われます。

- (GMSProjection*) 投影 [read, assign]

画面の座標と緯度と経度の座標間の変換に使用できる GMSProjection オブジェクトを返します。

これは現在の投影のスナップショットであり、カメラが移動しても自動更新されません。最後に描画された GMSMapView フレームの投影、またはつまり、次のフレームです。nil にはならない。

-(BOOL)myLocationEnabled [read, write, assign]

現在地のドットと精度の円を有効にするかどうかを指定します。

デフォルトは NO です。

- (CLLocation*) myLocation [read, assign]

現在地が有効になっている場合、デバイスの位置情報のドットが描画されている場所が表示されます。

無効になっている場合、または有効になっていても位置情報が利用できない場合は、nil になります。このプロパティは KVO を使用して監視できます。

- (GMSMarker*) selectedMarker [read, write, assign]

選択されたマーカー。

このプロパティを設定すると、特定のマーカーが選択され、そのマーカーの上に情報ウィンドウが表示されます。このプロパティが nil 以外の場合、nil に設定するとマーカーの選択が解除され、情報ウィンドウが非表示になります。このプロパティは KVO を使用して監視できます。

-(BOOL)trafficEnabled [read, write, assign]

交通状況データがある場合に、地図に交通状況データを描画するかどうかを制御します。

これは、交通データの提供状況によります。デフォルトは NO です。

-(GMSMapViewTypemapType [read, write, assign]

表示する地図タイルの種類を制御します。

デフォルトは kGMSTypeNormal です。

- (GMSMapStyle*) mapStyle [read, write, assign]

地図のスタイルを制御します。

nil 以外の mapStyle は、mapType が Normal の場合にのみ適用されます。

- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign]

地図を目的の [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc)に変更します。

これは、下位互換性を確保するために、デフォルトの UIKit 動作をオーバーライドし、デフォルトは UIUserInterfaceStyleLight です。これは、標準および地形のマップタイプのカラーパターンに影響します。

-(浮動小数点数)minZoom [read, assign]

最小ズーム(カメラから最も遠いものがズームアウトされる場合があります)。

デフォルトは kGMSMinZoomLevel です。-setMinZoom:maxZoom: で変更します。

- (浮動小数点数)maxZoom [read, assign]

最大ズーム(カメラと地球に最も近いもの)。

デフォルトは kGMSMaxZoomLevel です。-setMinZoom:maxZoom: で変更します。

-(BOOL)buildingsEnabled [read, write, assign]

設定すると、利用可能な地域で建物が 3D 表示されます。

デフォルトは YES です。

これは、カスタム タイル レイヤを地図に追加するときに、高いズームレベルで見やすくなる場合に便利です。この値を変更すると、すべてのタイルが一時的に無効になります。

-(BOOL)indoorEnabled [read, write, assign]

インドアマップを表示するかどうかを設定します(利用可能な場合)。

デフォルトは YES です。

「いいえ」に設定した場合、屋内データのキャッシュが削除され、エンドユーザーが現在選択した階がリセットされる可能性があります。

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

屋内データ表示のさまざまな側面の監視や制御を可能にする GMSIndoorDisplay インスタンスを取得します。

- (GMSUISettings*) 設定 [read, assign]

地図のユーザー インターフェースの設定を制御する GMSUISettings オブジェクトを取得します。

- (UIEdgeInsets) パディング [read, write, assign]

「可視」状態をビューを選択できます。

ビューの端の周囲にパディングを適用すると、地図データは格納されるものの、UI コントロールは含まれない領域を作成できます。

パディングのバランスが取れていない場合、ビューの視覚中心が適切に移動します。パディングは projection プロパティにも影響するため、表示される領域にパディング領域は含まれません。GMSCameraUpdatefitToBounds を使用すると、このパディングとリクエストされたパディングの両方が考慮されます。

このプロパティは、UIView ベースのアニメーション ブロック内でアニメーション化できます。

セーフエリア インセットをパディング値に追加する方法を制御します。

パディングと同様に、セーフエリア インセットは、デバイスのセーフエリア内でコンパス、現在地ボタン、階数ピッカーなどの位置地図コントロールをインセットします。

デフォルトは kGMSMapViewPaddingAdjustBehaviorAlways です。

-(BOOL)accessibilityElementsHidden [read, write, assign]

デフォルトは YES です。

NO に設定した場合、GMSMapView は、GMSMarkerGMSPolyline などのオーバーレイ オブジェクト用のユーザー補助要素を生成します。

このプロパティは、デフォルト値の YES を除き、非公式の UIAccessibility プロトコルに従います。

- (GMSMapLayer*) layer [read, retain]

レイヤに使用されるカスタム CALayer タイプのアクセサー。

- (GMSFrameRate) preferredFrameRate [read, write, assign]

レンダリングのフレームレートを制御します。

デフォルト値は kGMSFrameRateMaximum です。

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

nil でない場合、ジェスチャーによって指定された境界から外れることがないように、カメラ ターゲットが制約されます。

MapID やその他の地図の設定に応じて、その時点で利用可能な条件付きでご利用いただけるすべての機能。

常時利用できる機能は含まれていません。