iOS17 SwiftUI地图标注报错：无法转换[NationalParkLocation]为CLLocationCoordinate2D

问题 #

作为SwiftUI新手，在iOS17环境下实现带标注的地图视图时，遇到如下报错：

Cannot convert value of type '[NationalParkLocation]' to expected argument type 'CLLocationCoordinate2D'

错误代码 #

最初的实现代码：

import SwiftUI
import MapKit

struct MapView: View {

    @State private var cameraPosition: MapCameraPosition = {
        var mapCoordinates = CLLocationCoordinate2D(latitude: 6.600286, longitude: 16.4377599)

        var mapZoomLevel = MKCoordinateSpan(latitudeDelta: 70.0, longitudeDelta: 70.0)

        var mapRegion = MapCameraPosition.region(MKCoordinateRegion(center: mapCoordinates, span: mapZoomLevel))
        
        return mapRegion
    }()
    
    let locations: [NationalParkLocation] = Bundle.main.decode("locations.json")
    
    var body: some View {
        
        Map(position: $cameraPosition) {
            Annotation("Test", coordinate: locations) {
                Image(systemName: "mappin")
            }
        }
    }
}

无效尝试 #

曾尝试使用已废弃的API，无法解决问题：

Map(coordinateRegion: $cameraPosition, annotationItems: locations,
            annotationContent: { item in
            MapPin(coordinate: item.location, tint: .accent)
        })

错误原因 #

报错核心原因是：Annotation的coordinate参数要求传入单个CLLocationCoordinate2D类型的坐标值，但代码中直接传入了数组locations，类型不匹配。同时iOS17后，SwiftUI Map的旧版标注API（annotationItems）已被废弃，需要使用新的实现方式。

正确代码 #

更新后的代码可正常运行：

struct MapView: View {
    // MARK: - PROPERTIES
    
    @State private var cameraPosition: MapCameraPosition = {
        var mapCoordinates = CLLocationCoordinate2D(latitude: 6.600286, longitude: 16.4377599)
        var mapZoomLevel = MKCoordinateSpan(latitudeDelta: 70.0, longitudeDelta: 70.0)
        var mapRegion = MapCameraPosition.region(MKCoordinateRegion(center: mapCoordinates, span: mapZoomLevel))
        
        return mapRegion
    }()
    
    let locations: [NationalParkLocation] = Bundle.main.decode("locations.json")
    
    // MARK: - BODY
    
    var body: some View {
        Map(position: $cameraPosition) {
            ForEach(locations, id: \.id) { item in
                Marker(item.name, systemImage: "mappin.and.ellipse", coordinate: item.location)
            }
        }
    }
}

说明 #

• 使用ForEach遍历locations数组，为每个位置生成独立标注
• 采用iOS17推荐的Marker组件替代旧版Annotation/MapPin，直接传入位置名称、系统图标和对应坐标即可

内容的提问来源于stack exchange，提问作者Lexter Tapawan