iOS地图SDK
    开发指南
    参考手册
示例中心
    下载
常见问题
  • 合规说明
    • iOS地图SDK
    开发指南
    小车平滑移动组件

    最后更新时间:2025-03-25

    小车平滑移动组件

    在使用LBS服务的应用中，越来越多的行业场景都需要地图SDK具备连续性的轨迹展示能力。例如出行、运动、物流、生活服务等类别的App中常常需要展示车辆或用户的行程轨迹、实时移动的位置数据。开发者展示轨迹的核心诉求是对真实场景的模拟，即实现轨迹的平滑展示以及关注目标在轨迹沿线的平滑移动、朝向改变。




    一、平滑移动类介绍

    小车平滑移动功能主要依赖于地图组件中的 QMUAnnotationAnimator 类和 <QMULocation> 协议。


    1、 <QMULocation>协议

    小车在折线段中移动时，需要提供构建该折线的坐标集合，每个集合都是一个实现了 <QMULocation> 协议的数据模型类，自定义类示例如下：

    @interface CarLocation : NSObject <QMULocation>

// 坐标信息
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

@end

    2、QMUAnnotationAnimator平滑移动动画类

    该类提供了平移动画的控制方法，方法介绍如下：

    /**
 * @brief 平移动画状态
 */
typedef enum _QMUAnnotationAnimationStatus
{
	/// 动画插值中
	QMUAnnotationAnimation_Interpolating = 0,
	
	/// 动画完整结束
	QMUAnnotationAnimation_Complete
}QMUAnnotationAnimationStatus;

/**
 * @brief 平移动画callback信息
 */
typedef struct
{
	/// 当前插值点的坐标
	CLLocationCoordinate2D coordinate;
	
	/// 当前点处于原始移动路线点串中的下标(便于开发者使用路线擦除接口)
	int index;
	
	/// 动画的状态
	QMUAnnotationAnimationStatus status;
	
}QMUAnnotationAnimationInfo;

/**
 * @brief  执行平滑移动动画. 该方法支仅持地图在2D正北状态下进行.
 * @param annotationView  平滑移动的对象
 * @param rotationView   旋转的对象
 * @param locations     平滑移动需要经过的经纬度坐标点串
 * @param duration        平滑移动时间
 * @param needRotate      平滑移动过程中annotationView是否需要沿移动方向执行旋转动画
 * @param distanceFilter  平滑移动回调频率接口，单位: 米
 * @param callBack		平滑移动回调
 */
+ (void)translateWithAnnotationView:(QAnnotationView *)annotationView
						rotationView:(UIView *)rotationView
						  locations:(NSArray<id <QMULocation> > *)locations
						   duration:(CFTimeInterval)duration
					  rotateEnabled:(BOOL)needRotate
					  distanceFilter:(CLLocationDistance)distanceFilter
					  translationCallback:(QMUAnnotationAnimationCallBack)callBack;

    该方法接收的locations参数，为实现了 <QMULocation> 协议的位置信息数据对象的集合，如果needRotate = YES, 当调用该方法时，annotationView 会沿着指定的坐标集合构建的折线移动，且平移过程中会在callback中返回插值点坐标和当前点处于原始移动路线点串中的下标，便于用户进行线擦除操作。

    注意：该方法支仅持地图在2D正北状态下进行，暂时不支持在地图旋转、倾斜的情况下进行。


    二、使用说明

    1. 平滑移动组件支持传入地图SDK的QAnnotationView或其子类，通过设置经纬度坐标点串和移动时间，使得该View可以按照点串路线进行平滑动画移动。

    2. 若设置needRotate为YES，则在移动过程中，View自身的方向也会根据路线进行调整，使得View的上部与移动方向保持一致。

    QAnnotationView *carView = (QAnnotationView *)[self.mapView viewForAnnotation:self.carAnno];
__weak typeof (self) ws = self;
[QMUAnnotationAnimator translateWithAnnotationView:carView rotationView:carView locations:self.translatePoints duration:10 rotateEnabled:YES distanceFilter:0 translationCallback:^(QMUAnnotationAnimationInfo info) {
	NSString *status = info.status == QMUAnnotationAnimation_Interpolating ? @"插值" : @"完成";
		
	NSLog(@"translate coord:%f,%f, index:%d, status:%@ self:%p", info.coordinate.latitude, info.coordinate.longitude, info.index, status, ws);
		
	// 进行线擦除
	QTexturePolylineView *tv = (QTexturePolylineView *)[ws.mapView viewForOverlay:ws.polyline];
		
	[tv eraseFromStartToCurrentPoint:info.coordinate searchFrom:info.index toColor:YES];
			
}];
    1. 若需要在动画过程中停止动画，可调用View的layer进行操作。
    QAnnotationViewLayer *annoViewLayer = (QAnnotationViewLayer *)annotationView.layer;
[annoViewLayer removeAnimationForKey:NSStringFromSelector(@selector(coordinate))];
[annoViewLayer removeAnimationForKey:@"transform.rotation.z"];

    三、示例展示

    本页内容