概要
Google Maps SDK for iOS のメインクラスであり、地図に関連するすべてのメソッドのエントリ ポイントです。
コンビニエンス コンストラクタ [GMSMapView mapWithFrame:camera:] を使用して地図をインスタンス化する必要があります。デフォルトの [GMSMapView alloc] initWithFrame:] メソッドを使用して作成することもできます（この場合、カメラはデフォルトの場所に設定されます）。
GMSMapView の読み取りと変更は、すべての UIKit オブジェクトと同様に、メインスレッドからのみ行えます。他のスレッドからこれらのメソッドを呼び出すと、例外や未定義の動作が発生します。
パブリック メンバー関数 | |
| （instancetype） | - initWithFrame:camera: |
| フレームとカメラ ターゲットを含むマップビューを作成して返します。 | |
| （instancetype） | - initWithFrame:mapID:camera: |
| フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返します。 | |
| (void) | - startRendering |
| このレンダラを強化するためにこの地図に指示します。 | |
| (void) | - stopRendering |
| このレンダラの電源をオフにするよう、この地図に指示します。 | |
| (void) | - 鮮明度 |
| マーカー、ポリライン、地面オーバーレイなど、地図に追加されているすべてのマークアップをクリアします。 | |
| (void) | - setMinZoom:maxZoom: |
minZoom と maxZoom を設定します。 | |
| （null 許容の GMSCameraPosition *） | - cameraForBounds:insets: |
padding で bounds を表示する GMSCameraPosition を作成します。 | |
| (void) | - moveCamera: |
update に基づいてカメラを変更します。 | |
| （ブール値） | - areEqualForRenderingPosition:position: |
| 内部で使用される精度と変換のレベルを考慮し、カメラの位置が実際には同じレンダリングになるかどうかを確認します。 | |
| (void) | - animateToCameraPosition: |
この地図のカメラを cameraPosition にアニメーション化します。 | |
| (void) | - animateToLocation: |
animateToCameraPosition と似ていますが、カメラの位置のみを変更します（つまり、現在の場所から location に変更します）。 | |
| (void) | - animateToZoom: |
| animateToCameraPosition: ですが、カメラのズームレベルのみを変更します。 | |
| (void) | - animateToBearing: |
| animateToCameraPosition のように変更しますが、変更されるのはカメラの Bearing のみです（度単位）。 | |
| (void) | - animateToViewingAngle: |
| animateToCameraPosition: と同じですが、カメラの表示角度しか変更されません。 | |
| (void) | - animateWithCameraUpdate: |
現在のカメラに cameraUpdate を適用し、その結果を animateToCameraPosition に従って使用します。 | |
静的パブリック メンバー関数 | |
| （instancetype） | + mapWithFrame:camera: |
| フレームとカメラ ターゲットを含むマップビューを作成して返します。 | |
| （instancetype） | + mapWithFrame:mapID:camera: |
| 便利なイニシャライザで、フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返すことができます。 | |
プロパティ | |
| IBOutlet の ID< GMSMapViewDelegate > | 代理人 |
| GMSMapView デリゲート。 | |
| GMSCameraPosition | camera |
| カメラの向きを定義します。地図の向きを定義します。 | |
| GMSProjection * | projection |
| 画面座標と緯度/経度座標間の変換に使用できる GMSProjection オブジェクトを返します。 | |
| BOOL | myLocationEnabled |
| 現在地ドットと精度の円を有効にするかどうかを制御します。 | |
| CLLocation * | myLocation |
| 現在地が有効になっている場合、デバイスの位置情報のドットが表示される場所が表示されます。 | |
| GMSMarker * | selectedMarker |
| 選択されているマーカー。 | |
| BOOL | trafficEnabled |
| 地図に交通状況を描画するかどうかを指定します（利用可能な場合）。 | |
| GMSMapViewType | mapType |
| 表示する地図タイルの種類を指定します。 | |
| GMSMapStyle * | mapStyle |
| 地図のスタイルを制御します。 | |
| 浮動小数点数 | minZoom |
| 最小ズーム（カメラが最大限までズームアウトできます）。 | |
| 浮動小数点数 | maxZoom |
| 最大ズーム（カメラが地球に最も近い）。 | |
| BOOL | buildingsEnabled |
| 設定すると、可能であれば 3D の建物が表示されます。 | |
| BOOL | indoorEnabled |
| インドアマップを表示するかどうかを指定します（利用可能な場合）。 | |
| GMSIndoorDisplay * | 屋内ディスプレイ |
| 屋内のデータ表示のさまざまな側面を監視または制御できる GMSIndoorDisplay インスタンスを取得します。 | |
| GMSUISettings * | 設定 |
| 地図のユーザー インターフェース設定を制御する GMSUISettings オブジェクトを取得します。 | |
| UIEdgeInsets | パディング |
| ビューの「表示」領域を制御します。 | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| セーフエリア インセットをパディング値に追加する方法を制御します。 | |
| BOOL | accessibilityElementsHidden |
| デフォルトは YES です。 | |
| GMSMapLayer * | レイヤ |
| レイヤに使用されるカスタム CALayer タイプのアクセサー。 | |
| GMSFrameRate | preferredFrameRate |
| レンダリング フレームレートを制御します。 | |
| GMSCoordinateBounds * | cameraTargetBounds |
| nil でない場合、指定した領域の外に出ないようにカメラ ターゲットを制約します。 | |
| GMSMapCapabilitiesFlags | mapCapabilities |
| 現時点で利用できる、条件付きで利用できるすべての機能（mapID などのマップ設定によって異なります）。 | |
関連関数 | |
（これらはメンバー関数ではありません）。 | |
| NSString *const | kGMSAccessibilityCompass |
| コンパスボタンのユーザー補助 ID | |
| NSString *const | kGMSAccessibilityMyLocation |
| [現在地] ボタンのユーザー補助 ID。 | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| 「割り当て不足」エラーラベルのユーザー補助 ID。 | |
メンバー関数に関するドキュメント
| + (instancetype) mapWithFrame: | （CGRect） | フレーム | |
| カメラ: | （GMSCameraPosition *） | camera | |
フレームとカメラ ターゲットを含むマップビューを作成して返します。
| + (instancetype) mapWithFrame: | （CGRect） | フレーム | |
| mapID: | （GMSMapID *） | mapID | |
| カメラ: | （GMSCameraPosition *） | camera | |
便利なイニシャライザで、フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返すことができます。
| - (instancetype) initWithFrame: | （CGRect） | フレーム | |
| カメラ: | （GMSCameraPosition *） | camera | |
フレームとカメラ ターゲットを含むマップビューを作成して返します。
| - (instancetype) initWithFrame: | （CGRect） | フレーム | |
| mapID: | （GMSMapID *） | mapID | |
| カメラ: | （GMSCameraPosition *） | camera | |
フレーム、マップ ID、カメラ ターゲットを含むマップビューを作成して返します。
| -（void）startRendering |
このレンダラを強化するためにこの地図に指示します。
これはオプションであり、べき等です。
- 注:
- これは非推奨です。この方法は廃止され、今後のリリースで削除される予定です。
| -（無効化）stopRendering |
このレンダラの電源をオフにするよう、この地図に指示します。
これはオプションであり、べき等です。
- 注:
- これは非推奨です。この方法は廃止され、今後のリリースで削除される予定です。
| - クリアする |
マーカー、ポリライン、地面オーバーレイなど、地図に追加されているすべてのマークアップをクリアします。
表示している地点のドットを消去したり、現在の mapType をリセットしたりすることはありません。
| - (void) setMinZoom: | （浮動小数点数） | minZoom | |
| maxZoom: | （浮動小数点数） | maxZoom | |
minZoom と maxZoom を設定します。
このメソッドは、最小値が最大値以下であると想定し、そうでない場合は NSRangeException という名前で例外をスローします。
| -（null 許容の GMSCameraPosition *）cameraForBounds: | （GMSCoordinateBounds *） | 境界 | |
| インセット: | （UIEdgeInsets） | インセット | |
padding で bounds を表示する GMSCameraPosition を作成します。
カメラの向きや傾斜はゼロになります（つまり、カメラの向きを北に向けて、まっすぐ地球を見渡します）。これにより、この GMSMapView のフレームとパディングが考慮されます。
境界が無効な場合、このメソッドは nil カメラを返します。
| -（void）moveCamera: | （GMSCameraUpdate *） | update |
update に基づいてカメラを変更します。
カメラの変更は瞬間的です（アニメーションなし）。
| - （BOOL）areEqualForRenderingPosition: | （GMSCameraPosition *） | position | |
| 位置: | （GMSCameraPosition *） | otherPosition | |
内部で使用される精度と変換のレベルを考慮し、カメラの位置が実際には同じレンダリングになるかどうかを確認します。
| -（void）animateToCameraPosition: | （GMSCameraPosition *） | cameraPosition |
この地図のカメラを cameraPosition にアニメーション化します。
| -（void）animateToLocation: | （CLLocationCoordinate2D） | 位置情報 |
animateToCameraPosition と似ていますが、カメラの位置だけを変更します（つまり、現在地から location に変更します）。
| -（void）animateToZoom: | （浮動小数点数） | ズーム |
animateToCameraPosition: ですが、カメラのズームレベルのみを変更します。
この値は、[kGMSMinZoomLevel、kGMSMaxZoomLevel] でクランプされます。
| -（void）animateToBearing: | （CLLocationDirection） | bearing |
animateToCameraPosition のように変更しますが、変更されるのはカメラの Bearing のみです（度単位）。
ゼロは真北を表します。
| -（void）animateToViewingAngle: | （2 倍） | 表示角度 |
animateToCameraPosition: と同じですが、カメラの表示角度しか変更されません。
この値は、地球への相対的な近さに応じて、最低 0 度（つまり真下）で、水平線に対して 30 ～ 45 度の範囲に固定されます。
| -（void）animateWithCameraUpdate: | （GMSCameraUpdate *） | cameraUpdate |
現在のカメラに cameraUpdate を適用し、その結果を animateToCameraPosition に従って使用します。
友だちと関連機能のドキュメント
-（NSString* const）kGMSAccessibilityCompass [related] |
コンパスボタンのユーザー補助 ID
-（NSString* const）kGMSAccessibilityMyLocation [related] |
[現在地] ボタンのユーザー補助 ID。
-（NSString* const）kGMSAccessibilityOutOfQuota [related] |
「割り当て不足」エラーラベルのユーザー補助 ID。
プロパティのドキュメント
- (IBOutlet id<GMSMapViewDelegate>) delegate [read, write, assign] |
GMSMapView デリゲート。
- （GMSCameraPosition*）カメラ [read, write, copy] |
カメラの向きを定義します。地図の向きを定義します。
このプロパティの変更は即座に行われます。
- （GMSProjection*）projection [read, assign] |
画面座標と緯度/経度座標間の変換に使用できる GMSProjection オブジェクトを返します。
これは現在の投影のスナップショットであり、カメラが移動しても自動的に更新されます。これは、最後に描画された GMSMapView フレームの投影、またはカメラが明示的に設定された場所、または地図が作成されたばかりの次のフレームを表します。nil になることはありません。
-（ブール値）myLocationEnabled [read, write, assign] |
現在地ドットと精度の円を有効にするかどうかを制御します。
デフォルトは NO です。
-（CLLocation*）myLocation [read, assign] |
現在地が有効になっている場合、デバイスの位置情報のドットが表示される場所が表示されます。
無効になっているか、有効にされているにもかかわらず位置情報を利用できない場合は、nil になります。このプロパティは、KVO を使用して監視できます。
-（GMSMarker*）selectedMarker [read, write, assign] |
選択されているマーカー。
このプロパティを設定すると特定のマーカーを選択し、その上に情報ウィンドウを表示します。このプロパティが nil でない場合、マーカーを選択解除し、情報ウィンドウは非表示になります。このプロパティは、KVO を使用して監視できます。
-（BOOL）trafficEnabled [read, write, assign] |
地図に交通状況を描画するかどうかを指定します（利用可能な場合）。
これは、トラフィック データの可用性によって変わります。デフォルトは NO です。
-（GMSMapViewType）mapType [read, write, assign] |
表示する地図タイルの種類を指定します。
デフォルトは kGMSTypeNormal です。
-（GMSMapStyle*）mapStyle [read, write, assign] |
地図のスタイルを制御します。
nil 以外の mapStyle は、mapType が Normal の場合にのみ適用されます。
- （浮動小数点）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 プロパティにも影響するため、表示領域にパディング領域は含まれません。GMSCameraUpdate fitToBounds を使用することで、このパディングとリクエストされたパディングの両方が考慮されます。
このプロパティは、UIView ベースのアニメーション ブロック内でアニメーション化できます。
-（GMSMapViewPaddingAdjustmentBehavior）paddingAdjustmentBehavior [read, write, assign] |
セーフエリア インセットをパディング値に追加する方法を制御します。
パディングと同様に、セーフエリア インセット（コンパス、現在地ボタン、デバイス選択ツール内のフロアピッカーなど）を地図に組み込んで配置します。
デフォルトは kGMSMapViewPaddingAdjustmentBehaviorAlways です。
-（BOOL）accessibilityElementsHidden [read, write, assign] |
デフォルトは YES です。
「いいえ」に設定した場合、GMSMapView はオーバーレイ オブジェクト（GMSMarker や GMSPolyline など）のユーザー補助要素を生成します。
このプロパティは、デフォルトの YES を除き、カジュアルな UIAccessibility プロトコルに従います。
- （GMSMapLayer*）layer [read, retain] |
レイヤに使用されるカスタム CALayer タイプのアクセサー。
-（GMSFrameRate）preferredFrameRate [read, write, assign] |
レンダリング フレームレートを制御します。
デフォルト値は kGMSFrameRateMaximum です。
-（GMSCoordinateBounds*）cameraTargetBounds [read, write, assign] |
nil でない場合、指定した領域の外に出ないようにカメラ ターゲットを制約します。
-（GMSMapCapabilitiesFlags）mapCapabilities [read, assign] |
現時点で利用できる、条件付きで利用できるすべての機能（mapID などのマップ設定によって異なります）。
常時利用可能な機能は含まれません。