Creating tiled overlays with MKTileOverlay and Swift

Here’s how to create a tiled map overlay using iOS MKTileOverlay and MKTileOverlayRenderer.

First, you need a set of tiled map images to overlay.  MapTiler ( is great for producing these from your own images. Specify the image bounds in terms of latitude and longitude; North, South, East, West to locate it in the world. The map tiles are then exported in folders named for zoom level and x and y tile coordinates.  For example, my folder, covering the town of Glossop in the UK, is called Map1880 and contains subfolders 12, 13, 14, 15, 16 each containing image tile sets for these zoom levels. For my particular overlay, inside folder 15 I have seven subfolders each representing the tile row (i.e. x coordinates); 16202 to 16208. Inside each of these are the PNG image files, named with tile column numbers (i.e. y coordinates); e.g. 22160.png and 22161.png shown here.

22160       22161

Add the top folder to your XCode project, making sure “Copy items if needed” is ticked and “Create folder references” selected. The folder should appear in blue in the Project Navigator.

In your ViewController, make sure you have a MapView, import MapKit and make subclass of MKMapViewDelegate.

import MapKit

class DetailViewController: UIViewController, MKMapViewDelegate {
    @IBOutlet var mapView: MKMapView!


In viewDidLoad() set the delegate and configure the overlay. Confusingly there seems to be two ways of specifying the tile y coordinates; either counting from the North or counting from the South. Using an older version of MapTiler I found that the y coordinates were not generated the same way round as Apple Maps so had to flip the y coordinates.

Also note that I am using a subclass of MKTileOverlay here simply so I can apply different alpha values to subsequent overlays.

override func viewDidLoad() {

func configureView() {
    self.mapView.mapType = MKMapType.Satellite

    //Get the URL template to the map tiles
    let baseURL = NSBundle.mainBundle().bundleURL.absoluteString
    let urlTemplate = baseURL?.stringByAppendingString("/Map1880/

    var overlay = MyTileOverlay(URLTemplate:urlTemplate)

    //Need to flip maps generated with MapTiler
    overlay.geometryFlipped = true

    //Don't want to replace underlying Apple map
    overlay.canReplaceMapContent = false
    //Set the overlay transparency
    overlay.alpha = 0.7

    //Add the overlay


func recentreMap() {

    //Map centre on Glossop UK
    let centre = CLLocationCoordinate2D(latitude: 53.4435,
                                              longitude: -1.95)

     //Declare span of map
    let span = MKCoordinateSpan(latitudeDelta: 0.03, 
                                      longitudeDelta: 0.03)

    //Set region of the map
    let region = MKCoordinateRegion(center: centre, span: span)
    self.mapView.setRegion(region, animated: false)

mapView is called on delegate when tiles need displaying

func mapView(mapView: MKMapView!, rendererForOverlay overlay: 
                            MKOverlay!) -> MKOverlayRenderer! {

    if overlay is MKTileOverlay {
        var renderer = MKTileOverlayRenderer(overlay:overlay)
        //Set the renderer alpha to be overlay alpha
        renderer.alpha = (overlay as MyTileOverlay).alpha

        return renderer
    return nil

As stated above, I am using a subclass of MKTileOverlay simply so I can set overlays with different alpha values.

import Foundation
import MapKit

//This subclass was created to set alpha and for debug purposes
//Can set break point and check tile zoo, x, and y being accessed

class MyTileOverlay : MKTileOverlay {
    var alpha: CGFloat = 1.0

    override func loadTileAtPath(path: MKTileOverlayPath, 
                  result: ((NSData!, NSError!) -> Void)!) {

         super.loadTileAtPath(path, result)

         //Set breakpoint or write out path for debug
         NSLog("Inside load") 

The override of loadTileAtPath() is included as I set a breakpoint at NSLog() to view the path string. I did this when trying to discover why my map overlay wasn’t displaying and found the y coordinate flip problem identified above.


The above code works but does appear to have a problem in that the renderer tries to load overlay tiles for the whole region in view even when the tile image files do not exist because they are outside the overlay map area. This results in logging of a stream of error messages. This needs looking into when I have time. In the meantime if anyone knows a good way of solving this then please let me know.

8 thoughts on “Creating tiled overlays with MKTileOverlay and Swift

  1. Thanks to User: junkpile on Apple Developer Forum, the problem with attempting to load non-existent overlay tiles is that boundingMapRect is set to MKMapRectWorld, i.e. the whole world, by default. To restrict this to the required overlay region, subclass MKTileOverlay.

    Here’s an example:

    import MapKit
    class CustomTileOverlay : MKTileOverlay {

    override var boundingMapRect: MKMapRect {
    get {
    //North-East Corner of region
    let lat1 = 53.46075
    let long1 = -1.92618
    //South-West Corner of region
    let lat2 = 53.43018
    let long2 = -1.992885

    //Convert to Coordinates
    let coord1 = CLLocationCoordinate2DMake(lat1,long1)
    let coord2 = CLLocationCoordinate2DMake(lat2,long2)

    //Convert to map points
    let p1 = MKMapPointForCoordinate (coord1);
    let p2 = MKMapPointForCoordinate (coord2);

    //Return the MKMapRect
    return MKMapRectMake(fmin(p1.x,p2.x), fmin(p1.y,p2.y), fabs(p1.x-p2.x), fabs(p1.y-p2.y));

    1. Colin
      Use subclass CustomTileOverlay class instead of MKTileOverlay.
      Please bear in mind that my original post is now nearly two years old and Apple revises things regularly. I haven’t revisited it to check.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s