Kamera ve görünüm

Platform seçin: Android iOS JavaScript

iOS için Haritalar SDK'sı ile haritanın kamerasını değiştirerek kullanıcının haritaya bakış açısını değiştirebilirsiniz.

iOS için Haritalar SDK'sı ile kullanıcılarınız, haritalarınızı kendi bağlamlarına uygun bir yöne ayarlamak için eğip döndürebilir. Kullanıcılar, herhangi bir yakınlaştırma düzeyinde haritayı çok az gecikmeyle kaydırabilir veya perspektifini değiştirebilir.

Kamerada yapılan değişiklikler, eklediğiniz işaretleri, çoklu çizgileri veya diğer grafikleri değiştirmez. Ancak bu eklemeleri yeni görünüme daha iyi uyacak şekilde değiştirmek isteyebilirsiniz.

Haritanın görünümü

iOS için Haritalar SDK'sı, dünyanın yüzeyini (bir küre) cihazınızın ekranında (düz bir düzlem) göstermek için Mercator projeksiyonunu kullanır.

Kamera konumu

Harita görünümü, düz bir düzleme yukarıdan bakan bir kamera olarak modellenir. Kameranın konumu (ve dolayısıyla haritanın oluşturulması) şu özelliklerle belirtilir: target (enlem/boylam konumu), bearing, tilt ve zoom.

Kamera özellikleri diyagramı

Hedef (konum)

Kamera hedefi, haritanın merkezinin konumudur ve enlem ile boylam koordinatları olarak belirtilir.

Enlem -85 ile 85 derece arasında (bu değerler dahil) olabilir. Bu aralığın üzerindeki veya altındaki değerler, bu aralıktaki en yakın değere sabitlenir. Örneğin, 100 enlemini belirtmek değeri 85 olarak ayarlar. Boylam, -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Bu aralığın üstündeki veya altındaki değerler, aralığa (-180, 180) girecek şekilde sarmalanır. Örneğin, 480, 840 ve 1200 değerleri 120 dereceye sarılır.

Rulman (yön)

Kamera yönü, pusula yönünü belirtir. Bu yön, haritanın üst kenarına karşılık gelen, gerçek kuzeyden itibaren derece cinsinden ölçülür. Haritanın merkezinden üst kenarına doğru dikey bir çizgi çizerseniz kerteriz, kameranın gerçek kuzeye göre yönüne (derece cinsinden ölçülür) karşılık gelir.

0 değeri, haritanın üst kısmının gerçek kuzeyi gösterdiği anlamına gelir. 90 derece yön değeri, haritanın üst kısmının tam doğuyu (pusulada 90 derece) gösterdiği anlamına gelir. 180 değeri, haritanın üst kısmının güneye doğru olduğunu gösterir.

Maps API, bir haritanın yönünü değiştirmenize olanak tanır. Örneğin, araba kullanan biri genellikle yol haritasını seyahat yönüyle aynı hizaya getirirken harita ve pusula kullanan yürüyüşçüler genellikle haritayı dikey bir çizgi kuzeyi gösterecek şekilde yönlendirir.

Eğme (görüş açısı)

Eğme, kameranın haritanın merkez konumunun doğrudan üzerinde bulunan bir yay üzerindeki konumunu tanımlar. Bu konum, nadir noktasından (kameranın doğrudan altına doğru bakan yön) itibaren derece cinsinden ölçülür. 0 değeri, doğrudan aşağıyı gösteren bir kameraya karşılık gelir. 0'dan büyük değerler, belirtilen derece sayısı kadar ufka doğru eğilmiş bir kameraya karşılık gelir. Görüş açısını değiştirdiğinizde harita, uzak özellikler daha küçük, yakındaki özellikler ise daha büyük görünecek şekilde perspektifli olarak gösterilir. Aşağıdaki resimlerde bu durum gösterilmektedir.

Aşağıdaki resimlerde görüntüleme açısı 0 derecedir. İlk resimde bunun şeması gösterilmektedir. 1 konumu kamera konumu, 2 konumu ise mevcut harita konumudur. Elde edilen harita, bunun altında gösterilir.

18 yakınlaştırma düzeyinde, 0 derece görüş açısıyla konumlandırılmış bir kameranın bulunduğu haritanın ekran görüntüsü.
Harita, kameranın varsayılan görüntüleme açısıyla gösterilir.
Kameranın varsayılan konumunu, doğrudan harita konumunun üzerinde 0 derecelik açıyla gösteren şema.
Kameranın varsayılan görüntüleme açısı.

Aşağıdaki resimlerde görüntüleme açısı 45 derecedir. Kameranın, 3 konumuna gelmek için doğrudan yukarı (0 derece) ile yer (90 derece) arasındaki bir yay boyunca yarıya kadar hareket ettiğini unutmayın. Kamera hâlâ haritanın merkez noktasını gösteriyor ancak 4 konumundaki çizgiyle gösterilen alan artık görünür durumda.

18 yakınlaştırma düzeyinde, 45 derecelik görüş açısıyla konumlandırılmış bir kameranın bulunduğu haritanın ekran görüntüsü.
45 derecelik bir görüntüleme açısıyla gösterilen harita.
Kameranın görüntüleme açısının 45 dereceye ayarlandığını ve yakınlaştırma düzeyinin 18 olarak kaldığını gösteren diyagram.
45 derecelik bir kamera görüş açısı.

Bu ekran görüntüsündeki harita, orijinal haritadakiyle aynı noktaya odaklanmaya devam ediyor ancak haritanın üst kısmında daha fazla özellik gösteriliyor. Açıyı 45 derecenin üzerine çıkardığınızda, kamera ile harita konumu arasındaki özellikler orantılı olarak daha büyük, harita konumunun ötesindeki özellikler ise orantılı olarak daha küçük görünür ve üç boyutlu bir efekt elde edilir.

Tarih aralığını

Kameranın yakınlaştırma düzeyi, haritanın ölçeğini belirler. Daha yüksek yakınlaştırma seviyelerinde ekranda daha fazla ayrıntı görülebilirken daha düşük yakınlaştırma seviyelerinde ekranda daha fazla yer görülebilir. Yakınlaştırma düzeyi 0 olduğunda haritanın ölçeği, tüm dünyanın yaklaşık 256 puan genişliğinde olacak şekildedir.

Yakınlaştırma düzeyini 1 artırmak, ekrandaki dünyanın genişliğini iki katına çıkarır. Bu nedenle, N yakınlaştırma düzeyinde dünyanın genişliği yaklaşık 256 * 2N noktadır. Örneğin, 2. yakınlaştırma düzeyinde tüm dünya yaklaşık 1.024 nokta genişliğindedir.

Yakınlaştırma düzeyi tam sayı olmak zorunda değildir. Haritanın izin verdiği yakınlaştırma düzeyleri, hedef, harita türü ve ekran boyutu gibi çeşitli faktörlere bağlıdır. Aralık dışındaki tüm sayılar, bir sonraki en yakın geçerli değere (minimum veya maksimum yakınlaştırma düzeyi) dönüştürülür. Aşağıdaki listede, her bir yakınlaştırma düzeyinde görmeyi bekleyebileceğiniz yaklaşık ayrıntı düzeyi gösterilmektedir:

  • 1: Dünya
  • 5: Ana kara/kıta
  • 10: Şehir
  • 15: Sokaklar
  • 20: Binalar
Aşağıdaki resimlerde farklı yakınlaştırma düzeylerinin görsel görünümü gösterilmektedir:
5 yakınlaştırma düzeyindeki bir haritanın ekran görüntüsü
5. yakınlaştırma düzeyindeki bir harita.
15 yakınlaştırma düzeyindeki bir haritanın ekran görüntüsü
15. yakınlaştırma düzeyinde bir harita.
20 yakınlaştırma düzeyinde bir haritanın ekran görüntüsü
20. yakınlaştırma düzeyinde bir harita.

İlk kamera konumunu ayarlama

Hedefin enlemini ve boylamını, yön, eğim ve yakınlaştırma ile birlikte ayarlamanıza olanak tanıyan GMSCameraPosition nesnesini kullanarak ilk kamera konumunu ayarlayın.

Başlangıçtaki kamera konumunu ayarlamak için GMSMapViewOptions nesnesi oluşturun ve camera özelliğini GMSCameraPosition olarak ayarlayın. Ardından seçeneklerinizi GMSMapView kolaylık oluşturucusuna iletin.

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];

GMSMapView nesnesini varsayılan UIView init yöntemiyle de oluşturabilirsiniz. Bu durumda, kamera konumu varsayılan konumdan başlar ve oluşturulduktan sonra değiştirilir.

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];

Kamera konumunu değiştirme

Konumu, yönü, eğimi ve yakınlaştırmayı ayarlamak için kamera konumunu programatik olarak değiştirebilirsiniz. GMSMapView, kamera konumunu değiştirmek için kullanabileceğiniz çeşitli yöntemler sunsa da genellikle GMSCameraPosition veya GMSCameraUpdate kullanılır:

  • GMSCameraPosition Hedef, yön, eğme ve yakınlaştırma gibi her kamera konumu parametresini değiştirmek için kullandığınız özellikleri ve yöntemleri içerir.

  • GMSCameraUpdate Hedefi, yönü, eğimi ve yakınlaştırmayı değiştirmenize olanak tanır. Ayrıca kaydırmayı, gelişmiş yakınlaştırmayı, kamerayı önceden tanımlanmış sınırlar içinde ortalamayı ve daha fazlasını desteklemek için ek kolaylık yöntemleri içerir.

Kamerayı hareket ettirdiğinizde, kamerayı yeni konuma "oturtmayı" (yani animasyon olmaması) veya hareketi animasyonla göstermeyi seçebilirsiniz. Örneğin, kameranın hedef konumunda bir değişikliği animasyonla gösterirseniz animasyon, önceki konumdan yeni konuma doğru kaydırılır.

Animasyon, mevcut kamera özellikleri ile yeni kamera özellikleri arasında enterpolasyon yapar. Animasyonun süresini Core Animation ile kontrol edebilirsiniz.

GMSCameraPosition hareketini kullanın

GMSCameraPosition ile kamerayı değiştirmek için yeni bir nesne oluşturur veya mevcut bir nesneyi kopyalayıp GMSMapView nesnesine yerleştirirsiniz. Kamerayı animasyonlu veya animasyonsuz olarak yeni konuma sabitlemek için GMSCameraPosition nesnesini kullanın.

Enlem, boylam, yakınlaştırma, yön ve görüş açısı gibi kamera özelliklerini yapılandırmak için GMSCameraPosition nesnesi kullanın. Ardından, GMSMapView öğesinin camera özelliğini ayarlamak için bu nesneyi kullanırsınız.

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];
      

Varsayılan değerine ayarlamak istediğiniz GMSCameraPosition özelliğini atlayın.

Hareketi canlandırmak için camera özelliğini ayarlamak yerine animateToCameraPosition: yöntemini kullanın.

GMSCameraUpdate hareketini kullanın

GMSCameraUpdate Kamera konumunu güncellemenize ve bu yeni konuma geçişin anlık mı yoksa animasyonlu mu olacağını seçmenize olanak tanır. GMSCameraUpdate kullanmanın avantajı kolaylık sağlamasıdır. GMSCameraPosition ile GMSCameraUpdate ile aynı görevleri gerçekleştirebilirsiniz ancak GMSCameraUpdate, kamerayı kullanmayı kolaylaştırmak için ek yardımcı yöntemler sağlar.

Örneğin, geçerli yakınlaştırma düzeyini artırmak için GMSCameraPosition öğesini kullanmak istiyorsanız önce geçerli yakınlaştırma düzeyini belirlemeniz, ardından yakınlaştırmayı geçerli yakınlaştırmadan bir fazla değere ayarladığınız bir GMSCameraPosition nesnesi oluşturmanız gerekir.

Alternatif olarak, zoomIn: yöntemiyle bir GMSCameraUpdate nesnesi oluşturun. Ardından, GMSCameraUpdate nesnesini GMSMapView animateWithCameraUpdate: yöntemine ileterek kamerayı güncelleyin.

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];
      

Bunun yerine kamerayı yeni konuma sabitlemek için GMSMapView moveCamera: yöntemini kullanın.

Bir sonraki örnekte, kameranın Vancouver'ı ortalayacak şekilde hareketini canlandırmak için GMSCameraUpdate kullanıyorsunuz.

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 nesnesi oluşturma

Yöntemlerinden birini kullanarak bir GMSCameraUpdate nesnesi oluşturun.

zoomIn: ve zoomOut:
Diğer tüm özellikleri aynı tutarak mevcut yakınlaştırma düzeyini 1, 0 değiştirin.
zoomTo:
Diğer tüm özellikler aynı kalırken yakınlaştırma düzeyini belirtilen değere değiştirir.
zoomBy:
Yakınlaştırma düzeyini, belirtilen değer kadar artırır (veya değer negatifse azaltır).
zoomBy:atPoint:
Belirtilen noktanın ekrandaki konumunu korurken yakınlaştırma düzeyini verilen değer kadar artırır (veya değer negatifse azaltır).
setTarget:
Diğer tüm özellikleri korurken kameranın enlemini ve boylamını değiştirir.
setTarget:zoom:
Diğer tüm özellikleri korurken kameranın enlemini, boylamını ve yakınlaştırmasını değiştirir.
setCamera:
Yeni bir GMSCameraPosition ayarlar.
scrollByX:Y:
Haritayı belirtilen nokta sayısı kadar hareket ettirmek için kameranın enlemini ve boylamını değiştirir. Pozitif bir x değeri, kameranın sağa hareket etmesine neden olur. Bu nedenle, harita sola hareket etmiş gibi görünür. Pozitif bir y değeri, kameranın aşağı hareket etmesine neden olur. Bu nedenle harita yukarı hareket etmiş gibi görünür. Kaydırma, kameranın mevcut yönüne göre yapılır. Örneğin, kameranın yönü 90 derece ise doğu "yukarı"dır.
fitBounds:
Kamerayı, belirtilen sınırları ekranda mümkün olan en yüksek yakınlaştırma düzeyinde ortalayacak şekilde dönüştürür. Sınırlara 64 puanlık varsayılan bir dolgu uygular.
fitBounds:withPadding:
Kamerayı, belirtilen sınırları mümkün olan en yüksek yakınlaştırma düzeyinde ekranda ortalayacak şekilde dönüştürür. Sınırlayıcı kutunun tüm kenarları için aynı dolguyu (puan cinsinden) belirtmek üzere bu yöntemi kullanın.
fitBounds:withEdgeInsets:
Kamerayı, belirtilen sınırları mümkün olan en yüksek yakınlaştırma düzeyinde ekranda ortalayacak şekilde dönüştürür. UIEdgeInsets ile sınırlayıcı kutunun her tarafı için ayrı ayrı dolgu belirtirsiniz.

Tek bir özelliği değiştirmek için GMSMapView seçeneğini kullanın.

GMSMapView, GMSCameraPosition veya GMSCameraUpdate nesnesi kullanmadan kamerayı hareket ettirmenize olanak tanıyan çeşitli yöntemler sunar. animateToLocation: veya animateToZoom: gibi bu yöntemlerle tek bir kamera özelliğinde yapılan değişikliği canlandırabilirsiniz.

Örneğin, kamera eğimindeki bir değişikliği canlandırmak için toViewingAngle: yöntemini kullanın.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Hedefi (konum) ayarlama

Konum, haritanın merkezini belirler. Konumlar enlem ve boylam ile belirtilir ve CLLocationCoordinate2DMake ile oluşturulan CLLocationCoordinate2D ile programatik olarak gösterilir.

Konumu değiştirmek için GMSCameraPosition simgesini kullanın. Bu örnekte, harita yeni konuma yerleşir.

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];
      

Değişikliği canlandırmak ve haritayı yeni konuma kaydırmak için camera özelliğini ayarlamak yerine animateToCameraPosition: yöntemini kullanabilirsiniz. Alternatif olarak, GMSMapView üzerinde animateToLocation: yöntemini kullanın.

Swift

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
      

Objective-C

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
      

Kamerayı hareket ettirmek için GMSCameraUpdate nesnesi de oluşturabilirsiniz. X ve Y yönlerinde kaydırılacak nokta sayısını belirtmek için scrollByX:Y: adlı yerleşik yöntemini kullanın. Bu örnekte, kamerayı 200 nokta sağa ve 100 nokta aşağı kaydırıyorsunuz:

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];
      

Rulmanı (yönü) ayarlama

Rulman, haritanın üst kenarı için gerçek kuzeyden derece cinsinden ölçülen pusula yönüdür. Örneğin, 90 derecelik bir kerteriz, üst kenarı doğuya bakan bir harita oluşturur.

GMSCameraPosition veya GMSCameraUpdate ile ya da GMSMapView'ün animateToBearing: yöntemiyle yönü programatik olarak ayarlayın.

Swift

mapView.animate(toBearing: 0)
      

Objective-C

[mapView animateToBearing:0];
      

Eğme açısını (izleme açısı) ayarlama

Görüş açısı, kameranın doğrudan haritanın merkez konumunun üzerinde ve Dünya'nın yüzeyinde bulunan bir yay üzerindeki konumudur. Bu açı, nadir noktasından (kameranın doğrudan altına doğru bakan yön) itibaren derece cinsinden ölçülür. Görüş açısını değiştirdiğinizde harita perspektifli olarak görünür. Kamera ile harita konumu arasındaki özellikler orantılı olarak daha büyük, harita konumunun ötesindeki özellikler ise orantılı olarak daha küçük görünür. Bu da üç boyutlu bir efekt oluşturur.

Görüntüleme açısı 0 (doğrudan haritaya bakma) ile yakınlaştırma düzeyine bağlı maksimum değer arasında değişebilir. Yakınlaştırma düzeyi 16 veya daha yüksek olduğunda maksimum açı 65 derecedir. Yakınlaştırma düzeyi 10 veya daha düşük olduğunda maksimum açı 30 derecedir.

GMSCameraPosition veya GMSCameraUpdate kullanarak ya da GMSMapView'ün animateToViewingAngle: yöntemiyle görüntüleme açısını programatik olarak ayarlayın.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Yakınlaştırmayı ayarlama

Kameranın yakınlaştırma düzeyi, haritanın ölçeğini belirler. Daha yüksek yakınlaştırma seviyelerinde ekranda daha fazla ayrıntı görebilirsiniz. Daha düşük yakınlaştırma seviyelerinde ise dünyayı daha geniş bir açıdan görebilirsiniz.

Yakınlaştırmayı GMSCameraPosition veya GMSCameraUpdate ile ya da GMSMapView'ün animateToZoom: yöntemiyle programatik olarak ayarlayın.

Swift

mapView.animate(toZoom: 12)
      

Objective-C

[mapView animateToZoom:12];
      

Aşağıdaki örnekte, geçerli düzeyden bir düzey yakınlaştırma animasyonu yapmak için GMSCameraUpdate nesnesi oluşturmak üzere zoomIn: yöntemi kullanılmaktadır.

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];
      

Sınırları belirleme

Kamerayı, ilgi alanının tamamı mümkün olan en yüksek yakınlaştırma düzeyinde görünecek şekilde hareket ettirmek için kamera görünümü sınırlarını ayarlayın. Örneğin, kullanıcının mevcut konumuna beş mil mesafedeki tüm benzin istasyonlarını göstermek istiyorsanız kamerayı hepsinin ekranda görüneceği şekilde hareket ettirin:

  1. Ekranda görünmesini istediğiniz GMSCoordinateBounds değerini hesaplayın.
  2. Yeni bir GMSCameraPosition döndürmek için cameraForBounds:insets: GMSMapView yöntemini kullanın.

Bu sınırları, verilen GMSCoordinateBounds'nın mevcut haritanın boyutuna tamamen sığacak şekilde ayarlayın. Bu yöntemin, haritanın eğimini ve yönünü 0 olarak ayarladığını unutmayın.

Aşağıdaki örnekte, Vancouver ve Calgary şehirlerinin aynı görünümde yer alması için kameranın nasıl değiştirileceği gösterilmektedir.

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;
      

Kullanıcının kaydırmasını belirli bir alanla kısıtlama

Bu senaryolar haritanın sınırlarını belirler ancak kullanıcı daha sonra bu sınırların dışında kaydırabilir veya hareket ettirebilir. Bunun yerine, kullanıcıların yalnızca bu sınırlar içinde kaydırıp yakınlaştırabilmesi için haritanın odak noktasının (kamera hedefi) koordinat merkezi sınırlarını kısıtlamak isteyebilirsiniz.

Örneğin, bir alışveriş merkezi veya havaalanı için perakende uygulaması, haritayı belirli sınırlar içinde tutmak isteyebilir. Böylece kullanıcılar bu sınırlar içinde kaydırabilir ve yakınlaştırabilir.

Kaydırmayı belirli sınırlar içinde tutmak için cameraTargetBounds özelliğini, gerekli sınırları tanımlayan bir GMSCoordinateBounds nesnesine ayarlayın.GMSMapView Kısıtlamayı daha sonra kaldırmak için cameraTargetBounds değerini nil olarak ayarlayın.

Swift

mapView.cameraTargetBounds = bounds
      

Objective-C

mapView.cameraTargetBounds = bounds;
      

Aşağıdaki şemada, kamera hedefinin görüntü alanından biraz daha büyük bir alanla sınırlandırıldığı bir senaryo gösterilmektedir. Kamera hedefi sınırlı alan içinde kaldığı sürece kullanıcı kaydırma ve yakınlaştırma yapabilir. Çapraz, kamera hedefini temsil eder:

Görüntü alanından daha büyük bir kamera sınırını gösteren diyagram.

Harita, görüntü alanı tanımlanmış sınırlar dışında kalan alanları gösterse bile her zaman görüntü alanını doldurur. Örneğin, kamera hedefini sınırlı alanın bir köşesine yerleştirirseniz köşenin ötesindeki alan görüntü alanında görünür ancak kullanıcılar bu alana daha fazla kaydıramaz. Aşağıdaki diyagramda bu senaryo gösterilmektedir. Çapraz, kamera hedefini temsil eder:

Kamera hedefinin, kamera sınırlarının sağ alt köşesinde konumlandırıldığını gösteren şema.

Aşağıdaki şemada, kamera hedefinin sınırları çok kısıtlıdır ve kullanıcıya haritayı kaydırma veya yakınlaştırma için çok az fırsat sunar. Çapraz, kamera hedefini gösterir:

Görünüm alanından daha küçük bir kamera sınırlarını gösteren diyagram.

Minimum veya maksimum yakınlaştırma ayarlama

kGMSMinZoomLevel ve kGMSMaxZoomLevel genel sabitleri, minimum veya maksimum yakınlaştırma değerlerini tanımlar. Varsayılan olarak, GMSMapView öğesinin minZoom ve maxZoom özellikleri bu sabitlere ayarlanır.

Haritada kullanılabilen yakınlaştırma düzeylerinin aralığını kısıtlamak için minimum ve maksimum yakınlaştırma düzeyi ayarlayın. Aşağıdaki kod, yakınlaştırma düzeyini 10 ile 15 arasında olacak şekilde kısıtlar.

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];
      

Yakınlaştırma aralığını setMinZoom:maxZoom: yöntemiyle ayarlamanız gerekir. Ancak minZoom ve maxZoom özelliklerini kullanarak mevcut değerleri okuyabilirsiniz. Bu yaklaşım, yalnızca değerlerden birini kısıtlamak istediğinizde faydalıdır. Aşağıdaki kod yalnızca minimum yakınlaştırma düzeyini değiştirir.

Swift

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
      

Objective-C

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
      

Minimum ve maksimum yakınlaştırma güncellendikten sonra kameranın yakınlaştırma düzeyi yeni aralığın dışında bir değere ayarlanırsa geçerli yakınlaştırma, en yakın geçerli değeri gösterecek şekilde otomatik olarak güncellenir. Örneğin, aşağıdaki kodda orijinal yakınlaştırma 4 olarak tanımlanmıştır. Yakınlaştırma aralığı daha sonra 10-15 olarak ayarlandığında mevcut yakınlaştırma 10 olarak güncellenir.

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];