使用产品

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

核心类说明

示例核心点讲解

LatLngBounds latLngBounds = new LatLngBounds(new LatLng(39.923297, 116.402335),new LatLng(39.912666, 116.391907));
        //获取地图状态
        CameraPosition cameraPosition = tencentMap.getCameraPosition();
        //添加多边形,并设置多边形相关属性
        Polygon polygon = tencentMap.addPolygon(new PolygonOptions().add( 
                latLngBounds.getNorthEast(),
                latLngBounds.getSouthEast(),
                latLngBounds.getSouthWest(),
                latLngBounds.getNorthWest())
                .fillColor(Color.TRANSPARENT)
                .strokeWidth(2)
                .strokeColor(Color.BLUE));
        // 基于宽度限制地图显示范围
        tencentMap.setRestrictBounds(latLngBounds, RestrictBoundsFitMode.FIT_WIDTH);
        //基于高度显示地图范围
        tencentMap.setRestrictBounds(latLngBounds, RestrictBoundsFitMode.FIT_HEIGHT);

注意点

地图缩放级别：zoomLevel [1~20]

使用产品

iOS 地图 SDK

核心类说明

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

示例核心点讲解

1. 获取地图 QMapRect 结构数据

1. 在示例中，我们演示了限制显示区域为故宫博物院园区范围，通过 QGeometry 中提供的方法将园区的西北角和东南角坐标构成的范围转化为 QMapRect：

   - (QMapRect)getMapRect
   {
       // 故宫.
       QMapPoint points[2];
       points[0] = QMapPointForCoordinate(CLLocationCoordinate2DMake(39.922804, 116.391735));
       points[1] = QMapPointForCoordinate(CLLocationCoordinate2DMake(39.913390, 116.402330));
       
       return QBoundingMapRectWithPoints(points, 2);
   }
   

2. 通过计算出的 QMapRect 范围，可以用 QGeometry 提供的方法，来计算 mapRect 的最大最小 X 和 Y 值，然后使用Polygon标记限制区域范围：

   - (void)setupPolygon
   {
       QMapRect rect = [self getMapRect];
       
       CGFloat minx = QMapRectGetMinX(rect);
       CGFloat miny = QMapRectGetMinY(rect);
       CGFloat maxX = QMapRectGetMaxX(rect);
       CGFloat maxY = QMapRectGetMaxY(rect);
       
       QMapPoint pointForPolygon[4];
       pointForPolygon[0] = QMapPointMake(minx, miny);
       pointForPolygon[1] = QMapPointMake(maxX, miny);
       pointForPolygon[2] = QMapPointMake(maxX, maxY);
       pointForPolygon[3] = QMapPointMake(minx, maxY);
       
       QPolygon *polygon = [[QPolygon alloc] initWithPoints:pointForPolygon count:4];
       [self.mapView addOverlay:polygon];
   }
   

2. 设置限定区域

1. 限定宽度区域，以传入的 mapRect 的宽度为参考值限制地图的控制区域，保证横向区域可以完全显示

   - (void)handleFitWidthMode
   {
       QMapRect rect = [self getMapRect];
       
       // 传入对应的区域进行限制, 以区域宽度为参考值.
       [self.mapView setLimitMapRect:rect mode:QMapLimitRectFitWidth];
   }
   

2. 限定高度区域，以传入的 mapRect 的高度为参考值限制地图的控制区域，保证纵向区域可以完全显示

   - (void)handleFitHeightMode
   {
       QMapRect rect = [self getMapRect];
       
       // 传入对应的区域进行限制, 以区域高度为参考值.
       [self.mapView setLimitMapRect:rect mode:QMapLimitRectFitHeight];
   }
   

3. 限定地图的缩放范围，地图的缩放级别不会超过传入的 minZoomLevel 和 maxZoomLevel：

   - (void)handleLimitZoomLevel
   {
       /**
        *  设置限定区域后, 地图会以所传入的区域的最小可展示级别作为地图的最小显示级别, 地图显示级别不会小于该级别.
        *  如: 传入的区域的最小显示级别为 16, 则地图的最小显示级别为 16.
        *  用户可以搭配 setMinZoomLevel: maxZoomLevel: 接口进行地图的最小, 最大显示级别调整.
        */
       [self.mapView setMinZoomLevel:16 maxZoomLevel:self.mapView.maxZoomLevel];
   }
   

4. 取消宽高限制和缩放范围限制：

   - (void)handleCancelLimitMapRect
   {
       // 当传入的 mapRect 的四个值为 0 时, 可取消区域限制(两种模式下都可行).
       QMapRect cancelRect = QMapRectMake(0, 0, 0, 0);
       [self.mapView setLimitMapRect:cancelRect mode:QMapLimitRectFitWidth];
       
       // 恢复地图最小最大级别.
       [self.mapView setMinZoomLevel:3 maxZoomLevel:self.mapView.maxZoomLevel];
   }
   

注意点

• 地图的缩放级别范围：3 <= minZoomLevel <= maxZoomLevel <= 20。