Add an Apple Map Widget to a PDF Page in Swift for iOS

1
//
2
//  Copyright © 2018-2025 PSPDFKit GmbH. All rights reserved.
3
//
4
//  The Nutrient sample applications are licensed with a modified BSD license.
5
//  Please see License for details. This notice may not be removed from this file.
6
//
7

8
import MapKit
9
import PSPDFKit
10
import PSPDFKitUI
11

12
class MapWidgetExample: Example, PDFViewControllerDelegate {
13

14
    override init() {
15
        super.init()
16

17
        title = "Page with Apple Maps Widget"
18
        category = .viewCustomization
19
        priority = 50
20
    }
21

22
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController {
23
        let document = AssetLoader.document(for: .annualReport)
24
        document.annotationSaveMode = .disabled
25

26
        // This annotation could be already in the document - we just add it programmatically for this example.
27
        let linkAnnotation = LinkAnnotation(url: URL(string: "map://37.7998377,-122.400478,0.005,0.005")!)
28
        linkAnnotation.linkType = .browser
29
        linkAnnotation.boundingBox = CGRect(x: 100, y: 100, width: 300, height: 300)
30
        linkAnnotation.pageIndex = 0
31
        document.add(annotations: [linkAnnotation])
32

33
        let pdfController = PDFViewController(document: document, delegate: self) {
34
            $0.thumbnailBarMode = .none
35
        }
36
        return pdfController
37
    }
38

39
    // MARK: PDFViewControllerDelegate
40

41
    internal func pdfViewController(_ pdfController: PDFViewController, annotationView: (UIView & AnnotationPresenting)?, for annotation: Annotation, on pageView: PDFPageView) -> (UIView & AnnotationPresenting)? {
42
        if let linkAnnotation = annotation as? LinkAnnotation {
43
            // example how to add a MapView with the url protocol map://lat,long,latspan,longspan
44
            if linkAnnotation.linkType == .browser, let urlString = linkAnnotation.url?.absoluteString, urlString.hasPrefix("map://") {
45

46
                // parse annotation data
47
                let mapString = urlString.replacingOccurrences(of: "map://", with: "")
48
                let mapTokens = mapString.components(separatedBy: ",")
49

50
                // ensure we have mapTokens count of 4 (latitude, longitude, span la, span lo)
51
                if mapTokens.count == 4,
52
                    let latitude = Double(mapTokens[0]),
53
                    let longitude = Double(mapTokens[1]),
54
                    let latspan = Double(mapTokens[2]),
55
                    let longspan = Double(mapTokens[3]) {
56

57
                    let location = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
58

59
                    let span = MKCoordinateSpan(latitudeDelta: latspan, longitudeDelta: longspan)
60

61
                    // frame is set in PDFViewController, but MKMapView needs the position before setting the region.
62
                    let frame = annotation.boundingBox(forPageRect: pageView.bounds)
63

64
                    let mapView = MapView(frame: frame)
65
                    mapView.setRegion(MKCoordinateRegion(center: location, span: span), animated: false)
66
                    return mapView
67
                }
68
            }
69
        }
70
        return annotationView
71
    }
72
}
73

74
// This class is needed since we can't simply add a protocol to an object in Swift, so we need to use a subclass for our mapView here
75
private class MapView: MKMapView, AnnotationPresenting {}