iOS 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.访问https://lbs.qq.com/dev/console/key/add,点击右上角申请秘钥,输入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接口提供添加单个标注或者一个标注数组。添加一个标注的示例代码如下：

标注样式

- (QPanoAnnotationView *)panoramaView:(QPanoramaView *)
									panoramaView viewForAnnotation:(id<QPanoAnnotation>)annotation
								{
									static NSString *pointReuseIndetifier = @"pointReuseIndetifier";
									QPanoAnnotationView *annotationView =
										(QPanoAnnotationView*)[panoramaView
											dequeueReusableAnnotationViewWithIdentifier:pointReuseIndetifier];

if (annotationView == nil)
									{
										annotationView = [[QPanoAnnotationView alloc]
											initWithAnnotation:annotation reuseIdentifier:pointReuseIndetifier];
										[annotationView setImage:
											[UIImage imageNamed:@"QPanoramaKit.bundle/marker_selected.png"]];
									}

annotationView.animatesDrop = YES;
									annotationView.canShowCallout = YES;

annotationView.leftCalloutAccessoryView =
										[UIButton buttonWithType:UIButtonTypeDetailDisclosure];
									annotationView.rightCalloutAccessoryView =
										[UIButton buttonWithType:UIButtonTypeDetailDisclosure];
									return annotationView;
								}

效果如图所示：

删除标注

调用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偏航角插值)。示例代码如下：

准备工作

概述