Sitemap

MapKit Framework

4 min readSep 23, 2024

--

Herkese merhaba bugün sizlere MapKit Framework ünden bahsedeceğim.

MapKit Nedir?

MapKit, geliştiricilerin uygulamalarını doğrudan haritalar entegre etmelerini sağlayan bir Apple framework’üdür. Yani aslında haritalarla ilgili aklınıza gelen belki günlük hayatınızda kullandığınız her şeyi MapKit aracılığıyla yapabiliyoruz diyebiliriz.

MapKit ile neler yapabiliriz?

Günlük hayatımızda kullandığımız her şeyi MapKit aracılığıyla yapıyoruz dedik. Bunların da şöyle bir bahsetmek isterim böylece MapKit’in özelliklerine de değinmiş olacağım.

  • Harita ve uydu görünümleri
  • Anotasyonlar ve kaplamalar
  • Kullanıcı konum takibi
  • Rotalar ve yönlendirmeler

Bu özelliklerden yola çıkarsak olası kullanım alanlarını da şunlardır:

  • Konum tabanlı hizmetler
  • Navigasyon uygulamaları
  • Etkinlik ve mağaza bulucular

MapKit ile örnek bir proje hazırlayalım

Şimdi bu özellikleri örnek bir proje üzerinde göstermenin vakti geldi. Projede bahsedeceğim konular harita görünümü, anotasyon ekleme, kullanıcı konumu yönetme, kaplamalar, yönlendirmeler ve rota çizme, özel anotasyonlar olarak olacaktır.

İlk olarak Mapkit’ projeye import ederek başlıyoruz.

import MapKit
import CoreLocation

Günümüzde bir harita uygulaması konum servisleri olmadan düşünülemez bu yüzden CoreLocation da ekliyoruz. Zaten ileride bahsedeceğim gibi bu iki framework birbiriyle sıkı bir iletişim içerisinde çalışmaktadır.

 var mapView : MKMapView = {
let mapView = MKMapView()
return mapView
}()

let locationManager = CLLocationManager()

MapView’i ve locationManager’ı tanımlayıp delegelerini verdikten sonra MapKit’in özelliklerini kullanmaya yavaş yavaş başlayabiliriz.

Öncelikle oluşturduğumuz map içinde map’i ihtiyaçlarımıza göre düzenlememiz mümkün

  mapView.showsUserLocation = true
mapView.showsUserTrackingButton = true
mapView.mapType = .hybrid

mapView.showsUserLocation’i true ya çekerek ve eklediğimiz coreLocation sayesinde hiç bir zahmete katlanmadan bulunduğumuz konumun harita üzerinde gösterilmesini sağlayabiliriz. Bunun dışında harita üzerinde konum butonu ekleme, harita tipini değiştirme gibi düzenlemeleri bu şekilde yapabiliyoruz.

Get Mert Gürcan’s stories in your inbox

Join Medium for free to get updates from this writer.

Uygulamayı çalıştırdıktan sonra CLLocationManager delege methodlarına didUpdate ile konum bilgilerini çekmeye başlayıp mapkit üzerinden işlem yapabiliriz.

func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
if let location = locations.first {
self.myLocation = CLLocationCoordinate2D(latitude: location.coordinate.latitude, longitude: location.coordinate.longitude)
let span = MKCoordinateSpan(latitudeDelta: span, longitudeDelta: span)
let region = MKCoordinateRegion(center: location.coordinate, span: span)
mapView.setRegion(region, animated: true)
// mapView.setCenter(annotation.coordinate, animated: true)
}
}

setRegion ile bir alan görüntülemek ve alan üzerine istediğimiz bir yakınlaştırma yapmak mümkün. Eğer yakınlaştırmayı değiştirmek istemiyorsak setCenter ı da kullanabiliriz.

Eğer bir alan işaretlemek istiyorsak bunu da MapKit ile çok kolay.

let circle = MKCircle(center: CLLocationCoordinate2D(latitude: 39.920829, longitude: 32.853879), radius: 2500)
mapView.addOverlay(circle)

MapKit ile bir alanı yuvarlak içine almak bu kadar kolay. Sadece dairenin merkezinin koordinatlarını ve yarıçapı metre cinsinde girmemiz yeterli. Fakat overlay olarak eklediğimiz bu dairenin gözükebilmesi için render edilmesi gerekiyor. Bunun için delege metodlarını kullanacağız.

func mapView(_ mapView: MKMapView, rendererFor overlay: MKOverlay) -> MKOverlayRenderer {
if let circleOverlay = overlay as? MKCircle {
let circleRenderer = MKCircleRenderer(circle: circleOverlay)
circleRenderer.fillColor = UIColor.blue.withAlphaComponent(0.3)
circleRenderer.strokeColor = UIColor.blue
circleRenderer.lineWidth = 2
return circleRenderer
}
return MKOverlayRenderer()
}

Render ettikten sonra Mapkit’in belirlediğimiz alanı daire içine aldığını görebiliriz.

Mapkit ile anotasyon oluşturmak da çok kolay.

let annotation = MKPointAnnotation()
annotation.coordinate = coordinate
annotation.title = "Anıtkabir"
annotation.subtitle = "Mustafa Kemal Atatürk"
mapView.addAnnotation(annotation)
mapView.showAnnotations([annotation], animated: true)

addAnotation ile oluşturduğumuz anotasyonları map e ekledikten sonra göstermek istediğimiz anotasyonları de show anotations ile harita üzerinde görünür kılmak mümkün

Fakat bu anotasyonlar MapKit’in default belirlediği şekilde gözükmekte. Tabii ki bizim bunu delege methodları ile değiştirebilmemiz mümkün.

 func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
if annotation is MKUserLocation {
return nil
}

if let title = annotation.title, title == "Anıtkabir" {
var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: "annotationview")
if annotationView == nil {
annotationView = MKAnnotationView(annotation: annotation, reuseIdentifier: "annotationview")
} else {
annotationView?.annotation = annotation
}

annotationView?.image = UIImage(named: "turkey")

return annotationView
}
return nil
}

Methodun içinde belirlediğimiz anotasyonun gösterimini türk bayrağı ile değiştirmek ve harita üzerindeki diğer görünümlere ellemeden bunu yapmak için ihtiyacımız olan kod satırını yazdıktan sonra anotasyonun değiştiğini görüyoruz.

Haritalar uygulamasında yapabildğimiz her şeyi mapkit ile yapabiliyoruz demiştik. Buna tabii ki mekan arama da giriyor ve Mapkit bunun da üstesinden geliyor.

let searchRequest = MKLocalSearch.Request()
searchRequest.naturalLanguageQuery = "Bar"

let search = MKLocalSearch(request: searchRequest)
search.start { response, error in
guard let response = response else {
print("Arama sonucu yok")
return
}
for mapItem in response.mapItems {
let annotation = MKPointAnnotation()
annotation.coordinate = mapItem.placemark.coordinate
annotation.title = mapItem.name
self.mapView.addAnnotation(annotation)
}
}

Bir LocalSearch request i oluşturup bunu MKLocalSearch içine parametre olarak verdikten sonra search’i başlatıyoruz ve bulduğumuz sonuçları anotasyon olarak map’e ekliyoruz. Konumumuza göre bize en yakın yerleri harita üzerinde gösterdiğiniz göreceksiniz.

Harita üzerinde bir çok işleme göz attık fakat belki de çoğumuz için en kritik özellik olan yol tarifine daha değinmedik. Şimdi sizlere Mapkit üzerinde bunu nasıl kolay bir şekilde yapabildiğimiz anlatacağım.

let myLocation = CLLocationCoordinate2D(latitude: 39.920829, longitude: 32.853879)
let airport = CLLocationCoordinate2D(latitude: 40.114872, longitude: 32.993373)

let request = MKDirections.Request()
request.source = MKMapItem(placemark: MKPlacemark(coordinate: myLocation))
request.destination = MKMapItem(placemark: MKPlacemark(coordinate: airport))
request.transportType = .any
request.requestsAlternateRoutes = false
let directions = MKDirections(request: request)
directions.calculate { response, error in
guard let response = response else { return }
for route in response.routes {
self.mapView.addOverlay(route.polyline)
let adjustedMapRect = route.polyline.boundingMapRect.insetBy(dx: -route.polyline.boundingMapRect.size.width * ((1.3 - 1) / 2),
dy: -route.polyline.boundingMapRect.size.height * ((1.3 - 1) / 2))
self.mapView.setVisibleMapRect(adjustedMapRect, animated: true)
}
}

Yukarıdaki kod parçasında da göreceğiniz gibi direction için bir request oluşturmakla başlıyoruz. Bu request’i ihtiyaçlarımıza göre düzenleyebilmemiz mümkün. Gerekli ayarlamaları yaptıktan sonra request i parametre olarak verip calculate ile iki koordinat arası en uygun rotayı çıkardığını görüyoruz. Çıkan sonucu overlay olarak harita üzerine ekliyoruz fakat daha önceden de yazdığım gibi overlay olarak eklenenleri render etmemiz gerekiyor bunu unutmayalım.

Renderer i da hazırladıktan sonra setVisibleMapRect diyerek bize dönen x,y değerlerini harita üzerinde çiziyoruz. Bu sefer koordina yerine x,y değerleri ile uğraştık farkındaysanız ve evet bu şekilde de map üzerinde bir şeyler yapabilmek mümkün.

Sonuç

MapKit harita üzerinde esnek ve kolay çözümleri ile geliştiricilere büyük kolaylık sağlıyor. Haritalar ile geliştirebileceğiniz güzel fikirler bulmanız dileğiyle :D

--

--