Author: Eric Tatham

Visions of Leicester App

Apps

This App is based on the book ‘Visions of Ancient Leicester’ by Mathew Morris and Richard Buckley of the University of Leicester Archaeological Services (ULAS). The artist Mike Codd was commissioned to prepare a series of reconstruction drawings of the town and many of its most important buildings for inclusion in the book.

The App is intended as an accompaniment to the book, presenting some of its contents in interactive form.

The App incorporates material from the book consisting of four sections covering Iron Age, Roman, Anglo Saxon and Medieval periods, with descriptions of archaeological sites. There are also four associated archaeological maps graphically superimposed on modern-day Leicester.

The text pages and maps are linked dynamically. Clicking on a map marker, takes you to the relevant description and, from each page of text, clicking on the map icon, displays the associated map.

Although maps are presented for all four eras, the textual descriptions focus on the Roman and Medieval periods about which more is known.

highcross1

The free App is downloadable for iPhone or iPad at Apple’s App Store

Creating tiled overlays with MKTileOverlay and Swift

iOS Development

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 (maptiler.com) 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() {
    super.viewDidLoad()
    self.mapView.delegate=self;
    self.configureView()
}


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

    //Get the URL template to the map tiles
    let baseURL = NSBundle.mainBundle().bundleURL.absoluteString
    let urlTemplate = baseURL?.stringByAppendingString("/Map1880/
                                              {z}/{x}/{y}.png/")

    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
    self.mapView.addOverlay(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)
    self.mapView.regionThatFits(region)
}

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.

Update:

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.