使用产品

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

核心类说明

2、 Polygon ：多边形

3、PolygonOptions：构造多边形的点集

示例核心点讲解

1、添加多边形

       polygon = mTencentMap.addPolygon(new PolygonOptions().
                add(latLngs)
                .fillColor(Color.TRANSPARENT)
                .strokeWidth(5)
                .visible(true)
                .strokeColor(Color.BLUE));

2、设置Marker拖动事件的监听接口

       mTencentMap.setOnMarkerDragListener(new TencentMap.OnMarkerDragListener() {
            @Override
            public void onMarkerDragStart(Marker marker) {
                //当前手指按住Marker拖拽开始
                LatLng position = marker.getPosition();
                if (polygon.contains(position)) {
                    //在围栏内
                    textView.setText("在围栏内");
                } else {
                    //在围栏外
                    textView.setText("在围栏外");
                }

            }

            @Override
            public void onMarkerDrag(Marker marker) {
                //当前手指按住Marker拖拽中
                LatLng position = marker.getPosition();
                if (polygon.contains(position)) {
                    //在围栏内
                    textView.setText("在围栏内");
                } else {
                    //在围栏外
                    textView.setText("在围栏外");
                }
            }

            @Override
            public void onMarkerDragEnd(Marker marker) {
                //当前手指按住Marker拖拽结束
                LatLng position = marker.getPosition();
                if (polygon.contains(position)) {
                    //在围栏内
                    textView.setText("在围栏内");
                } else {
                    //在围栏外
                    textView.setText("在围栏外");
                }
            }
        });
    }

注意点

1、 Marker默认是不被拖动的,所以要设置 支持拖动

      marker.setDraggable(true);

2、PolygonOptions可以设置填充颜色、描边宽度、描边颜色等等

      polygonOptions.fillColor();
      polygonOptions.strokeWidth();
      polygonOptions.strokeColor();

使用产品

iOS 地图 SDK

核心类说明

1. QMapView：地图核心类，负责显示、控制地图。
2. QGeometry：地图几何运算类，该类包含地图的一些数据结构以及几何算法。

示例核心点讲解

1. 绘制多边形

1. 示例以腾讯北京总部大楼为例绘制矩形：

   CLLocationCoordinate2D locations[4];
   locations[0] = CLLocationCoordinate2DMake(40.041408, 116.271614);
   locations[1] = CLLocationCoordinate2DMake(40.041868, 116.274479);
   locations[2] = CLLocationCoordinate2DMake(40.038928, 116.275187);
   locations[3] = CLLocationCoordinate2DMake(40.0385, 116.272151);
   
   _polygon = [[QPolygon alloc] initWithWithCoordinates:locations count:4];
   [self.mapView addOverlay:_polygon];
   

2. 在腾讯北京总部大楼中心添加Marker，即Marker默认是在矩形范围内部：

   QPointAnnotation *point = [[QPointAnnotation alloc] init];
   point.coordinate = CLLocationCoordinate2DMake(40.040258, 116.273406);
   [self.mapView addAnnotation:point];
   

2. 实现Marker拖动代理方法，判断Marker所在点是否在矩形范围内：

1. 在创建Marker时，开启Marker的长按拖拽功能：

   - (QAnnotationView *)mapView:(QMapView *)mapView viewForAnnotation:(id<QAnnotation>)annotation {
       static NSString *pointIdentifier = @"PointIdentifier";
       QPinAnnotationView *pinView = (QPinAnnotationView *)([mapView dequeueReusableAnnotationViewWithIdentifier:pointIdentifier]);
       if (pinView == nil) {
           pinView = [[QPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:pointIdentifier];
           // 开启Marker拖拽功能
           pinView.draggable = YES;
       }
       
       return pinView;
   }
   

2. 实现Marker拖拽代理方法，监听拖拽的状态，并判断Marker所在点是否在矩形范围内：

   - (void)mapView:(QMapView *)mapView annotationView:(QAnnotationView *)view didChangeDragState:(QAnnotationViewDragState)newState fromOldState:(QAnnotationViewDragState)oldState {
       
       // 取出当前annotation的坐标点
       CLLocationCoordinate2D currentLocation = view.annotation.coordinate;
       // 将坐标转为QMapPoint
       QMapPoint currentPoint = QMapPointForCoordinate(currentLocation);
       
       // 判断点是否进入了围栏区域
       BOOL isWalkIn = QPolygonContainsPoint(currentPoint, _polygon.points, 4);
       
       if (isWalkIn) {
           _label.text = @"进入地理围栏区域";
       } else {
           _label.text = @"离开地理围栏";
       }
   }
   

注意点

1. SDK提供了两个方法，用于判断点是否在多边形内，开发者可根据业务需求选择：

   /**
    *  @brief 判断点是否在多边形内部
    *
    *  @param point   点
    *  @param polygon 多边形端点
    *  @param count   多边形端点个数
    *
    *  @return 是否在内
    */
   extern BOOL QPolygonContainsPoint(QMapPoint point, QMapPoint *polygon, NSUInteger count);
   
   /**
    *  @brief 判断点是否在多边形内
    *  @param coordinate 经纬度点
    *  @param polygon    多边形端点
    *  @param count      多边形端点个数
    *  @return 是否在内
    */
   extern BOOL QPolygonContainsCoordinate(CLLocationCoordinate2D coordinate, CLLocationCoordinate2D *polygon, NSUInteger count);
   

2. 示例中只演示了矩形图层 QPolygonView，开发者也可以使用圆形图层 QCircleView；

3. 示例只是演示简单的点和面关系的判断，开发者也可以结合定位功能，通过定位回调方法获取用户的当前坐标，再根据点面关系的判断来实现地理围栏功能：

   /**
    * @brief 用户位置更新后，会调用此函数
    * @param mapView 地图View
    * @param userLocation 新的用户位置
    * @param fromHeading 是否为heading 变化触发，如果为location变化触发,则为NO
    */
   - (void)mapView:(QMapView *)mapView didUpdateUserLocation:(QUserLocation *)userLocation fromHeading:(BOOL)fromHeading;