搜狗地图SDK核心类详解

搜狗地图核心类详解

一、概述

搜狗地图SDK为开发者提供了丰富的功能，以便在应用中集成地图服务。档将详细介绍搜狗地图SDK中的关键类及其用法，帮助开发者更好地理解并利用这些类实现地图功能。

二、核心类

SGWMapView - 描述：SGWMapView是地图API的核心类，负责实例化地图对象。

• 用途：提供地图展示、交互等功能。
• 成员函数
• - (id)initWithFrame:options:：初始化方法，传入地图视图在屏幕上的尺寸和位置及配置选项。
• - (int)mapZoom：获取当前地图级别的缩放比例。
• - (void)setMapZoom:：设置地图的缩放级别。
• - (SGWBounds *)mapBounds：返回当前地图显示区域的范围。
• - (void)setMapBounds:：设置地图显示区域的范围。
• - (NSString *)mapTypeId：获取当前地图类型ID。
• - (void)setMapTypeId:：设置地图类型。
• - (SGWPoint *)mapCenter：获取地图当前中心坐标值。
• - (void)setMapCenter:：设置地图中心点坐标。
• - (void)setMapCenterWithLatLng:：通过经纬度设置地图中心点。
• - (NSString *)addMarker:：在地图中添加标记。
• - (void)removeMarkerWithId:：根据ID删除地图中的标记。
• - (SGWMarker *)markerForId:：根据ID获取地图中的标记对象。
• - (void)panByX:y:：根据像素偏移地图视图。
• - (void)panTo:：移动地图视图到指定的像素坐标。
• - (void)panToLatLng:：移动地图视图到指定的经纬度坐标。
• - (NSString *)addLabel:：在地图中添加文本标签。
• - (void)showTraffic:：设置是否显示实时交通信息。
• - (BOOL)isShowTraffic：判断当前地图是否显示实时交通信息。

SGWMapOptions - 描述：用于实例化SGWMapView类时送入的参数规范。

• 用途：提供配置选项，允许开发者自定义地图的初始状态和行为。

SGWProjection - 描述：用于在像素坐标和地理坐标之间进行转换。

• 用途：帮助开发者处理不同坐标系之间的转换需求。

三、叠加层类

SGWMarker - 描述：标记类，也称为点对象类，用于在地图上添加标记。

• 用途：标识特定地理位置。
• 成员函数
• - (NSString *)addMarker:：在地图中添加标记。

SGWMarkerImage - 描述：用于定义SGWMarker对象的图标、阴影等外观属性。

• 用途：自定义标记的视觉效果。

SGWMarkerOptions - 描述：实例化SGWMarker类时可以送入的参数规范。

• 用途：允许开发者设置标记的初始位置、图标等属性。

SGWInfoWindow - 描述：用于创建信息窗，通常会连接到某个标记。

• 用途：展示有关标记的详细信息。

四、基础类

SGWBounds - 描述：代表通过地理搜狗地图坐标表示的矩形范围（边界）。

• 用途：表示地图显示的区域范围。

SGWLatLng - 描述：以纬度和经度表示的地理坐标点。

• 用途：表示地球表面的具体位置。

五、服务类

SGWLocation - 描述：用于在地图中显示用户当前位置。

• 用途：提供定位服务。