概要
これは Google Maps SDK for iOS のメインクラスで、地図に関するすべてのメソッドのエントリ ポイントです。
利便性のコンストラクタ [GMSMapView mapWithFrame:camera:] を使用して、地図をインスタンス化する必要があります。デフォルトの [[GMSMapView alloc] initWithFrame:] メソッドで作成することもできます(カメラはデフォルトの場所に設定されます)。
すべての UIKit オブジェクトと同様に、GMSMapView の読み取りと変更がメインスレッドからのみ可能になります。別のスレッドからこれらのメソッドを呼び出すと、例外や未定義の動作が発生します。
パブリック メンバー関数 | |
(インスタンス タイプ) | - initWithFrame:camera: |
フレームとカメラ ターゲットを持つ地図ビューを作成して返します。 | |
(インスタンス タイプ) | - initWithFrame:mapID:camera: |
フレーム、マップ ID、カメラ ターゲットを持つ地図ビューを作成して返します。 | |
(void) | - startRendering |
レンダラのパワーアップをこのマップに指示します。 | |
(void) | - stopRendering |
レンダラの電源を切るようにこの地図に指示します。 | |
(void) | - クリア |
マーカー、ポリライン、地面オーバーレイを含む、地図に追加されたすべてのマークアップをクリアします。 | |
(void) | - setMinZoom:maxZoom: |
minZoom と maxZoom を設定します。 | |
(null 許容 GMSCameraPosition *) | - cameraForBounds:insets: |
padding で bounds を提示する GMSCameraPosition を作成します。 | |
(void) | - moveCamera: |
update に従ってカメラを変更します。 | |
(BOOL) | - areEqualForRenderingPosition:position: |
内部で使用される精度と変換のレベルを考慮して、指定されたカメラ位置でカメラが実際にレンダリングされるかどうかを確認します。 | |
(void) | - animateToCameraPosition: |
この地図のカメラをアニメーション化します。cameraPosition | |
(void) | - animateToLocation: |
animateToCameraPosition: と同じですが、カメラの位置のみを変更します(つまり、現在の位置から location に変更します)。 | |
(void) | - animateToZoom: |
animateToCameraPosition: として指定します。ただし、カメラのズームレベルのみを変更します。 | |
(void) | - animateToBearing: |
animateToCameraPosition: と同じですが、カメラの Bearing のみ(度単位)を変更します。 | |
(void) | - animateToViewingAngle: |
animateToCameraPosition: として指定されますが、カメラの視野角(度)のみが変更されます。 | |
(void) | - animateWithCameraUpdate: |
cameraUpdate を現在のカメラに適用し、animateToCameraPosition: に従って結果を使用します。 | |
静的パブリック メンバー関数 | |
(インスタンス タイプ) | + mapWithFrame:camera: |
フレームとカメラ ターゲットを持つ地図ビューを作成して返します。 | |
(インスタンス タイプ) | + 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* | layer |
レイヤに使用されるカスタム CALayer タイプのアクセサー。 | |
GMSFrameRate | preferredFrameRate |
レンダリング フレームレートを制御します。 | |
GMSCoordinateBounds* | cameraTargetBounds |
nil でない場合は、カメラ ターゲットを制約して、ジェスチャーが指定の境界から外れることがないようにします。 | |
関連関数 | |
(これらはメンバー関数ではありません)。 | |
NSString *const | kGMSAccessibilityMyLocation |
「現在地」ボタンのユーザー補助 ID。 |
メンバー関数のドキュメント
+ (インスタンス タイプ) mapWithFrame: | (CGRect) | フレーム | |
カメラ: | (GMSCameraPosition *) | camera | |
フレームとカメラ ターゲットを持つ地図ビューを作成して返します。
+ (インスタンス タイプ) mapWithFrame: | (CGRect) | フレーム | |
mapID: | (GMSMapID *) | mapID | |
カメラ: | (GMSCameraPosition *) | camera | |
フレーム、マップ ID、カメラ ターゲットで地図ビューを作成し、返す便利なイニシャライザ。
- (インスタンス タイプ)initWithFrame: | (CGRect) | フレーム | |
カメラ: | (GMSCameraPosition *) | camera | |
フレームとカメラ ターゲットを持つ地図ビューを作成して返します。
- (インスタンス タイプ)initWithFrame: | (CGRect) | フレーム | |
mapID: | (GMSMapID *) | mapID | |
カメラ: | (GMSCameraPosition *) | camera | |
フレーム、マップ ID、カメラ ターゲットを持つ地図ビューを作成して返します。
-(void)startRendering |
レンダラのパワーアップをこのマップに指示します。
これはオプションであり、べき等です。
- 注:
- これは非推奨の機能です。このメソッドは廃止され、今後のリリースで削除される予定です。
-(void)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 のみ(度単位)を変更します。
0 は真北を示します。
-(void)animateToViewingAngle: | (ダブル) | viewing Angle |
animateToCameraPosition: として指定されますが、カメラの視野角(度)のみが変更されます。
この値は、地球との相対的な近接性に応じて、最低でも 0 度(真下を向く)、水平方向に 30 ~ 45 度の範囲で調整されます。
-(void)animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
cameraUpdate
を現在のカメラに適用し、animateToCameraPosition: に従って結果を使用します。
友だちと関連関数のドキュメント
- (NSString* const) kGMSAccessibilityMyLocation [related] |
「現在地」ボタンのユーザー補助 ID。
プロパティのドキュメント
- (IBOutlet id<GMSMapViewDelegate>) デリゲート [read, write, assign] |
GMSMapView デリゲート。
- (GMSCameraPosition*)カメラ [read, write, copy] |
カメラの方向を制御します。地図の向きを定義します。
このプロパティの変更は瞬時に行われます。
- (GMSProjection*)予測 [read, assign] |
画面座標と緯度と経度の座標間の変換に使用できる GMSProjection オブジェクトを返します。
これは現在の投影のスナップショットです。カメラが動いても自動更新されません。これは、最後に描画された GMSMapView フレームの投影、またはカメラが明示的に設定された場所か、作成したばかりの地図(次のフレーム)の投影を表します。ゼロになることはありません。
- (BOOL)myLocationEnabled [read, write, assign] |
現在地のドットと精度の円を有効にするかどうかを指定します。
デフォルトは「いいえ」です。
- (CLLocation*)myLocation [read, assign] |
現在地を有効にすると、ユーザーの現在地が描画されている場所が表示されます。
無効にするか、有効にしても位置情報が利用できない場合は、nil になります。このプロパティは KVO を使用して監視できます。
-(GMSMarker*)selectedMarker [read, write, assign] |
選択されているマーカー。
このプロパティを設定すると、特定のマーカーが選択され、その上に情報ウィンドウが表示されます。このプロパティが nil でない場合は、nil に設定するとマーカーの選択が解除され、情報ウィンドウは非表示になります。このプロパティは KVO を使用して監視できます。
- (BOOL)trafficEnabled [read, write, assign] |
地図にトラフィック データを描画するかどうかを指定します(利用可能な場合)。
これはトラフィック データの可用性によって変動します。デフォルトは「いいえ」です。
- 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 です。
NO に設定すると、屋内データのキャッシュが消去され、エンドユーザーが現在選択しているフロアがリセットされる可能性があります。
- (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 です。
NO に設定した場合、GMSMapView は GMSMarker や GMSPolyline などのオーバーレイ オブジェクトのユーザー補助要素を生成します。
このプロパティは、デフォルトの UI である YES を除き、非公式の UIAcessibility プロトコルに従います。
- GMSMapLayer* (layer) [read, retain] |
レイヤに使用されるカスタム CALayer タイプのアクセサー。
- GMSFrameRate(preferredFrameRate) [read, write, assign] |
レンダリング フレームレートを制御します。
デフォルト値は kGMSFrameRateMaximum です。
- (GMSCoordinateBounds*)cameraTargetBounds [read, write, assign] |
nil でない場合は、カメラ ターゲットを制約して、ジェスチャーが指定の境界から外れることがないようにします。