Mapbox初始配置：依赖添加

官网教程指引： https://docs.mapbox.com/android/maps/guides/install/
我使用的android studio版本是旧版，依赖添加方式如下：

1. 编辑 项目目录/build.gradle （设置maven库的访问）；

Android Studio less than Arctic Fox (2020.3.1) and Gradle less than v6.0:
注意，是在 allprojects 内设置！

buildscript {...
}
allprojects {repositories {google()mavenCentral()maven {url 'https://api.mapbox.com/downloads/v2/releases/maven'authentication {basic(BasicAuthentication)}credentials {username = "mapbox"// Use the secret token you stored in gradle.properties as the passwordpassword = project.properties['MAPBOX_DOWNLOADS_TOKEN']}}}
}

2. 前往mapbox官网 创建账号 并 申请密钥；

Token申请地址： https://account.mapbox.com/
申请token时记得勾选 Downloads:Read 以获取从maven库下载mapbox依赖文件的许可。

创建完成之后在Token页面会有两个Token：
其中一个为初始就有的公钥；一个为你刚刚申请好的带有Downloads:Read权限的私钥。
（注意：私钥申请完成后要直接复制保存，刷新页面后会被隐藏）。

3. 在项目中配置公钥、私钥；

在 项目目录下的 gradle.properites 中添加以下代码，用于从maven库下载mapbox相关依赖的身份验证。

MAPBOX_DOWNLOADS_TOKEN=自己申请的私钥

在 res/valuses/strings.xml 文件中添加以下代码。mapbox默认你 将token放置在 strings.xml 中，在调用相关api时会 自动 在此文件夹下面获取token。

<string name="mapbox_access_token">公钥</string>

4. 在 模块目录 /build.gradle 中添加依赖；

// mapbox地图组件
implementation 'com.mapbox.maps:android:10.3.0'

5. 配置获取用户定位权限；（可选）

在 AndroidManifest.xml 文件中添加以下代码*（当你需要在地图上显示用户位置时才需要配置）*
注意： 还需要在代码中动态请求该权限，Mapbox也提供了PermissionsManager（可参考官网示例）工具用于动态请求权限，这里不展开）

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

可能遇到的问题：
① sync gradle文件时报warnning：
问题： Failed to resolve: com.mapbox.maps:android:10.0.3
解决： 检查自己申请的token是否带有 Downloads:Read，在创建token时记得勾选上，系统默认提供的token是不带这个scope的，需要自行申请。
————————————————————————————————————————————

MapBox部分功能的Android实现：

这部分对MapBox的主要用例的Android实现和原理进行相关解释（示例版本10.3.0）。
由于官网有kotlin代码的例子，以下功能展示均使用 java代码 进行举例。

以下介绍的功能代码我都封装到了MapBoxUtil.java文件中，可以在这个项目里面自行获取。（结合这个示例项目的代码阅读更佳哦）

效果图先行：

· 地图MapView的添加

layout文件中添加MapView视图：

<com.mapbox.maps.MapViewandroid:id="@+id/mapview"android:layout_width="match_parent"android:layout_height="match_parent"/>

Java文件：

MapView mMapView = findViewById(R.id.mapview);
MapboxMap mMapboxMap = mapView.getMapboxMap();

· MapBox初始化以及地图显示：

1. 相机设置：

相机部分参数初始变量定义：

private static final double DEFAULT_LOCATION_LATITUDE = 22.55;    // 初始地图显示坐标（深圳）
private static final double DEFAULT_LOCATION_LONGITUDE = 114.06;
private static final double DEFAULT_ZOOM_VALUE = 8.0;   // 初始地图缩放大小

相机设置：

mMapboxMap.setCamera(  // 设置地图相机初始位置new CameraOptions.Builder().center(Point.fromLngLat(DEFAULT_LOCATION_LONGITUDE, DEFAULT_LOCATION_LATITUDE)).zoom(DEFAULT_ZOOM_VALUE).build());

相机更多参数设置：
https://docs.mapbox.com/android/maps/guides/camera-and-animation/camera/

2. 地图加载：

地图类型变量定义：

private static final String DEFAULT_MAP_STYLE = Style.MAPBOX_STREETS;   // 地图显示样式

加载地图：

mMapboxMap.loadStyleUri(   // 加载地图DEFAULT_MAP_STYLE, style -> {// style 加载完成回调});

更多地图类型：
https://docs.mapbox.com/android/maps/guides/styles/set-a-style/

· MapBox各种功能插件获取：

mMapView .getPlugin(Plugin.MAPBOX_XXX_PLUGIN_ID);        //XXX因插件而异

1. 地图 Logo 插件

LogoPlugin logoPlugin =  mMapView .getPlugin(Plugin.MAPBOX_LOGO_PLUGIN_ID);
// 隐藏 Logo
if (logoPlugin != null) {logoPlugin.setEnabled(false);
}

2. 地图Logo旁属性按钮插件

AttributionPlugin attributionPlugin = mMapView .getPlugin(Plugin.MAPBOX_ATTRIBUTION_PLUGIN_ID);
// 隐藏 属性按钮
if (attributionPlugin != null) {attributionPlugin.setEnabled(false);
}

3. 比例尺Scalebar插件

ScaleBarPlugin scaleBarPlugin = mMapView .getPlugin(Plugin.MAPBOX_SCALEBAR_PLUGIN_ID);
// 隐藏 比例尺
if (scaleBarPlugin != null) {scaleBarPlugin.setEnabled(false);
}

4. 指南针插件

CompassPlugin compassPlugin = mMapView .getPlugin(Plugin.MAPBOX_COMPASS_PLUGIN_ID);
if (compassPlugin == null) {return;
}
compassPlugin.setEnabled(isEnable); // 隐藏指南针
compassPlugin.setImage(drawable);   // 更换指南针icon

以上UI相关的插件均可以通过相关api设置显示位置和大小，这里不举例说明。

5. 相机动画插件

相机位置改变：
若只是简单的直接改变相机位置的话，使用上述相机初始化中的mMapboxMap.setCamera方法即可。
若想要添加移动的动画，如从当前显示位置缓慢变换到目的位置，则需要相机动画插件CameraAnimationsPlugin

CameraAnimationsPlugin cameraAnimationsPlugin = mMapView.getPlugin(Plugin.MAPBOX_CAMERA_PLUGIN_ID);

相机移动方法举例：

/*** 将摄像头移动到指定位置* @param point 目标坐标* @param zoom  目标缩放比例* @param duration 滑动总时间 0为无动画*/
public void moveCameraTo(Point point, double zoom, int duration) {if (mMapView == null) {return;}if (duration != 0 && cameraAnimationsPlugin != null) {cameraAnimationsPlugin .flyTo(new CameraOptions.Builder().center(point).zoom(zoom).build(),new MapAnimationOptions.Builder().duration(duration).build());} else {mMapboxMap.setCamera(new CameraOptions.Builder().center(point).zoom(zoom).build());}
}

更多相机动画：
https://docs.mapbox.com/android/maps/guides/camera-and-animation/animations

6. 地图手势监听插件

可以监听地图相关运行中状态，Mapbox提供了手势插件供我们监听各种地图状态：

GesturesPlugin gesturesPlugin = mMapView.getPlugin(Plugin.MAPBOX_GESTURES_PLUGIN_ID);

下面以监听地图移动为例：

if (gesturesPlugin != null) {gesturesPlugin .addOnMoveListener(onMoveListener); // 注意onDestroy时要remove掉Listener
}
// 地图移动监听
private final OnMoveListener onMoveListener = new OnMoveListener() {@Overridepublic void onMoveBegin(@NotNull MoveGestureDetector moveGestureDetector) {// 地图开始移动}@Overridepublic boolean onMove(@NotNull MoveGestureDetector moveGestureDetector) {return false;}@Overridepublic void onMoveEnd(@NotNull MoveGestureDetector moveGestureDetector) {// 地图移动结束}
};

更多用户交互监听：
https://docs.mapbox.com/android/maps/guides/user-interaction

7. 用户地理位置获取插件

效果图先行：

MapBox获取用户位置主要通过 LocationComponentPlugin 插件获取：

LocationComponentPlugin locationPlugin = mMapView.getPlugin(Plugin.MAPBOX_LOCATION_COMPONENT_PLUGIN_ID);

① 设置用户位置点显示UI样式：

设置脉冲显示效果：

locationPlugin.updateSettings(locationComponentSettings -> {locationComponentSettings.setEnabled(true);locationComponentSettings.setPulsingEnabled(true);  // 脉冲效果return null;
});

设置位置点样式：
通过插件的 setLocationPuck() 方法进行设置，方法接受四个参数。前三个为上\中\下层图标样式设置，最后一个接受 Expression表达式 用于配置 位置点图标的缩放scale数值规则。
（Expression表达式的本质是Json语句，是Mapbox自定义的一种描述性变量，具体Expression所涵盖的运算符可参考官网，我们可以在使用的过程中逐渐了解各运算符具体含义）
这里我们选择 生成一个随地图缩放变化规则的Expression：
我们使用 InterpolatorBuilder 来生成一个插值表达式。
下面例子的插值表达式表示当地图zoom为0时，图标scale为1；当zoom为20时，图标scale为1.5；其间值线性插值获得。

• linear运算符用于对一队stop值间的数据做线性插值运算；
• zoom表达式添加上了图标大小随地图缩放大小的羁绊。

从结果上来看即生成了如下json表达式：（清楚Expression编写规则后，直接编写json表达式也可以实现同样的效果）

["interpolate",["linear"],["zoom"],0.0,1.0,20.0,1.5]

代码如下所示：

// 设置图标随地图缩放比例变化
Expression.InterpolatorBuilder interpolatorBuilder = new Expression.InterpolatorBuilder("interpolate");
interpolatorBuilder.linear();
interpolatorBuilder.zoom();
interpolatorBuilder.stop(expressionBuilder -> {expressionBuilder.literal(0.0);expressionBuilder.literal(1.0);return null;
});
interpolatorBuilder.stop(expressionBuilder -> {expressionBuilder.literal(20.0);expressionBuilder.literal(1.5);return null;
});
// 设置用户位置图标样式
locationPlugin.setLocationPuck(new LocationPuck2D(null,AppCompatResources.getDrawable(mContext, R.drawable.mapbox_user_icon),AppCompatResources.getDrawable(mContext, R.drawable.mapbox_user_stroke_icon),interpolatorBuilder.build().toJson()));

官网例子：
https://docs.mapbox.com/help/tutorials/mapbox-gl-js-expressions/#add-a-zoom-expression

② 添加用户位置监听器

// 添加用户位置监听器
// 注意onDestroy时要remove掉Listener
locationPlugin.addOnIndicatorPositionChangedListener(onIndicatorPositionChangedListener);
// 用户位置改变监听
private final OnIndicatorPositionChangedListener onIndicatorPositionChangedListener =new OnIndicatorPositionChangedListener() {@Overridepublic void onIndicatorPositionChanged(@NotNull Point point) {// point即为用户位置}
};

③ 移动相机到用户的位置：
移动相机方法参见 5.相机动画插件 部分，在onIndicatorPositionChanged回调中根据point参数进行移动即可。
需要注意的是，onIndicatorPositionChanged监听器在remove前会持续回调，需编写相关移动相机的条件，否则地图移动手势将会失效。
官网教程：
https://docs.mapbox.com/android/maps/guides/user-location/

8. 地图标记插件

Mapbox提供了annotationPlugin 插件供用户在地图上快捷添加标记。添加标记的方法如下所示
注意：以下标记的添加需要在地图初始化加载完成后进行，即style加载完后进行。

AnnotationPlugin annotationPlugin = mMapView.getPlugin(Plugin.MAPBOX_ANNOTATION_PLUGIN_ID);

[举例] 向地图添加点标记（可以显示icon + text）

// 注册点标记管理器
PointAnnotationManager pointAnnotationManager = (PointAnnotationManager)annotationPlugin .createAnnotationManager(AnnotationType.PointAnnotation, null);/*** 在地图中添加Point类型标记* @param longitude 添加坐标X* @param latitude  添加坐标Y*/
public void addPointAnnotationInMap(int drawable, double longitude, double latitude) {if(annotationPlugin == null){return;}if (pointAnnotationManager == null) {pointAnnotationManager = (PointAnnotationManager)annotationPlugin .createAnnotationManager(AnnotationType.PointAnnotation, null);}// Set options for the resulting symbol layer.PointAnnotationOptions pointAnnotationOptions = new PointAnnotationOptions().withPoint(Point.fromLngLat(longitude, latitude)).withIconImage(BitmapUtil.getBitmapFromDrawable(mContext, drawable));// Add the pointAnnotation to the map.pointAnnotationManager .create(pointAnnotationOptions);
}

pointAnnotationOptions中还有很多方法可以设置，这里不再举例。
更多标记类型：
https://docs.mapbox.com/android/maps/guides/annotations/annotations/

除次之外Mapbox还提供了ViewAnnotation，用户可以利用此添加自定义样式的标记，添加方法如下所示：

ViewAnnotationManager viewAnnotationManager = mMapView.getViewAnnotationManager();

以下方法举例了如何在ViewAnnotationManager添加自定义的View标记：

    /*** 在地图中添加View标记 [需补充代码后使用]* @param longitude 添加坐标* @param latitude  添加坐标* @param onClickListener   view点击回调*/public void addViewAnnotationInMap(double longitude, double latitude, View.OnClickListener onClickListener) {if (viewAnnotationManager == null) {viewAnnotationManager = mMapView.getViewAnnotationManager();}
//        View markView = viewAnnotationManager.addViewAnnotation(R.layout.item_map_image_view,    // view的layout id
//                new ViewAnnotationOptions.Builder()
//                        .geometry(Point.fromLngLat(longitude, latitude))
//                        .allowOverlap(true)   // 允许markView重叠
//                        .build());// 初始化 layout中的组件 markView.findViewById(R.id.xxx)// ...}

上述两种添加方式在 少量(<200) 标记时不会造成地图组件卡顿（应设备而异），若要添加大量标记，上述方法性能问题不容乐观。
mapbox对此提供了 style layer 的解决方案，用于添加 大量图标 时的性能保证。

style layer 添加地图标记，并实现聚类的方法见下一篇文章：Android地图—— Mapbox 10.3.0 聚类标签实现。

Android地图—— Mapbox 10.3.0 接入与基础使用相关推荐

1. Redhat 5.4 Orcle RAC 数据库 从10.2.0.1升级到 10.2.0.4

   之前安装的是两个节点的RAC 平台. 数据库版本是10.2.0.1. 这个实验的目的就是将这个数据库版本从10.2.0.1 升级到 10.2.0.4.  升级包可以从Oracle metalink上进 ...

2. 谷歌手机升级android10,Android Q安卓10.0新特性，首批支持升级21款手机

   原标题:Android Q安卓10.0新特性,首批支持升级21款手机 2019年5月8日,一年一度的谷歌I/O开发者大会在美国加州如期召开,并发布了全新系列Android Q(安卓10.0)操作系统, ...

3. Android Q（10.0）版本新特性和兼容性适配

   北京时间2019年3月14日Google正式对外发布Android Q Beta 1及预览版SDK,这意味着安卓开发者们又即将迎来一年一度的新版本适配工作了.Android Q 为开发者们带来了许多新 ...

4. Android O（SDK 8.0）新特性，刘海屏

   > Android刘海屏 Android 屏幕,16:9,17:9,19:10,18:9,18.5:9所谓全面屏.挖孔屏.凹凸屏等. android 全面屏/刘海屏有效适配- https://b ...

5. Android课程设计：基于离线地图服务器的Android地图应用

   Android开发课程设计:基于离线地图服务器的Android地图应用 此项目的灵感来源于伯克利cs61b的Project3: cs61b的官网地址:Project 3: Bear Maps 我的实验 ...

6. Android地图定位开发技术汇总

   Android地图定位开发技术汇总 由于课程需要,我查询了一些Android中的地图定位开发技术,该技术在理论课日常练习中应用到了模拟高德地图APP开发中,同时也运用到了实验课结业大作业--小农夫AP ...

7. 国外卫星地图mapbox的图形绘制

   今天我继续说在线地图mapbox的其他基本操作,之前已经讲过如何引入mapbox,token的获取,语言的设置及绘制多边形等:现在我们再来学些其他的基本操作 1.添加多边形 如下列代码所示,就是添加一 ...

8. 关于android的4.2的0文件夹的详解

   关于android的4.2的0文件夹的详解 ---- android 4.0 ---- 在galaxy nexus(GN)手机上userdata分区很大,被挂在/data目录,用户的数据通常是放在sd ...

9. android百度地图例子,使用百度地图API进行Android地图应用开发（Eclipse）(示例代码)...

   随着基于位置的服务的兴起,地图类App呈现爆发趋势.随着而来的是地图供应商开放大量的API.供开发人员开发基于PC或者移动端的应用程序. 如今我们研究使用百度地图SDK进行Android项目的开发. ...

10. Android小知识10则(上)(2018.8重编版)

    Android小知识10则(下) 目录 前言 横竖屏锁定 不同分辨率的图标 将字符串写在资源文件中 为AlertDialog设置点击监听 ProgressDialog了解一下 最后 前言 Androi ...

最新文章

1. Scala在挖财的应用实践
2. try catch用法_synchronized用法总结
3. IntelliJ IDEA中无法加载jar包导致出现“cannot resolve symbol...”问题的解决
4. MAC配置JCO，与找不到sapjco3异常
5. python 函数参数传递机制_Python函数参数传递机制（超级详细）
6. 开发人员不可不知的六大JavaScript框架 传统网站网页转移动端方式
7. SpringBoot2.1.5 （10)--- Http接口之POST,PUT,DELETE 请求
8. c语言 define宏名称if(参数),宏编程基础内容
9. python进阶07并发之三其他问题
10. Dart获取系统和硬件信息
11. 【CCCC】L3-002 特殊堆栈 (30分)，nlogn维护序列中位数，STL大乱斗，有重multiset，vector+二分插入
12. PySpark : Structured Streaming
13. C#针式打印机自定义纸张连续打印爬坑过程
14. Android 11.0 蓝牙的启用和禁用
15. 反相比例运放反馈电阻并联电容和积分电路区别，以及积分电路中反馈电容并联电阻的区别。阻值和容值参数大小不同，电路性质也就不同了
16. AI First：互联网进步的背后，反映出的是流量的再分配
17. 日本海淘转运运输方式对比及如何选择转运渠道
18. c语言采用解释方式6,C语言程序设计题目及解答-01.doc
19. 读稻盛先生的《活法和干法》的十点灵感
20. pylint代码检查常见警告、提示的解决方法记录

热门文章

1. Drool规则引擎入门实例
2. php 微信支付h5 referer,微信H5支付
3. 嵌入式、单片机开发必备软件
4. 【OEIS】Xor Sum AtCoder2272
5. VM14 启动Ubutun16.04 黑屏，实用解决办法
6. bootdo 重命名 版本2.0 （适合所有springboot项目）
7. CSDN博文写作规范文档
8. 4款idea主题,非常的炫酷
9. Java基础编程题(API阶段测试)
10. 基于OpenCv的人脸识别（Python完整代码）