“定位图标指示方向”的版本间的差异

2022年2月25日 (五) 17:38的最后版本

定位图标指示方向

功能场景

定位图标根据用户面向的方向进行旋转，在路线规划、导航等场景中帮助用户更加清晰的判断移动方向。

//mapopen-website-wiki.bj.bcebos.com/demos/AndroidVideos/定位图标指示方向.mp4

1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/newqrcodes/定位图标指示方向.png

扫码体验

使用产品

Android定位SDK|/index.php?title=android-locsdk

下载源码

//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionDemo.zip

核心接口

类

接口

描述

备注

BaiduMap

setMyLocationEnabled(boolean enabled)

设置是否允许定位图层

地图SDK

BaiduMap

setMyLocationConfiguration(MyLocationConfiguration configuration)

设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效

地图SDK

BaiduMap

setMyLocationData(MyLocationData data)

设置定位数据, 只有先允许定位图层后设置数据才会生效

地图SDK

MyLocationConfiguration

MyLocationConfiguration(LocationMode mode, boolean enableDirection, BitmapDescriptor customMarker)

1.mode 定位图层显示方式, 默认为 LocationMode.NORMAL 普通态2.enableDirection 是否允许显示方向信息3．customMarker 设置用户自定义定位图标，可以为 null

地图SDK

MyLocationData.Builder

direction(float direction)

设置定位数据的方向信息

地图SDK

LocationClient

start()

启动定位sdk

定位SDK

LocationClient

setLocOption(LocationClientOption locOption)

给定位客户端设置参数

定位SDK

LocationClient

BDAbstractLocationListener

监听定位结果回调函数

定位SDK

重点关注

通过系统的方向传感器获取到方向角度，结合地图SDK中的定位图层功能实现方向指向。

核心代码

1.开启定位图层设置定位模式

JAVA

mBaiduMap.setMyLocationEnabled(true);
MyLocationConfiguration myLocationConfiguration = new MyLocationConfiguration(MyLocationConfiguration.LocationMode.NORMAL, true, null);

复制

深色

复制成功

2.获取传感器管理服务注册方向传感监听器

JAVA

// 获取传感器管理服务
mSensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
// 为系统的方向传感器注册监听器
    mSensorManager.registerListener(this, mSensorManager.getDefaultSensor(Sensor.TYPE_ORIENTATION),
                SensorManager.SENSOR_DELAY_UI);

复制

深色

复制成功

3.获取传感器方向回调信息设置给定位图层

JAVA

/**
* 传感器方向信息回调
*/
@Override
public void onSensorChanged(SensorEvent sensorEvent) {
    double x = sensorEvent.values[SensorManager.DATA_X];
    if (Math.abs(x - lastX) > 1.0) {
mCurrentDirection = (float) x;
// 构造定位图层数据
        myLocationData = new MyLocationData.Builder()
                .accuracy(mCurrentAccracy)
                // 此处设置开发者获取到的方向信息，顺时针0-360
                .direction(mCurrentDirection)
                .latitude(mCurrentLat)
.longitude(mCurrentLon).build();
        // 设置定位图层数据
        mBaiduMap.setMyLocationData(myLocationData);
    }
    lastX = x;
}

复制

深色

复制成功

//mapopen-website-wiki.bj.bcebos.com/demos/iosVideos/location/定位图标指示方向@1x.mp4

1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/ioscodes/定位图标指示方向@1xios.png

扫码体验

使用产品

iOS定位SDK|/index.php?title=ios-locsdk

下载源码

//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionSDKDemo.zip

核心接口

类

接口

描述

BMKMapView

-(void)updateLocationData:(BMKUserLocation *)userLocation;

动态更新我的位置数据

BMKLocationManager

[self.locationManager startUpdatingLocation];

开始连续定位

BMKLocationManager

[self.locationManager startUpdatingHeading];

开始设备朝向事件回调

BMKLocationManager

- (void)BMKLocationManager:(BMKLocationManager *)manager didUpdateLocation:(BMKLocation *)location orError:(NSError *)error;

连续定位回调函数

BMKLocationManager

- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didUpdateHeading:(CLHeading * _Nullable)heading;

该方法为BMKLocationManager提供设备朝向的回调方法

核心代码

1.设置显示定位图层和定位模式

Objective-C

// 显示定位图层
_mapView.showsUserLocation = YES;
// 定位模式
_mapView.userTrackingMode = BMKUserTrackingModeHeading;

复制

深色

复制成功

2.实现连续定位回调代理方法和设备朝向的回调代理方法

Objective-C

///  连续定位回调函数
- (void)BMKLocationManager:(BMKLocationManager *)manager didUpdateLocation:(BMKLocation *)location orError:(NSError *)error {
    // 定位错误信息
    if (error) {
        NSLog(@"locError:{%zd -%@};", error.code, error.localizedDescription);
        return;
    }

    // 定位结果
    if (location) {
        self.userLocation.location = location.location;
        // 如需展示我的位置图标需要调用此方法
        [self.mapView updateLocationData:self.userLocation];
        // 设置地图中心点
        [self.mapView setCenterCoordinate:location.location.coordinate];
    }
}

/// 该方法为BMKLocationManager提供设备朝向的回调方法。
- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didUpdateHeading:(CLHeading * _Nullable)heading {
    if (!heading) { return; }
    
    /// 更新当前位置数据
    self.userLocation.heading = heading;
    [self.mapView updateLocationData:self.userLocation];
}

复制

深色

复制成功

3.开始定位，开始设备朝向事件回调

Objective-C

// 开始连续定位
[self.locationManager startUpdatingLocation];  
// 开始设备朝向事件回调
[self.locationManager startUpdatingHeading];

复制

深色

复制成功

@@ 第1行： / 第1行： @@
 <div id="examples_center"><!-- 页面标题 --><div class="title-hd">定位图标指示方向</div><!-- 标题下子标题及简介，可有多个 --><div class="title-mi">功能场景</div><div class="wrap-mi">定位图标根据用户面向的方向进行旋转，在路线规划、导航等场景中帮助用户更加清晰的判断移动方向。</div><!--  --></div><div class="demos_wrap"><div class="header"><div class="andiord-header active">Android</div><div class="ios-header">iOS</div></div><div class="andiord-wrap wrap"><div class="wrap-wp"><div class="wrap_left"><div class="left-video"><div class="img-bg-and"></div><div class="phone-android"><div class="video-wrap infor"><div class="video-control"></div><!-- 安卓视频位置 (不写协议)--><pre>//mapopen-website-wiki.bj.bcebos.com/demos/AndroidVideos/定位图标指示方向.mp4</pre>
-</div><div class="video-icon-and"><div class="play play-and"></div><div class="stop stop-and"></div></div></div><div class="progressWrap-hide-and"></div><div id="videoControls-and"><div id="progressWrap-and"><div id="playProgress-and"></div></div></div></div><div class="left-qrCode"><!-- 安卓二维码位置 --><div class="qrCode-and">1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/newqrcodes/定位图标指示方向.png</div><div>扫码体验</div></div></div><div class="wrap_right"><div class="wrap_right_nav"><div class="wrap_right_nav_l"><div>使用产品</div><div><!-- 安卓使用产品下选项，可有多个 --><!-- 产品1|/index.php?title=test --><div class="documentA">Android定位SDK|/index.php?title=android-locsdk</div></div></div><div class="wrap_right_nav_r">下载源码</div><!-- 安卓源码地址 --><div class="github-url-and">//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionDemo.zip</div></div><div class="wrap_table"><div class="table_nav"><div class="left-icon"></div><div>核心接口</div></div><div class="table_wrap"><div class="table_wrap_title"><div>类</div><div>接口</div><div>描述</div><div>备注</div></div><!-- 表格接口，可有多个 --><div class="table_wrap_con"><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationEnabled(boolean enabled)</div></div><div><div>设置是否允许定位图层</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationConfiguration(MyLocationConfiguration configuration)</div></div><div><div>设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationData(MyLocationData data)</div></div><div><div>设置定位数据, 只有先允许定位图层后设置数据才会生效</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">MyLocationConfiguration</div></div><div><div>MyLocationConfiguration(LocationMode mode, boolean enableDirection, BitmapDescriptor customMarker)</div></div><div><div>1.mode 定位图层显示方式, 默认为 LocationMode.NORMAL 普通态2.enableDirection 是否允许显示方向信息3．customMarker 设置用户自定义定位图标，可以为 null</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">MyLocationData.Builder</div></div><div><div>direction(float direction)</div></div><div><div>设置定位数据的方向信息</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>start()</div></div><div><div>启动定位sdk</div></div><div><div>定位SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>setLocOption(LocationClientOption locOption)</div></div><div><div>给定位客户端设置参数</div></div><div><div>定位SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>BDAbstractLocationListener</div></div><div><div>监听定位结果回调函数</div></div><div><div>定位SDK</div></div></div></div></div></div></div></div><div class="pre-nav"><div class="left-icon"></div><div>重点关注</div></div><div class="pre-nav" style="margin-left: 10px;"><div>通过系统的方向传感器获取到方向角度，结合地图SDK中的定位图层功能实现方向指向。</div></div><div class="pre-nav"><div class="left-icon"></div><div>核心代码</div></div><div class="pre-nav"><div>1.开启定位图层设置定位模式</div></div><div class="pre-wrap"><div class="pre-wrap-nav"><div>JAVA</div></div><!-- 安卓示例代码位置 --><div class="pre-wrap-w pre-wrap-w-and"><pre class="prettyprint prettyprinted pre-and">mBaiduMap.setMyLocationEnabled(true);
+</div><div class="video-icon-and"><div class="play play-and"></div><div class="stop stop-and"></div></div></div><div class="progressWrap-hide-and"></div><div id="videoControls-and"><div id="progressWrap-and"><div id="playProgress-and"></div></div></div></div><div class="left-qrCode"><!-- 安卓二维码位置 --><div class="qrCode-and">1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/newqrcodes/定位图标指示方向.png</div><div>扫码体验</div></div></div><div class="wrap_right"><div class="wrap_right_nav"><div class="wrap_right_nav_l"><div>使用产品</div><div><!-- 安卓使用产品下选项，可有多个 --><div class="documentA">Android定位SDK|/index.php?title=android-locsdk</div></div></div><div class="wrap_right_nav_r">下载源码</div><!-- 安卓源码地址 --><div class="github-url-and">//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionDemo.zip</div></div><div class="wrap_table"><div class="table_nav"><div class="left-icon"></div><div>核心接口</div></div><div class="table_wrap"><div class="table_wrap_title"><div>类</div><div>接口</div><div>描述</div><div>备注</div></div><!-- 表格接口，可有多个 --><div class="table_wrap_con"><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationEnabled(boolean enabled)</div></div><div><div>设置是否允许定位图层</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationConfiguration(MyLocationConfiguration configuration)</div></div><div><div>设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BaiduMap</div></div><div><div>setMyLocationData(MyLocationData data)</div></div><div><div>设置定位数据, 只有先允许定位图层后设置数据才会生效</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">MyLocationConfiguration</div></div><div><div>MyLocationConfiguration(LocationMode mode, boolean enableDirection, BitmapDescriptor customMarker)</div></div><div><div>1.mode 定位图层显示方式, 默认为 LocationMode.NORMAL 普通态2.enableDirection 是否允许显示方向信息3．customMarker 设置用户自定义定位图标，可以为 null</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">MyLocationData.Builder</div></div><div><div>direction(float direction)</div></div><div><div>设置定位数据的方向信息</div></div><div><div>地图SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>start()</div></div><div><div>启动定位sdk</div></div><div><div>定位SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>setLocOption(LocationClientOption locOption)</div></div><div><div>给定位客户端设置参数</div></div><div><div>定位SDK</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">LocationClient</div></div><div><div>BDAbstractLocationListener</div></div><div><div>监听定位结果回调函数</div></div><div><div>定位SDK</div></div></div></div></div></div></div></div><div class="pre-nav"><div class="left-icon"></div><div>重点关注</div></div><div class="pre-nav" style="margin-left: 10px;"><div>通过系统的方向传感器获取到方向角度，结合地图SDK中的定位图层功能实现方向指向。</div></div><div class="pre-nav"><div class="left-icon"></div><div>核心代码</div></div><div class="pre-nav"><div>1.开启定位图层设置定位模式</div></div><div class="pre-wrap"><div class="pre-wrap-nav"><div>JAVA</div></div><!-- 安卓示例代码位置 --><div class="pre-wrap-w pre-wrap-w-and"><pre class="prettyprint prettyprinted pre-and">mBaiduMap.setMyLocationEnabled(true);
 MyLocationConfiguration myLocationConfiguration = new MyLocationConfiguration(MyLocationConfiguration.LocationMode.NORMAL, true, null);
                  </pre>
@@ 第31行： / 第31行： @@
                  </pre>
 <div class="pre-btn"><div class="pre-btn-copy-and">复制</div><div class="pre-btn-cb-and">深色</div></div><div class="success">复制成功</div></div></div></div><div class="ios-wrap wrap" style="display: none;"><div class="wrap-wp"><div class="wrap_left"><div class="left-video"><div class="img-bg-ios"></div><div class="phone-ios"><div class="video-wrap infor"><div class="video-control"></div><!-- ios视频位置 --><pre>//mapopen-website-wiki.bj.bcebos.com/demos/iosVideos/location/定位图标指示方向@1x.mp4</pre>
-</div><div class="video-icon-ios"><div class="play play-ios"></div><div class="stop stop-ios"></div></div></div><div class="progressWrap-hide-ios"></div><div id="videoControls-ios"><div id="progressWrap-ios"><div id="playProgress-ios"></div></div></div></div><div class="left-qrCode iosqrCode"><!-- ios二维码位置 --><div class="qrCode-ios">1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/ioscodes/定位图标指示方向@1xios.png</div><div>扫码体验</div></div></div><div class="wrap_right"><div class="wrap_right_nav"><div class="wrap_right_nav_l"><div>使用产品</div><div><!-- IOS使用产品下选项，可有多个 --><!-- 产品1|/index.php?title=test --><div class="documentA">iOS定位SDK|/index.php?title=ios-locsdk</div><!--  --></div></div><div class="wrap_right_nav_r">下载源码</div><!-- IOS源码地址 --><div class="github-url-ios">//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionSDKDemo.zip</div></div><div class="wrap_table"><div class="table_nav"><div class="left-icon"></div><div>核心接口</div></div><div class="table_wrap"><div class="table_wrap_title"><div>类</div><div>接口</div><div>描述</div></div><!-- ios表格接口内容，可有多个 --><!-- 表格接口，可有多个 --><div class="table_wrap_con"><div class="table_wrap_w"><div><div class="table-wrap-className">BMKMapView</div></div><div><div>-(void)updateLocationData:(BMKUserLocation *)userLocation;</div></div><div><div>动态更新我的位置数据</div></div></div><!--  --><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>[self.locationManager startUpdatingLocation];</div></div><div><div>开始连续定位</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>[self.locationManager startUpdatingHeading];</div></div><div><div>开始设备朝向事件回调</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>- (void)BMKLocationManager:(BMKLocationManager *)manager didUpdateLocation:(BMKLocation *)location orError:(NSError *)error;</div></div><div><div>连续定位回调函数</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didUpdateHeading:(CLHeading * _Nullable)heading;</div></div><div><div>该方法为BMKLocationManager提供设备朝向的回调方法</div></div></div></div></div></div></div></div><div class="pre-nav"><div class="left-icon"></div><div>核心代码</div></div><div class="pre-nav"><div>1.设置显示定位图层和定位模式</div></div><div class="pre-wrap"><div class="pre-wrap-nav"><div>Objective-C</div></div><div class="pre-wrap-w pre-wrap-w-ios code_container"><!-- ios示例代码位置 --><pre class="prettyprint prettyprinted pre-ios">// 显示定位图层
+</div><div class="video-icon-ios"><div class="play play-ios"></div><div class="stop stop-ios"></div></div></div><div class="progressWrap-hide-ios"></div><div id="videoControls-ios"><div id="progressWrap-ios"><div id="playProgress-ios"></div></div></div></div><div class="left-qrCode iosqrCode"><!-- ios二维码位置 --><div class="qrCode-ios">1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/ioscodes/定位图标指示方向@1xios.png</div><div>扫码体验</div></div></div><div class="wrap_right"><div class="wrap_right_nav"><div class="wrap_right_nav_l"><div>使用产品</div><div><!-- IOS使用产品下选项，可有多个 --><div class="documentA">iOS定位SDK|/index.php?title=ios-locsdk</div><!--  --></div></div><div class="wrap_right_nav_r">下载源码</div><!-- IOS源码地址 --><div class="github-url-ios">//mapopen-website-wiki.bj.bcebos.com/demos/location/LocationDirectionSDKDemo.zip</div></div><div class="wrap_table"><div class="table_nav"><div class="left-icon"></div><div>核心接口</div></div><div class="table_wrap"><div class="table_wrap_title"><div>类</div><div>接口</div><div>描述</div></div><!-- ios表格接口内容，可有多个 --><!-- 表格接口，可有多个 --><div class="table_wrap_con"><div class="table_wrap_w"><div><div class="table-wrap-className">BMKMapView</div></div><div><div>-(void)updateLocationData:(BMKUserLocation *)userLocation;</div></div><div><div>动态更新我的位置数据</div></div></div><!--  --><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>[self.locationManager startUpdatingLocation];</div></div><div><div>开始连续定位</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>[self.locationManager startUpdatingHeading];</div></div><div><div>开始设备朝向事件回调</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>- (void)BMKLocationManager:(BMKLocationManager *)manager didUpdateLocation:(BMKLocation *)location orError:(NSError *)error;</div></div><div><div>连续定位回调函数</div></div></div><div class="table_wrap_w"><div><div class="table-wrap-className">BMKLocationManager</div></div><div><div>- (void)BMKLocationManager:(BMKLocationManager * _Nonnull)manager didUpdateHeading:(CLHeading * _Nullable)heading;</div></div><div><div>该方法为BMKLocationManager提供设备朝向的回调方法</div></div></div></div></div></div></div></div><div class="pre-nav"><div class="left-icon"></div><div>核心代码</div></div><div class="pre-nav"><div>1.设置显示定位图层和定位模式</div></div><div class="pre-wrap"><div class="pre-wrap-nav"><div>Objective-C</div></div><div class="pre-wrap-w pre-wrap-w-ios code_container"><!-- ios示例代码位置 --><pre class="prettyprint prettyprinted pre-ios">// 显示定位图层
 _mapView.showsUserLocation = YES;
 // 定位模式

文档全面上新

2022年2月25日 (五) 17:38的最后版本