Apple MapKit Integration 是一个帮助开发者在 iOS、macOS 与 visionOS 应用中集成 Apple MapKit 的技能，支持 SwiftUI 与 UIKit 两种实现方式。该技能面向需要在地图相关功能上进行开发的场景，提供从基础地图显示到地点搜索、路线导航的常见工作流参考。
在技术选型上，技能默认建议新项目使用 SwiftUI（iOS 17+），同时为较旧的目标平台或特定需求提供 UIKit 方案。它包含完整的 API 文档引用，可通过 references/MapKit.md 查阅完整 MapKit API 细节。
主要能力覆盖多个常见地图开发任务：
一、显示基础地图。SwiftUI 可使用 Map() 直接呈现地图，也可通过 MapCameraPosition 设置初始区域与中心坐标；UIKit 则通过 MKMapView 设置 frame、autoresizingMask 以及 MKCoordinateRegion 来展示指定区域。
二、显示用户位置。技能强调需在 Info.plist 中添加 NSLocationWhenInUseUsageDescription。SwiftUI 可使用 .userLocation(fallback:) 配合 UserAnnotation() 与 MapUserLocationButton、MapCompass 等控件；UIKit 需通过 CLLocationManager 请求授权，并在授权后设置 showsUserLocation 与 userTrackingMode。
三、添加标注与标记。SwiftUI 可使用 Marker 或自定义 Annotation 内容来展示地点；UIKit 通过实现 MKAnnotation 协议并使用 addAnnotation 添加标注。
四、标注聚合。SwiftUI 可借助 MapContentBuilder 与 .annotationTitles(.hidden) 实现聚合行为，UIKit 则通过 MKClusterAnnotation，并在 mapView(_:viewFor:) 中设置 clusteringIdentifier 启用自动聚合，同时可对聚合视图设置 markerTintColor 与 glyphText 展示成员数量。
五、路线与导航。使用 MKDirections.Request 设置起点、终点与交通方式，计算后可在 SwiftUI 中以 MapPolyline 绘制路线，或在 UIKit 中通过 addOverlay 添加折线并实现 rendererFor 方法进行渲染。
六、本地地点搜索。使用 MKLocalSearch.Request 结合 naturalLanguageQuery 与 region 执行搜索；也可使用 MKLocalSearchCompleter 实现自动补全，并设置 resultTypes 过滤地址与兴趣点。
七、地图覆盖物。SwiftUI 支持 MapPolyline、MapCircle、MapPolygon 绘制折线、圆与多边形，并设置描边与填充样式。
八、地图配置。SwiftUI 可设置 mapStyle（standard、imagery、hybrid 等）与 mapControls（用户位置按钮、指南针、比例尺、俯仰切换）；UIKit 可配置 mapType、showsCompass、showsScale 以及缩放、滚动、俯仰、旋转等交互开关。
技能还列出关键注意事项：隐私方面必须添加位置用途描述；导航功能需在 Xcode 的 Signing & Capabilities 中启用 Maps capability；SwiftUI Map API 在 iOS 17 有显著改进，旧目标应使用 UIKit；UIKit 需设置 clusteringIdentifier 才能启用自动聚合；当标注数量达到 1000+ 时，应考虑聚合或自定义瓦片覆盖物以优化性能。
当需要更完整的 API 签名与参数、LookAround 实现细节、MKMapItem 与地点详情、GeoJSON 解码、室内地图（IMDF）、兴趣点类别与过滤、快照生成以及所有 MKMapViewDelegate 方法时，可查阅完整参考文档。
适用场景包括：为应用添加地图展示、展示用户当前位置、标注地点、处理大量标注聚合、计算与展示驾车路线、搜索附近地点与地址自动补全、绘制区域与路径覆盖物、配置地图样式与控件。限制方面：SwiftUI 新版 Map API 依赖 iOS 17 及以上，旧系统需使用 UIKit；定位功能需要用户授权与 Info.plist 配置；路线导航需要启用 Maps capability。