签到场景

功能场景

本示例展示了如何在附近位置场所进行签到。

//mapopen-website-wiki.bj.bcebos.com/demos/签到.mp4

1590746640|//mapopen-website-wiki.bj.bcebos.com/demos/newqrcodes/签到.png

扫码体验

使用产品

Android地图SDK|/index.php?title=androidsdk

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

下载源码

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

核心接口

类

接口

描述

备注

ReverseGeoCodeOption

newVersion(int latestAdmin)

设置是否返回新数据1返回0不返回

地图SDK

ReverseGeoCodeOption

radius(500)

POI召回半径，允许设置区间为0-1000米，超过1000米按1000米召回。默认值为1000

地图SDK

SpatialRelationUtil

isCircleContainsPoint(LatLng center, int radius, LatLng point)

判断圆形是否包含传入的经纬度点

地图SDK

LocationClient

start()

启动定位sdk

定位SDK

LocationClient

setLocOption(LocationClientOption locOption)

给定位客户端设置参数

定位SDK

BDAbstractLocationListener

监听定位结果回调函数

定位SDK

重点关注

签到场景的核心难点在于解决定位不准的情况下纠正用户位置，示例中提供用户手动纠正位置功能来解决这一问题。

当正常通过定位确定用户位置之后，会给出周边POI列表供用户选择准确位置。

当定位发生微小漂移时，用户通过手动移动地图做位置调整，当前微调范围被限定在500米以内（可自定义），超过500米时弹出toast告知用户“微调距离不可超过500米”。

//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=iossdk

>

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

下载源码

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

核心接口

类

接口

描述

BMKMapView

- (void)addOverlay:(id <BMKOverlay>)overlay;

地图窗口添加Overlay，需要实现BMKMapViewDelegate的-mapView:viewForOverlay:函数来生成标注对应的View

BMKMapView

- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id<BMKOverlay>)overlay;

根据overlay生成对应的View

BMKMapView

- (void)addAnnotation:(id <BMKAnnotation>)annotation;

向地图窗口添加标注，需要实现BMKMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View

BMKMapView

- (BMKAnnotationView *)mapView:(BMKMapView *)mapView viewForAnnotation:(id<BMKAnnotation>)annotation；

根据anntation生成对应的View

BMKMapView

- (void)mapView:(BMKMapView *)mapView regionDidChangeAnimated:(BOOL)animated reason:(BMKRegionChangeReason)reason;

地图区域改变完成后会调用此方法

BMKLocationManager

- (BOOL)requestLocationWithReGeocode:(BOOL)withReGeocode

                                       withNetworkState:(BOOL)withNetWorkState

completionBlock:(BMKLocatingCompletionBlock _Nonnull)completionBlock;

开始单次定位

BMKGeoCodeSearch

- (void)onGetReverseGeoCodeResult:(BMKGeoCodeSearch *)searcher

                                       result:(BMKReverseGeoCodeSearchResult *)result

errorCode:(BMKSearchErrorCode)error;

返回逆地理编码搜索结果

重点关注

               签到场景的核心难点在于解决定位不准的情况下纠正用户位置，示例中提供用户手动纠正位置功能来解决这一问题。
当正常通过定位确定用户位置之后，会给出周边POI列表供用户选择准确位置。
当定位发生微小漂移时，用户通过手动移动地图做位置调整，当前微调范围被限定在500米以内（可自定义），超过500米时弹出toast告知用户“微调距离不可超过500米”。

核心代码

1.创建地图

Objective-C

_mapView = [[BMKMapView alloc] initWithFrame: CGRectMake(0, 0, SCREEN_WIDTH, CONTENT_HEIGHT - 200)];
// 地图比例尺级别
_mapView.zoomLevel = 17;
// 设置代理
_mapView.delegate = self;

复制

深色

复制成功

2.添加签到范围overlay

Objective-C

// 创建overlay     
_circleOverlay = [[BMKCircle alloc] init];
    _circleOverlay.coordinate = CLLocationCoordinate2DMake(40.055854, 116.306761);
    _circleOverlay.radius = 500;
// 添加overlay
[self.mapView addOverlay:self.circleOverlay];

复制

深色

复制成功

3.初始化定位管理类

Objective-C

_locationManager = [[BMKLocationManager alloc] init];
// 设置返回位置的坐标系类型
_locationManager.coordinateType = BMKLocationCoordinateTypeBMK09LL;
// 设置距离过滤参数
_locationManager.distanceFilter = 5.0;
// 设置预期精度参数
_locationManager.desiredAccuracy = kCLLocationAccuracyBest;
// 设置应用位置类型
_locationManager.activityType = CLActivityTypeAutomotiveNavigation;
// 设置是否自动停止位置更新
_locationManager.pausesLocationUpdatesAutomatically = NO;
// 设置位置获取超时时间
_locationManager.locationTimeout = 10;
// 设置获取地址信息超时时间
_locationManager.reGeocodeTimeout = 10;
// 设置delegate
_locationManager.delegate = self;

复制

深色

复制成功

4.开始定位

Objective-C

[self.locationManager requestLocationWithReGeocode:YES withNetworkState:YES completionBlock:^(BMKLocation * _Nullable location, BMKLocationNetworkState state, NSError * _Nullable error) {
    // 定位错误信息
    if (error) {
        NSLog(@"locError:{%zd -%@};", error.code, error.localizedDescription);
        return;
    }
    
    // 定位结果
    if (location) {
        CLLocationCoordinate2D coord = location.location.coordinate;
        // 逆地理编码，获取当前位置周边POI
        [self rgcSearch:coord];
        // 设置地图中心点
        [self.mapView setCenterCoordinate:coord];
        // 更新当前位置数据
        [self updateUserLocation:coord];
}];

复制

深色

复制成功

5.定位成功添加当前位置Annotation

Objective-C

// 创建当前位置Annotation
_userLocAnnotation = [[BMKPointAnnotation alloc] init];
_userLocAnnotation.isLockedToScreen = YES;

    // 经纬度转屏幕坐标
    CGPoint userLocScreenPoint = [self.mapView convertCoordinate:coord toPointToView:self.mapView];
    // 设置当前位置锁定到屏幕的坐标
self.userLocAnnotation.screenPointToLock = userLocScreenPoint;

// 添加当前位置Annotation
    if (![self.mapView.annotations containsObject:self.userLocAnnotation]) {
        [self.mapView addAnnotation:self.userLocAnnotation];
    }

复制

深色

复制成功

6.逆地理编码，获取当前位置周边签到范围内的POI

Objective-C

// 初始化逆地理编码检索对象
BMKGeoCodeSearch *search = [[BMKGeoCodeSearch alloc] init];
// 设置正地理编码检索代理
search.delegate = self;

// 构造逆地理编码检索参数
BMKReverseGeoCodeSearchOption *searchOption = [[BMKReverseGeoCodeSearchOption alloc] init];
// 待解析的经纬度坐标（必选）
searchOption.location = coord;
// 设置POI召回半径,此处等于签到范围半径
searchOption.radius = 500;
// 是否访问最新版行政区划数据（仅对中国数据生效）
searchOption.isLatestAdmin = YES;

// 发起逆地理编码检索请求
[search reverseGeoCode:searchOption];

复制

深色

复制成功

7.获取自定义View截图

Objective-C

// 将当前位置屏幕坐标转换为经纬度坐标
CLLocationCoordinate2D userLocCoord = [self.mapView convertPoint:self.userLocAnnotation.screenPointToLock toCoordinateFromView:self.mapView];
// 判断当前位置是否在签到范围内
BOOL isContains = BMKCircleContainsCoordinate(userLocCoord, self.circleOverlay.coordinate, self.circleOverlay.radius);
if (isContains) { // 在签到范围内
    self.signInCoord = userLocCoord;
} else { // 在签到范围外
    [self showMsg:@"微调距离不可超过500米"];
    [mapView setCenterCoordinate:self.userLocCoord animated:YES];
}

复制

深色

复制成功

8.签到

Objective-C

// 添加签到位置标注
[self.mapView addAnnotation:self.signInLocAnnotation];
// 调用签到接口

复制

深色

复制成功

文档全面上新