浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WebAPI文档全面上新

新增示例代码、在线运行等功能,帮助您实现快速接入,前往体验吧!

体验新版
更新时间:2020-06-23
自定义瓦片图层

地图SDK自v3.6.0起,新增瓦片图层(TileOverlay), 该图层支持开发者添加自有瓦片数据,包括本地加载和在线下载两种方式。该图层可随地图的平移、缩放、旋转等操作做相应的变换,它仅位于底图之上(即瓦片图层将会遮挡底图,不遮挡其他图层),瓦片图层的添加顺序不会影响其他图层(例如:POI搜索图层、我的位置图层等)的叠加关系。

通过瓦片图层可对基础底层地图添加额外的特性,如:某个商场的室内信息、某个景区的详情等等。自定义图层类是MBKTileOverlay,它定义了能添加到基础底层地图的图片集合。

适用于开发者拥有某一区域的地图,并希望使用此区域地图覆盖相应位置的百度地图。

瓦片图划分规则

百度地图SDK会根据不同的比例尺将地图划分成若干个瓦片,并且以中心点经纬度(0,0)开始计算瓦片,当地图显示缩放级别增大时,每一个瓦片被划分成4 个瓦片。

如:地图级别为0时,只有1张瓦片地图级别为1时,会分成 1 * 4 = 4 张瓦片依次类推,地图级别为n时,总共划分的瓦片为:4的n次方,为了保证瓦片的显示效果,第n级的瓦片显示的地图level范围为[n - 0.5, n + 0.5)

瓦片图绘制方式

瓦片图层的绘制方式包括本地加载和在线下载两种方式。
1、本地加载

瓦片图层通过TileOverlay类定义,开发者需要实现FileTileProvider抽象类来加载打包至项目中的瓦片图资源,并通过TileOverlayOptions类设置。通过addTileLayer方法将TileOverlayOptions对象添加至地图。

注:瓦片图的尺寸必须满足256 * 256

示例代码如下:

/**
 * 定义瓦片图的离线Provider,并实现相关接口
 * MAX_LEVEL、MIN_LEVEL 表示地图显示瓦片图的最大、最小级别
 * Tile 对象表示地图每个x、y、z状态下的瓦片对象
 */
tileProvider = new FileTileProvider() {
    @Override
    public Tile getTile(int x, int y, int z) {
        // 根据地图某一状态下x、y、z加载指定的瓦片图
        String filedir = "LocalTileImage/" + z + "/" + z + "_" + x + "_" + y + ".jpg";
        //将瓦片图资源解析为Bitmap
        Bitmap bm = getFromAssets(filedir);
        if (bm == null) {
            return null;
        }
        // 通过瓦片图bitmap构造Tile示例
        offlineTile = new Tile(bm.getWidth(), bm.getHeight(), toRawData(bm));
        bm.recycle();
        return offlineTile;
    }
    @Override
    public int getMaxDisLevel() {
        return MAX_LEVEL;
    }
    @Override
    public int getMinDisLevel() {
        return MIN_LEVEL;
    }
};

//构造TileOverlayOptions对象并设置FileTileProvider等属性
TileOverlayOptions options = new TileOverlayOptions();
// 构造显示瓦片图范围,当前为世界范围
LatLng northeast = new LatLng(80, 180);
LatLng southwest = new LatLng(-80, -180);
options.tileProvider(tileProvider)
        .setPositionFromBounds(new LatLngBounds.Builder().include(northeast).include(southwest).build());
//向地图添加离线瓦片图对象
tileOverlay = mBaiduMap.addTileLayer(options);

显示效果如图:

Screenshot_20200609_172923_baidumapsdk.demo.jpg

2、在线下载

开发者需要实现UrlTileProvider抽象类,在其中设置缩放级别范围和在线瓦片图的URL地址。

示例代码如下:

/**
 * 定义瓦片图的在线Provider,并实现相关接口
 * MAX_LEVEL、MIN_LEVEL 表示地图显示瓦片图的最大、最小级别
 * urlString 表示在线瓦片图的URL地址
 */
TileProvider tileProvider = new UrlTileProvider() {
    @Override
    public int getMaxDisLevel() {
        return MAX_LEVEL;
    }
    @Override
    public int getMinDisLevel() {
        return MIN_LEVEL;
    }
    //传入在线瓦片图的URL地址
    @Override
    public String getTileUrl() {
        return urlString;
    }
};

TileOverlayOptions options = new TileOverlayOptions();
// 构造显示瓦片图范围,当前为世界范围
LatLng northeast = new LatLng(80, 180);
LatLng southwest = new LatLng(-80, -180);

// 通过option指定相关属性,向地图添加在线瓦片图对象
tileOverlay = mBaiduMap.addTileLayer(options.tileProvider(tileProvider).setMaxTileTmp(TILE_TMP)
        .setPositionFromBounds(new LatLngBounds.Builder().include(northeast).include(southwest).build());

显示效果如图:

Screenshot_20200609_172913_baidumapsdk.demo.jpg

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消