Maps SDK for iOS では、地図のカメラを変更することで、地図に対するユーザーの視点を変更できます。
Maps SDK for iOS では、地図を傾斜または回転させて、状況に応じた適切な向きに調整できます。どのズームレベルでも、ユーザーはわずかな遅延で地図をパンしたり、視点を変更したりできます。
カメラに変更を加えても、追加したマーカーやポリラインなどのグラフィックは変更されませんが、新しいビューでより適切に表示されるようにこれらを変更するほうがよい場合があります。
地図のビュー
Maps SDK for iOS では、メルカトル図法を使用して、デバイスの画面(平面)上に世界の表面(球面)を表します。
カメラの位置
地図ビューは、平面を見下ろすカメラとしてモデル化されています。カメラの位置は(したがって地図のレンダリングも)、target(緯度と経度の位置)、bearing、tilt、zoom の各プロパティで指定されます。

target(位置)
カメラの target は地図の中心位置で、緯度と経度の座標で指定されます。
緯度は、-85~85 度の範囲で指定できます。この範囲以外の値は、この範囲内の最も近い値に設定されます。たとえば、緯度 100 を指定した場合は、値が 85 に設定されます。経度は -180~180 度の範囲になります。この範囲以外の値は、-180~180 の範囲内に収まるように変換されます。たとえば、480、840、1200 はすべて、120 度に変換されます。bearing(向き)
カメラの bearing は、コンパス方位を真北(地図の上端に対応)からの角度で示したものです。地図の中央から地図上端に向かって垂直線を引いた場合、bearing はカメラの向き(heading)を真北からの相対的な角度で示したものに対応します。
bearing が 0 なら、地図の上端が真北を指していることを意味します。bearing の値が 90 なら、地図の上端は真東(コンパスで 90 度)を指していることを意味します。値が 180 なら、地図の上端は真南を指します。
Maps API では、地図の bearing を変更することが可能です。車を運転する人の多くは、道路地図の向きを進行方向に合わせます。一方、地図とコンパスを使用するハイカーの多くは、垂直線が北を指すように地図の向きを調整します。
tilt(傾斜角、投影角または視角)
tilt は、地図の中心の真上を通る円弧上にあるカメラの位置として定義され、天底(カメラの真下を指す方向)からの度数で示されます。値が 0 なら、カメラが真下を向いていることを意味します。値を 0 より大きくすると、カメラはその角度の分だけ水平線に向かって円弧上を移動し、傾いていきます。角度を変更すると、遠くをより小さく、近くをより大きく描く透視投影法で地図が表示されます。以下の図でこれを示します。
以下の図の傾斜角は 0 度です。最初の図は、これを図解したものです。位置 1 がカメラの位置で、位置 2 が現在の地図の位置です。その下に、生成される地図を示します。
![]() |
![]() |
以下の図では、傾斜角が 45 度です。カメラが真上(0 度)と地面(90 度)を結ぶ円弧に沿って、位置 3 まで半分移動している点に注意してください。カメラが地図の中心点を指していることに変わりはありませんが、位置 4 の線で表される領域も視界に入っています。
![]() |
![]() |
このスクリーンショットの地図の中心は、元の地図と同じ地点に設定されていますが、地図の上部により多くの対象物が表示されています。角度を 45 度より大きくすると、カメラと地図位置の間にある対象物が相対的に大きく表示され、地図位置より後ろにある対象物は相対的に小さく表示されるようになるため、3 次元効果が生まれます。
Zoom
カメラのズームレベルにより、地図の縮尺が決まります。ズームレベルが大きいほど画面の表示はより詳細になり、ズームレベルが小さいほど表示される地域が広くなります。ズームレベル 0 では、全世界の幅が約 256 ポイントになる地図スケールが表示されます。
ズームレベルを 1 上げるごとに、画面の世界の幅が 2 倍になります。したがって、ズームレベル N では、世界の幅は約 256 * 2N ポイントになります。たとえば、ズームレベル 2 では、全世界の幅は約 1,024 ポイントになります。
ズームレベルを整数にする必要はありません。地図で許可されるズームレベルの範囲は、target、地図タイプ、画面サイズといった複数の要因によって決まります。範囲外の数値は、それに最も近い有効な値(最小ズームレベルまたは最大ズームレベル)に変換されます。次のリストは、各ズームレベルで表示されるおおよその詳細度を示しています。
- 1: 世界
- 5: 大陸
- 10: 都市
- 15: 通り
- 20: 建物
![]() |
![]() |
![]() |
カメラの初期位置を設定する
GMSCameraPosition
オブジェクトを使用してカメラの初期位置を設定します。これにより、ターゲットの緯度と経度に加えて、方向指定、傾斜、ズームを設定できます。
初期カメラ位置を設定するには、GMSMapViewOptions
オブジェクトを作成し、camera
プロパティを GMSCameraPosition
に設定します。次に、オプションを GMSMapView
コンビニエンス コンストラクタに渡します。
Swift
let options = GMSMapViewOptions() options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16) let mapView = GMSMapView(options:options)
Objective-C
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:16]; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
デフォルトの UIView
init メソッドを使用して GMSMapView
オブジェクトを作成することもできます。この場合、カメラの位置はデフォルトの場所から始まり、作成後に変更します。
Swift
let options = GMSMapViewOptions() options.frame = self.view.bounds let mapView = GMSMapView(options:options)
Objective-C
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.frame = self.view.bounds; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
カメラの位置を変更する
プログラムでカメラの位置を変更して、位置、方向、傾斜、ズームを設定できます。GMSMapView
には、カメラ位置を変更するためのメソッドがいくつか用意されていますが、通常は GMSCameraPosition
または GMSCameraUpdate
を使用します。
GMSCameraPosition
には、すべてのカメラ位置パラメータ(target、Bearing、tilt、Zoom)の変更に使用するプロパティとメソッドが含まれています。GMSCameraUpdate
を使用すると、ターゲット、方向、傾斜、ズームを変更できます。また、スクロール、高度なズーム、事前定義した境界内でのカメラの中心設定などをサポートする追加の便利なメソッドも含まれています。
カメラを移動すると、カメラを新しい位置に「スナップ」する(アニメーションがない)か、動きをアニメーション化するかを選択できます。たとえば、カメラのターゲット位置の変更をアニメーション化すると、アニメーションは前の位置から新しい位置にパンします。
アニメーションによって、現在のカメラ属性から新しいカメラ属性にスムーズに表示が切り替わります。Core Animation でアニメーションの持続時間をコントロールできます。
GMSCameraPosition
GMSCameraPosition
でカメラを変更するには、新しいオブジェクトを作成するか、既存のオブジェクトをコピーして、GMSMapView
オブジェクトに設定します。アニメーションの有無にかかわらず、新しい場所にカメラをスナップするには、GMSCameraPosition
オブジェクトを使用します。
緯度、経度、ズーム、方向、傾斜角などのカメラ プロパティを設定するには、GMSCameraPosition
オブジェクトを使用します。このオブジェクトを使用して、GMSMapView
の camera
プロパティを設定します。
Swift
let fancy = GMSCameraPosition( latitude: -33, longitude: 151, zoom: 6, bearing: 270, viewingAngle: 45 ) mapView.camera = fancy
Objective-C
GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6 bearing:30 viewingAngle:45]; [mapView setCamera:fancy];
デフォルト値に設定する GMSCameraPosition
プロパティは省略します。
移動をアニメーション化するには、camera
プロパティを設定する代わりに animateToCameraPosition:
メソッドを使用します。
GMSCameraUpdate
GMSCameraUpdate
を使用すると、カメラ位置を更新し、その新しい位置にスナップするかアニメーション化するかを選択できます。GMSCameraUpdate
のメリットは利便性です。GMSCameraPosition
を使用して GMSCameraUpdate
と同じタスクを実行できますが、GMSCameraUpdate
には、カメラの操作を容易にする追加のヘルパー メソッドが用意されています。
たとえば、GMSCameraPosition
を使用して現在のズームレベルをインクリメントするには、まず現在のズームレベルを特定してから、GMSCameraPosition
オブジェクトを作成して、ズームレベルを現在のズームレベルよりも 1 大きい値に設定する必要があります。
または、zoomIn:
メソッドを使用して GMSCameraUpdate
オブジェクトを作成します。次に、GMSCameraUpdate
オブジェクトを GMSMapView
animateWithCameraUpdate:
メソッドに渡してカメラを更新します。
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
代わりに、GMSMapView
moveCamera:
メソッドを使用してカメラを新しい位置にスナップします。
次の例では、GMSCameraUpdate
を使用して、バンクーバーを中心とするカメラの移動をアニメーション化します。
Swift
// Center the camera on Vancouver, Canada let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11) let vancouverCam = GMSCameraUpdate.setTarget(vancouver) mapView.animate(with: vancouverCam)
Objective-C
// Center the camera on Vancouver, Canada CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11); GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver]; [mapView animateWithCameraUpdate:vancouverCam];
GMSCameraUpdate
オブジェクトを作成する
いずれかのメソッドを使用して GMSCameraUpdate
オブジェクトを作成します。
zoomIn:
、zoomOut:
- 他のすべてのプロパティは同じに保ったまま、現在のズームレベルを 1.0 に変更します。
zoomTo:
- その他すべてのプロパティは同じに保ったまま、ズームレベルを指定した値に変更します。
zoomBy:
- ズームレベルを指定した値だけ上げます(値が負の場合は下げます)。
zoomBy:atPoint:
- 画面上の指定されたポイントの位置を維持しながら、ズームレベルを指定した値だけ上げます(または、負の値の場合は下げます)。
setTarget:
- カメラの緯度と経度を変更します。他のすべてのプロパティはそのままです。
setTarget:zoom:
- その他すべてのプロパティは同じに保ったまま、カメラの緯度、経度、ズームを変更します。
setCamera:
- 新しい
GMSCameraPosition
を設定します。 scrollByX:Y:
- カメラの緯度と経度を変更して、指定したポイント数だけ地図を移動します。正の x 値を指定するとカメラが右に移動するため、地図は左に移動したように見えます。正の y 値を指定するとカメラが下に移動するため、地図が上に移動したように見えます。スクロールは、カメラの現在の方向に相対的に行われます。たとえば、カメラの方向が 90 度の場合、東は「上」です。
fitBounds:
- 可能な限り最大のズームレベルで、画面上の指定された境界を中心としてカメラが変形されます。64 ポイントの境界にデフォルトのパディングを適用します。
fitBounds:withPadding:
- 可能な限り最大のズームレベルで、画面上の指定された境界を中心としてカメラが変形されます。このメソッドを使用して、境界ボックスのすべての側面に同じパディングをポイント単位で指定します。
fitBounds:withEdgeInsets:
- 可能な限り最大のズームレベルで、画面上の指定された境界を中心としてカメラが変形されます。
UIEdgeInsets
を使用すると、境界ボックスの両側に個別にパディングを指定します。
GMSMapView
を使用して単一のプロパティを変更する
GMSMapView
には、GMSCameraPosition
オブジェクトや GMSCameraUpdate
オブジェクトを使用せずにカメラを移動するためのメソッドがいくつか用意されています。これらのメソッド(animateToLocation:
や animateToZoom:
など)を使用すると、1 つのカメラ プロパティへの変更をアニメーション化できます。
たとえば、カメラの傾斜の変化をアニメーション化するには、toViewingAngle:
メソッドを使用します。
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
ターゲット(ロケーション)の設定
位置により地図の中心が決まります。位置情報は緯度と経度で指定され、CLLocationCoordinate2DMake
で作成された CLLocationCoordinate2D
によってプログラムによって表されます。
場所を変更するには GMSCameraPosition
を使用します。この例では、地図は新しい場所にスナップされます。
Swift
let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208) mapView.camera = GMSCameraPosition(target: target, zoom: 6)
Objective-C
CLLocationCoordinate2D target = CLLocationCoordinate2DMake(-33.868, 151.208); mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
変更をアニメーション化して地図を新しい位置にパンするには、camera
プロパティを設定する代わりに animateToCameraPosition:
メソッドを使用します。または、GMSMapView
で animateToLocation:
メソッドを使用します。
Swift
mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
Objective-C
[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
GMSCameraUpdate
オブジェクトを作成してカメラを移動することもできます。組み込みのメソッド scrollByX:Y:
を使用して、カメラを X 方向と Y 方向にスクロールするポイントの数を指定します。この例では、カメラを 200 ポイント右に、100 ポイント下にスクロールします。
Swift
// Move the camera 200 points to the right, and 100 points downwards let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100) mapView.animate(with: downwards)
Objective-C
// Move the camera 200 points to the right, and 100 points downwards GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0]; [mapView animateWithCameraUpdate:downwards];
方向(向き)を設定する
bearing は、地図の上端を真北からの角度で表したコンパス方位です。たとえば bearing が 90 度の場合、上端が真東を指している地図になります。
GMSCameraPosition
または GMSCameraUpdate
、または GMSMapView
の animateToBearing:
メソッドを使用して、プログラムで bearing を設定します。
Swift
mapView.animate(toBearing: 0)
Objective-C
[mapView animateToBearing:0];
傾斜(傾斜角、投影角または視角)の設定
傾斜角とは、地図の中心の真上と地表面を結ぶ円弧上にあるカメラの位置で、天底(カメラの真下を指す方向)からの度数で示されます。角度を変更すると、地図が透視投影法で表示されます。カメラと地図位置の間にある対象物は相対的に大きく表示され、地図位置より後ろにある対象物は相対的に小さく表示されるため、3 次元効果が生まれます。
表示角度は、0(地図の真下)から、ズームレベルに依存する最大値までの範囲で指定できます。ズームレベル 16 以上の場合、最大角度は 65 度です。ズームレベル 10 以下では、最大角度は 30 度です。
傾斜角は、プログラムで GMSCameraPosition
または GMSCameraUpdate
を使用するか、GMSMapView
の animateToViewingAngle:
メソッドを使用して設定します。
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
ズームを設定
カメラのズームレベルにより、地図の縮尺が決まります。ズームレベルが大きいほど画面の表示はより詳細になり、ズームレベルが小さいほど表示される世界は広くなります。
プログラマティックに GMSCameraPosition
または GMSCameraUpdate
を使用するか、GMSMapView
の animateToZoom:
メソッドを使用してズームを設定します。
Swift
mapView.animate(toZoom: 12)
Objective-C
[mapView animateToZoom:12];
次の例では、zoomIn:
メソッドを使用して GMSCameraUpdate
オブジェクトを作成し、現在のレベルから 1 レベルずつズームインをアニメーション化しています。
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
境界を設定
関心のある地域全体が最大のズームレベルで表示されるようにカメラを移動するには、カメラビューの境界を設定します。たとえば、ユーザーの現在地から 8 km 以内にあるガソリン スタンドをすべて表示するには、すべて画面上に表示されるようにカメラを移動します。
- 画面に表示する
GMSCoordinateBounds
を計算します。 GMSMapView
のcameraForBounds:insets:
メソッドを使用して、新しいGMSCameraPosition
を返します。
この境界を設定すると、指定した GMSCoordinateBounds
が現在の地図のサイズに完全に収まります。このメソッドでは、地図の傾斜と方向指定が 0 に設定されます。
次の例は、バンクーバーとカルガリーの両方の都市が同じビューに表示されるようにカメラを変更する方法を示しています。
Swift
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11) let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05) let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary) let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())! mapView.camera = camera
Objective-C
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11); CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05); GMSCoordinateBounds *bounds = [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary]; GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero]; mapView.camera = camera;
ユーザーのパンを特定領域に制限する
これらのシナリオでは地図の境界が設定されますが、ユーザーはこの境界の外側をスクロールまたはパンできます。代わりに、地図(カメラ ターゲット)のフォーカス ポイントの座標中心の境界に制限を設けて、ユーザーがこの境界内でのみスクロールとパンを行えるようにすることをおすすめします。
たとえば、ショッピング センターや空港向けの小売り用アプリでは、地図を特定の範囲に制限して、ユーザーがその範囲内でスクロールやパンを行えるようにする必要があります。
パンを特定の境界に制限するには、GMSMapView
の cameraTargetBounds
プロパティを、必要な境界を定義する GMSCoordinateBounds
オブジェクトに設定します。後で制限を削除するには、cameraTargetBounds
を nil に設定します。
Swift
mapView.cameraTargetBounds = bounds
Objective-C
mapView.cameraTargetBounds = bounds;
次の図は、カメラ ターゲットがビューポートより若干大きな領域に制限されている場合のシナリオを示しています。カメラ ターゲットが境界領域内にある場合のみ、ユーザーはスクロールおよびパン操作を行うことができます。X は、カメラ ターゲットを表しています。

地図は常にビューポート全体に表示されます。ビューポートは、定義された境界の外側の領域も表示します。たとえば、カメラ ターゲットを境界領域の角に置いた場合、その角を超えた領域もビューポートに表示されますが、ユーザーはその領域にスクロールまたはパンすることはできません。以下の図は、このシナリオを示しています。X はカメラ ターゲットを表しています。

次の図では、カメラ ターゲットは非常に狭い境界内にあり、ユーザーは地図のスクロールまたはパン操作をほとんど行うことができません。X はカメラ ターゲットを表しています。

最小または最大ズームを設定する
グローバル定数 kGMSMinZoomLevel
と kGMSMaxZoomLevel
は、ズーム値の最小値または最大値を定義します。デフォルトでは、GMSMapView
の minZoom
プロパティと maxZoom
プロパティはこれらの定数に設定されています。
地図で使用できるズームレベルを制限するには、最小ズームレベルと最大ズームレベルを設定します。次のコードは、ズームレベルを 10 ~ 15 に制限しています。
Swift
let camera = GMSCameraPosition( latitude: 41.887, longitude: -87.622, zoom: 12 ) let mapView = GMSMapView(frame: .zero, camera: camera) mapView.setMinZoom(10, maxZoom: 15)
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887 longitude:-87.622 zoom:12]; GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; [mapView setMinZoom:10 maxZoom:15];
setMinZoom:maxZoom:
メソッドを使用してズーム範囲を設定する必要があります。ただし、minZoom
プロパティと maxZoom
プロパティを使用して現在の値を読み取ることができます。この方法は、いずれか 1 つの値のみを制限する場合に便利です。次のコードは、最小ズームレベルのみを変更します。
Swift
mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
Objective-C
[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
最小ズームと最大ズームを更新した後でカメラのズームレベルが新しい範囲外の値に設定された場合は、現在のズームが自動的に更新され、最も近い有効な値が表示されます。たとえば次のコードでは、元のズームは 4 として定義されています。後でズーム範囲を 10 ~ 15 に設定すると、現在のズームは 10 に更新されます。
Swift
// Sets the zoom level to 4. let camera2 = GMSCameraPosition( latitude: 41.887, longitude: -87.622, zoom: 4 ) let mapView2 = GMSMapView(frame: .zero, camera: camera) // The current zoom, 4, is outside of the range. The zoom will change to 10. mapView.setMinZoom(10, maxZoom: 15)
Objective-C
// Sets the zoom level to 4. GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887 longitude:-87.622 zoom:4]; GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero camera:camera]; // The current zoom, 4, is outside of the range. The zoom will change to 10. [mapView setMinZoom:10 maxZoom:15];