如何移除iOS端GMSMapView的默认标记/标注？mapType属性不生效

常见误区说明 #

• 尝试通过修改mapType属性实现隐藏默认标注的方案在iOS端无法生效：mapType仅用于控制底图渲染类型（支持标准、地形、卫星等几种模式切换），完全不关联内置兴趣点（POI）标注的显隐逻辑，该接口在iOS端的行为和Android端没有对齐，无法通过修改mapType达到预期效果。
• 界面默认展示的点位标记，本质是Google地图内置的POI图层（包含餐饮、景点、公共设施、交通站点等标注），这类标注不属于可以通过代理逐个移除的GMSMarker对象，无法通过遍历mapView的markers数组实现清空。

正确实现步骤 #

1. 初始化GMSMapView实例，完成基础的相机位置、frame配置，和现有业务逻辑保持一致即可

   let camera = GMSCameraPosition.camera(withLatitude: lat, longitude: long, zoom: zoom)
   mapView = GMSMapView.map(withFrame: rect, camera: camera)
   

2. 自定义地图样式，将所有内置标注图层的可见性设置为关闭状态
   可直接复用以下配置的JSON字符串，核心逻辑是把所有POI类的标签元素设为不可见：

   // 隐藏全部默认POI标注的样式配置
   let hideAllDefaultLabelsStyle = """
   [
     {
       "featureType": "poi",
       "elementType": "labels",
       "stylers": [{"visibility": "off"}]
     },
     {
       "featureType": "transit",
       "elementType": "labels",
       "stylers": [{"visibility": "off"}]
     },
     {
       "featureType": "administrative",
       "elementType": "labels",
       "stylers": [{"visibility": "off"}]
     }
   ]
   """
   

3. 将自定义样式加载到GMSMapView实例中

   do {
     // 加载样式到地图，即可自动隐藏所有内置默认标注
     mapView.mapStyle = try GMSMapStyle(jsonString: hideAllDefaultLabelsStyle)
   } catch {
     // 样式解析失败时的兜底处理，可打印日志排查
     print("地图样式加载异常：\(error.localizedDescription)")
   }
   

补充注意事项 #

• 上述配置仅会隐藏Google地图内置的默认标注，不会影响开发者手动添加到地图上的自定义GMSMarker实例的展示。
• 如果需要保留部分类别的标注（比如道路名称），可以在样式JSON中对应调整featureType的visibility配置，无需全部关闭。
• 不需要额外手动清空mapView上的标记数组，因为内置POI不属于独立的可操作标记对象。

内容的提问来源于stack exchange，提问作者Manoj Kag