使用产品

Android 地图 SDK（该功能已经整合到地图SDK中）

核心类说明

1、TencentMap :地图核心类

2、 TencentLocationManager：用于访问腾讯定位服务的类, 腾讯定位服务可周期性向客户端提供位置更新

3、TencentLocationRequest：定位请求, 客户端使用本类指定定位周期等参数.

4、TencentLocation：地理位置

示例核心点讲解

1、获取手机sensor角度值并过滤

     @Override
   public void onSensorChanged(SensorEvent event) {
       if (System.currentTimeMillis() - lastTime < TIME_SENSOR) {
           return;
       }
       switch (event.sensor.getType()) {
           case Sensor.TYPE_ORIENTATION: {
               float x = event.values[0];
               x += getScreenRotationOnPhone(mContext);
               x %= 360.0F;
               if (x > 180.0F)
                   x -= 360.0F;
               else if (x < -180.0F)
                   x += 360.0F;

               if (Math.abs(mAngle - x) < 3.0f) {
                   break;
               }
               mAngle = Float.isNaN(x) ? 0 : x;
               if (mMarker != null) {
                   mMarker.setRotation(mAngle);
               }
               lastTime = System.currentTimeMillis();
           }
       }

   }

2、获取当前手机屏幕旋转角度

   /**
    * 获取当前屏幕旋转角度
    *
    * @param context
    * @return 0表示是竖屏; 90表示是左横屏; 180表示是反向竖屏; 270表示是右横屏
    */
   public static int getScreenRotationOnPhone(Context context) {
       final Display display = ((WindowManager) context
               .getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay();

       switch (display.getRotation()) {
           case Surface.ROTATION_0:
               return 0;

           case Surface.ROTATION_90:
               return 90;

           case Surface.ROTATION_180:
               return 180;

           case Surface.ROTATION_270:
               return -90;
       }
       return 0;
   }

3、定位回调成功处理Marker绘制

    if (i == TencentLocation.ERROR_OK && locationChangedListener != null) {
         Location location = new Location(tencentLocation.getProvider());
         //设置经纬度以及精度
         location.setLatitude(tencentLocation.getLatitude());
         location.setLongitude(tencentLocation.getLongitude());
         location.setAccuracy(tencentLocation.getAccuracy());
         LatLng latLng = new LatLng(tencentLocation.getLatitude(), tencentLocation.getLongitude());
         addMarker(latLng);
         if(mSensorHelper!=null){
             //定位图标旋转
             mSensorHelper.setCurrentMarker(marker);
         }
         locationChangedListener.onLocationChanged(location);
     }

注意点

       //用于访问腾讯定位服务的类, 周期性向客户端提供位置更新
        locationManager = TencentLocationManager.getInstance(this);
        //设置坐标系
        locationManager.setCoordinateType(TencentLocationManager.COORDINATE_TYPE_GCJ02);
        //创建定位请求
        locationRequest = TencentLocationRequest.create();
        //设置定位周期（位置监听器回调周期）为3s
        locationRequest.setInterval(3000);

        //地图上设置定位数据源
        mTencentMap.setLocationSource(this);
        //设置为true表示显示定位层并可触发定位，false表示隐藏定位层并不可触发定位，默认是false
        mTencentMap.setMyLocationEnabled(true);

使用产品

iOS 地图 SDK

核心类说明

• QMapView：地图核心类，负责显示、控制地图。

示例核心点讲解

1. iOS SDK的定位图标默认是跟随手机方向转动的，只需开启定位功能即可

// iOS SDK的定位图标，默认跟随手机的方向而转动
[self.mapView setShowsUserLocation:YES];

2. 自定义定位图标跟随手机方向转动

1. 隐藏默认的定位图标：

   // 隐藏定位图标
   [self.mapView setUserLocationHidden:YES];
   

2. 创建 Marker 作为定位图标：

   - (QAnnotationView *)mapView:(QMapView *)mapView viewForAnnotation:(id<QAnnotation>)annotation {
       // 定位Marker
       static NSString *userLocationAnnotationIdentifier = @"userLocationAnnotationIdentifier";
       if (annotation == _userLocationAnnotation) {
           _userLocationAnnotationView = (QPinAnnotationView *)[mapView dequeueReusableAnnotationViewWithIdentifier:userLocationAnnotationIdentifier];
           if (_userLocationAnnotationView == nil) {
               _userLocationAnnotationView = [[QPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:userLocationAnnotationIdentifier];
               _userLocationAnnotationView.image = [UIImage imageNamed:@"custom_location"];
           }
           
           return _userLocationAnnotationView;
       }
   
       return nil;
   }
   

3. 在定位回调方法中，更新自定义定位 Marker 图标的位置和转向：

   - (void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation fromHeading:(BOOL)fromHeading {
       // 更新定位Marker和圆环Marker的坐标
       __weak typeof(self) weakSelf = self;
       [UIView animateWithDuration:0.5 animations:^{
           weakSelf.userLocationAnnotation.coordinate = userLocation.location.coordinate;
       }];
       
       // 更新定位Marker的转向
       if (weakSelf.userLocationAnnotationView) {
           [UIView animateWithDuration:0.1 animations:^{
               weakSelf.userLocationAnnotationView.transform = CGAffineTransformMakeRotation(M_PI * (userLocation.heading.trueHeading) / 180.0);
           }];
       }
   }
   

注意点

• 如果只需要简单替换定位标的图片，而不需要复杂自定义功能的话，可以通过接口直接替换：

  /**
   * @brief 配置当前位置UI属性 (必须在QMapView 初始化以后, 定位开启之前调用)
   *
   * @param presentation 位置UI属性
   */
  - (void)configureUserLocationPresentation:(QUserLocationPresentation *)presentation;