Adding custom overlays

Adding custom map overlays

Oftentimes you'll want to display your custom data on the map managed by AWFWeatherMap, such as custom annotations and/or overlays. However, since your AWFWeatherMap instance must remain the map view's delegate to retain the built-in weather layer functionality, you cannot change the map view's delegate.

Fortunately, all delegate methods associated with your chosen mapping strategy (e.g. Apple Maps/MapKit, Google Maps or Mapbox) will get forwarded to the delegate you assign on AWFWeatherMap's mapViewDelegate property. This allows you to use the map view managed by your AWFWeatherMap instance as you typically would when interacting with the native map view instance directly outside of our SDK.

To add custom overlays to your AWFWeatherMap instance, just set the mapViewDelegate property and add your overlays by accessing the map strategy and implementing the necessary map delegate methods as required by your chosen mapping library (e.g. MKMapViewDelegate when using the default of Apple Maps):

import UIKit
import AerisWeatherKit
import AerisMapKit
class CustomOverlay: NSObject, MKOverlay {
    var coordinate: CLLocationCoordinate2D
    var boundingMapRect: MKMapRect
    init(bounds: MKMapRect) {
        boundingMapRect = bounds
        let region = MKCoordinateRegionForMapRect(bounds)
        coordinate = region.center
class CustomMapViewController: AWFWeatherMapViewController {
    override func viewDidLoad() {
        // our controller will receive MKMapViewDelegate events
        weatherMap.mapViewDelegate = self
        // add custom overlay
        let origin = MKMapPoint(x: 43521794.381855115, y: 93767182.83934316)
        let size = MKMapSize(width: 197934.4362897724, height: 198543.5568140447)
        let overlay = CustomOverlay(bounds: MKMapRect(origin: origin, size: size))
extension CustomMapViewController: MKMapViewDelegate {
    func mapView(_ mapView: MKMapView, rendererFor overlay: MKOverlay) -> MKOverlayRenderer {
        if let overlay = overlay as? CustomOverlay {
            // return a custom overlay renderer or MKOverlayRenderer subclass
            return MKOverlayRenderer(overlay: overlay)
        } else if let strategy = weatherMap.strategy as? AWFAppleMapStrategy {
            // fall back to the built-in AWFWeatherMap functionality for the overlay
            return strategy.defaultRenderer(forOverlay: overlay)
        return MKOverlayRenderer(overlay: overlay)