1. 地图手势操作

移动地图

API:

//x、y 为屏幕坐标偏移量 void MoveOffset(double x, double y) void DidRender()

使用：

（1）在移动的过程状态, 调用 MoveOffset(x,y);

（2）在移动的结束状态, 调用一次 DidRender()

缩放地图

API:

//zoomLevel 为地图目标缩放级别 void SetZoomLevel(double zoomLevel) void DidRender()

使用：

（1）缩放地图过程状态, 调用 SetZoomLevel(zoomLevel);

（2）缩放地图结束状态, 调用一次 DidRender()

平面旋转地图

API:

//rotationDelta 为平面旋转角度偏移量 void RotateDelta(double rotationDelta) void DidRender()

使用：

（1）旋转地图过程状态, 调用 RotateDelta(rotationDelta);

（2）旋转地图结束状态, 调用一次 DidRender()

俯视旋转地图

API:

//overlookDelta 为俯视旋转角度偏移量 void OverlookDelta(double overlookDelta) void DidRender()

使用：

（1）俯视旋转地图过程状态, 调用 OverlookDelta(overlookDelta);

（2）旋转地图结束状态, 调用一次 DidRender()

地图手势操作示例代码：

private MapController map; void Update () { bool moveDirty = false; bool zoomDirty = false; bool rotateDirty = false; bool overlookDirty = false; //移动地图 float xDiff = 0; float yDiff = 0; if (Input.GetKey (KeyCode.A)) { xDiff = -1 * Speed * Time.deltaTime; moveDirty = true; } if (Input.GetKey (KeyCode.W)) { yDiff = 1 * Speed * Time.deltaTime; moveDirty = true; } if (Input.GetKey (KeyCode.S)) { yDiff = -1 * Speed * Time.deltaTime moveDirty = true; } if (Input.GetKey (KeyCode.D)) { xDiff = 1 * Speed * Time.deltaTime; moveDirty = true; } if (moveDirty) { map.MoveOffset (xDiff, yDiff); } //缩放地图 if (Input.GetKeyUp (KeyCode.Space)) { double end = Math.Round (map.GetZoomLevel () - 1); map.SetZoomLevel (end); zoomDirty = true; } if (Input.GetKeyUp (KeyCode.Slash)) { double end = Math.Round (map.GetZoomLevel () + 1); map.SetZoomLevel (end); zoomDirty = true; } //平面旋转地图 if (Input.GetKey (KeyCode.RightArrow)) { map.RotateDelta (-Time.deltaTime * 20); rotateDirty = true; } if (Input.GetKey (KeyCode.LeftArrow)) { map.RotateDelta (Time.deltaTime * 20); rotateDirty = true; } //俯视旋转地图 if (Input.GetKey (KeyCode.UpArrow)) { map.OverlookDelta (Time.deltaTime * 20); overlookDirty = true; } if (Input.GetKey (KeyCode.DownArrow)) { map.OverlookDelta (-Time.deltaTime * 20); overlookDirty = true; } if (moveDirty || zoomDirty || rotateDirty || overlookDirty) { map.DidRender (); } }

使用双指缩放地图可参考如下方式：

MapController map; //gesture.Gap 为当前双指的距离,gesture.Delta 为前后两帧的双指距离差，单位 像素. map.SetZoomLevel(map.GetZoomLevel()+CalZoomLevelDelta(gesture.Gap, gesture.Delta)); private float CalZoomLevelDelta (float currentGap, float deltaGap) { float ratio = 0; ratio = currentGap / (currentGap - deltaGap); //以 2 为底取对数; return Mathf.Log (ratio, 2) * 0.5f; }

2. 添加三维模型

API：

//经纬度坐标转换成世界坐标 public Vector3 ConvertCoordinateToWorld(Coordinate coordinate)

使用：

将经纬度转换成世界坐标，设置给三维模型即可。

示例代码如下：

private MapController map; public GameObject houseGameObject; private void OnClickAddHouse(){ Coordinate position = new Coordinate (39.991325,116.204796); //设置地图状态 map.SetCoordinate(position); map.RotateDelta (360 - map.GetRotation()); map.OverlookDelta (37 - map.GetOverlooking()); map.DidRender (); //经纬度转世界坐标 Vector3 worldPoint = map.ConvertCoordinateToWorld (position); //设置模型位置 houseGameObject.SetActive (true); Vector3 pos = houseGameObject.transform.position; pos.x = worldPoint.x; pos.z = worldPoint.z; houseGameObject.transform.position = pos; }

效果图：

3. 经纬度转屏幕坐标

API：

//经纬度坐标转化为屏幕坐标 //x, y：表示屏幕坐标，bottom-left为原点，单位：像素 Vector2 ConvertCoordinateToScreen(Coordinate coordinate)

4. 2D/3D切换

API：

//是否显示3D楼块，针对17、18级 //默认显示。true表示显示建筑物（3D）， false表示隐藏建筑物（2D） void SetBuildingEnable(bool enable)

使用：

(1)初始化设置：在Start()中调用;

(2)运行时设置：在Update()或OnGUI()中设置一次调用

效果图：

5. 个性化底图切换

API：

//切换个性化底图样式 //参数为在官网配置的样式槽位号，从1开始 void SetMapStyle (int slotPosition)

使用：

(1)初始化设置：在MapController的配置参数中设置Style Slot，0表示上次使用的，1标识槽位1，2标识槽位2;

(2)运行时设置：在Update()或OnGUI()中设置一次调用;

(3)说明：如果没有样式一致的楼块纹理，可先切到2D模式使用

效果图：

6. 自定义楼块纹理

使用：

(1)参考“楼块纹理配置文件数据格式说明_对外.pdf”制作纹理、设计配置：

a.制作楼块纹理图片（楼块侧面纹理、楼块顶部纹理);

b.设计楼块纹理配置文件map_building_atlas_config_cartoon_dat.txt;

(2)替换/Resources/Data下的楼块纹理配置文件并：

a.设置/Resources/Materials/map_building_side_mat的纹理为自定义的楼块侧面纹理;

b.设置/Resources/Materials/map_building_top_mat的纹理为自定义的楼块顶部纹理;

(3)说明：如有需要，可切换在官网配置的个性化底图样式.

效果图：

7. 逆地址解析

API：

 地图数据检索能力封装了腾讯位置服务提供的 WebService 接口, 上线使用时应先 申请配额，避免因配额问题导致的异常。

// 逆地址解析，封装的WebService逆地址解析服务 void  ReverseGeoCoder (RGCOption rgcOption, Action<RGCResult>rgcResultCallback)

使用示例：

RGCOption option = new RGCOption ();         option.SetGetPoi (1);         option.SetCoordinate (new Coordinate (39.98415, 116.3075));         WebServiceManager.GetInstance ().ReverseGeoCoder (option, (RGCResult result) => {             Debug.Log (result.status + ", message: " + result.message + ", address: " + result.result.address +                  ", poiInfo: " + result.result.pois [9].address);         });

RGCOption 和RGCResult 可参考源码文档。

Tips

具体使用，可以参考提供的Demo工程.