iOS Swift4中如何在GoogleMapView展示Web Api返回的地址数组

作为iOS开发新手，碰到地址转坐标再加载地图的问题很正常——这涉及到API请求、数据解析、地理编码、地图渲染好几个环节，每个环节都容易踩坑。我帮你一步步梳理，先排查常见问题，再给你可参考的完整代码。

一、先确认基础配置（最容易忽略的坑） #

首先要确保Google Maps/Places的基础配置没出错：

• 在Info.plist中添加Google Maps API密钥：添加GMSApiKey字段，值为你的Google Cloud控制台申请的API密钥（要确保启用了Maps SDK for iOS和Places API）
• 如果需要用户位置权限（比如让地图定位到当前位置），还要添加NSLocationWhenInUseUsageDescription字段，填写权限申请说明
• 确认Podfile里已经正确引入GoogleMaps和GooglePlaces，并且执行过pod install

二、模型类与API数据解析 #

你提到用模型类获取数据，这里要确保模型类和API返回的JSON结构完全匹配。假设你的API返回的是地址数组，比如：

[
  {"address": "北京市海淀区中关村大街"},
  {"address": "上海市浦东新区陆家嘴"}
]

那对应的模型类应该这样写（用Codable简化解析）：

struct Location: Codable {
    let address: String
    // 如果API还有其他字段（比如id、名称），在这里补充对应的属性
}

用Alamofire请求数据时，要确保正确解析成模型数组，避免键名不匹配或者可选值处理错误：

func fetchLocationsFromAPI() {
    let apiUrl = "你的Web API地址"
    
    AF.request(apiUrl)
        .responseDecodable(of: [Location].self) { [weak self] response in
            guard let self = self else { return }
            
            switch response.result {
            case .success(let locations):
                // 成功拿到地址数组，下一步转坐标
                self.convertAddressesToCoordinates(locations: locations)
            case .failure(let error):
                print("API请求失败：\(error.localizedDescription)")
                // 这里可以给用户显示错误提示，比如Alert
            }
        }
}

三、地址转坐标（地理编码）的正确姿势 #

地理编码是异步操作，不能同步阻塞主线程，要用Google Places的GMSGeocoder来处理。新手容易犯的错误是没处理回调，或者在回调外直接操作UI：

func convertAddressesToCoordinates(locations: [Location]) {
    let geocoder = GMSGeocoder()
    
    for location in locations {
        geocoder.geocodeAddressString(location.address) { [weak self] response, error in
            guard let self = self else { return }
            
            // 检查解析结果
            guard let results = response?.results, let firstResult = results.first else {
                print("地址解析失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            // 获取经纬度坐标
            let coordinate = firstResult.coordinate
            // 将坐标添加到地图
            self.addMarkerToMap(coordinate: coordinate, title: location.address)
        }
    }
}

⚠️ 注意：Google Places API有请求配额限制，如果地址数量较多，建议添加批量处理的延迟，避免触发限流导致解析失败。

四、在GoogleMapView上添加标记 #

确保你的GoogleMapView已经通过IBOutlet连接到ViewController，并且提前初始化好地图相机：

// 假设你的GoogleMapView的IBOutlet是googleMapView
@IBOutlet weak var googleMapView: GMSMapView!

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 初始化地图相机（可以设置默认显示的区域，比如中国）
    let camera = GMSCameraPosition.camera(withLatitude: 39.9042, longitude: 116.4074, zoom: 10)
    googleMapView.camera = camera
    
    // 开始请求API数据
    fetchLocationsFromAPI()
}

func addMarkerToMap(coordinate: CLLocationCoordinate2D, title: String) {
    let marker = GMSMarker(position: coordinate)
    marker.title = title
    // 可以添加副标题、自定义图标等
    // marker.snippet = "自定义副标题"
    marker.map = googleMapView
}

五、新手常见错误排查 #

1. 模型解析失败：检查API返回的JSON键名和模型属性名是否一致，不一致的话用CodingKeys映射：

   struct Location: Codable {
       let address: String
       
       enum CodingKeys: String, CodingKey {
           case address = "full_address" // 如果API返回的键是full_address
       }
   }
   

2. 地图不显示：检查API密钥是否正确，是否启用了Maps SDK for iOS，以及Info.plist的配置是否正确
3. 地理编码无结果：确认地址格式正确（比如包含城市、街道），或者更换一个测试地址试试
4. UI更新异常：如果地理编码回调不在主线程，要手动切换到主线程更新地图：

   DispatchQueue.main.async {
       marker.map = self.googleMapView
   }
   

内容的提问来源于stack exchange，提问作者Venkatesh Chejarla