准备工作

在正式进行3D地图开发前请先参考工程设置配置您的工程,并在这里获取街景SDK。

概述

街景SDK(iOS)是一套基于iOS5.1.1及以上设备的应用程序接口,通过该接口,您可以方便地访问腾讯街景服务,构建自己街景应用程序

编译配置需求:

  • Xcode6.0 及以上
  • iOS SDK8.0 及以上
  • Deployment Target 5.1及以上

完整的Demo例程可参考IOS_Panorama

引入街景引擎

1.添加引擎framework

在TARGETS -> Build Phases -> Link Binary with Libraries 点击“+”,弹出添加列表后,点击”Add Other…”,从frameworks文件夹中添加QPanoramaKit.framework和WebP.framework到工程中

2.添加bundle文件

在工程界面右键弹出菜单中选择"Add Files To...”,从文件夹frameworks->QPanoramaKit.framework->Resources中将资源文件QPanoramaKit.bundle添加到工程中,在弹出窗口中勾选"Copy items into destination group's folder(if needed)”。

3.添加所依赖的系统库

在TARGETS-Build Phases-Link Binary with Libraries 点击”+",弹出添加列表后,选择添加

1.libstdc++.6.dylid

2.libz.dylib

4.添加需要的编译选项

在TARGETS-Build Settings-Other Linker Flags 中添加如下内容: -ObjC 。

申请和添加key

1.申请用户key

1.访问http://lbs.qq.com/console/key.html,点击右上角申请秘钥,输入qq账号登录

2.填写应用名称,描述,验证码,阅读并同意使用条款

3.申请完成后,点击"我的秘钥"按钮,得到申请的key

2.在项目中添加key

在使用街景SDK时,需要对应用做Key机制验证,如果街景不添加key,街景将不能运行,控制台会显示没有key的错误日志,在街景初始化之前将您在官网上申请的Key添加到如下:

3.示例代码

显示街景

在您的ViewController.h文件中添加QPanoramaView的创建代码。

在您的ViewController.m文件添加实例化PanoramaView的代码。

添加标注

修改您的viewController.h文件,添加以下代码,使您的ViewController实现QPanoramaViewDelegate协议:

iOS SDK 提供的街景地图标注为QPanoPointAnnotation类,街景地图SDK接口提供添加单个标注或者一个标注数组。添加一个标注的示例代码如下:

标注样式

效果如图所示:

删除标注

调用panoramaView 对象的removeAnnotation:方法删除指定的标注;或者调用 removeAnnotations:方法删除指定的标注对象数组,以下为删除标注数组的示例代码如下:

街景动画

1.QPanoramaCamera

该类用于控制QPanoramaView的视角,和具体的街景场景点无关。创建QPanoramaCamera,使用 -(instancetype)initWithOrientation:(QOrientation)orientation zoom:(float)zoom方法进行初始化。其中QOrientation为偏航俯仰角结构体,偏航角heading区间是 -180 到 180,俯仰角Pitch区间 -90 到 10。Zoom为缩放,级别key [0, 2], 默认 0。示例代码如下:

2.QPanoramaCameraUpdate

该类用于场景视角更新 。创建QPanoramaCameraUpdate,如下的例子为创建偏航角(原始heading角度+deltaHeading偏航角插值)。示例代码如下:

切换场景

1.ID移动

街景SDK可以实现移动到指定panoramaID的位置,示例代码如下:

2. 经纬度移动

街景SDK还可以实现移动到指定的位置,示例代码如下: