Android开发，MapBox地图详细介绍、使用、部分功能实现（初始化、标记、定位、styleurl）

MapBox介绍：

MapBox 最初是与 OpenStreetMaps 合作的开源项目，后来开始独立发展。当 Google 开始为地图 API 收费的时候，Mapbox 获得了巨大的发展机会。它的客户曾有 NPR、卫报、绿色和平组织和 FCC ，如今它为 Foursquare、Evernote 等公司提供地图服务。最近，MapBox 开始了一项野心勃勃的计划——构建世界上最漂亮的地图。它有什么秘密武器？Wired 网站采访了公司的高管。

　　如果放大观察我们所使用的卫星地图，你可能会发现接缝，地表颜色的突然变化，以及某些非常模糊的区域。这是因为它是由不同来源的图片拼接起来的。对于 MapBox 来说，消灭这些瑕疵是一种使命。

　　一直以来，MapBox 的地图使用的是 OpenStreetMap 的矢量数据。但是从 2012 年 12 月开始，在数据分析师 Chris Herwig 的带领下，公司发布了第一版的卫星地图。今年 2 月，MapBox 雇佣了图形专家 Charlie Loyd，以帮助他们完善产品。在加入 Mapbox 之前，Charlie Loyd 已经着手开发制作漂亮卫星图的方法。他在 Twitter 上的一副对比图引起了公司的兴趣，并很快被聘用。

　　Mapbox 使用的数据来自 NASA 的 LANCE-MODIS 数据系统。“在新版中，我们处理了两年的图像，这些图像捕获自 2011 年 1 月 1 日到 2012 年 12 月 31 日，”Loyd 说，“这包括了 33900 个 16 万像素的卫星图片，总共超过 5,687,476,224,000 个像素。我们将其缩减到了大概 50 亿个像素”。

　　他们用了 30 至 40 个服务器，从 NASA 下载的压缩数据达到 0.6 TB。在此过程中，NASA 很积极的进行了配合。Chris Herwig 对此心存感激，“当提到开放政府的时候，人们谈论的都是 API。但我们真正需要的是政府有保证大规模下载的基础设施。”

　　当 Mapbox 获得这些数据后，他们需要处理这些图像，去掉云层、太阳耀光和大气雾霾。通常的做法是，选择某个区域天气最好的时刻，然后将它们拼接，但是这样会使地图上出现接缝。为解决这个问题，Mapbox 采用了特别的方法。他们将某一个地区的所有图片叠加，然后依据清晰度重新排列每一行的像素。“我们处理世界上的每一个像素”，Loyd 说。他们选出最清晰的像素，使其成为地图上的固定像素。这是一项规模庞大的工作。

　　除了清晰度之外，Mapbox 还考虑到地层上的颜色。他们用技术确保图片展示的是植物生长最旺盛的时候。“这是完全自然的产品，”Loyd 说，“每个像素都是空中摄像头捕获的真实像素，但它又是完全合成的。”

　　他们的目标是，一个理想化的无云层星球，处于永恒的夏季。

　　在公司的 CEO Eric Gundersen 看来，这个项目的意义不仅仅是做出漂亮的地图，更重要的是展示了自己快速处理海量数据的能力。这是一个软件公司的优势所在。另外，公司认为，清晰的卫星地图有助科学研究，也对大型的商业公司有帮助。

　　目前，Mapbox 拥有 30 名职工，但它有信心与大型的科技公司竞争。Eric Gundersen 说，“我们能够做到这些，依靠的是开源代码和开源数据，我们会从他们那里夺走客户。”

　　图片来自 digitaltrends

　　转载自ifanr

或许你没有听说过TileMill,但是应该也有了解过Mapbox吧。Mapbox是国外很不错的一个地图制作及分享的一个网站，而TileMill则是他们使用开源软件而制作的一个地图制图及地图发布的软件。国外foursquare,slate等也都有使用他们提供的在线地图服务。而且提供的地图切片服务不光是在网页上，同样也支持在手机及IPad等不同环境下的运行。

TileMill

TileMill是基于 Mapnik, node.js,backbone.js, express and CodeMirror.这几个开源的软件构建起来的，看看开源的东西也还是非常强大的，只是我们很少去愿意使用他们，并不比商业的软件差多少。对其源码构建的可以去github上看看，地址：https://github.com/mapbox/tilemill。Mapnik提供地图的渲染,node.js及backbone.js等提供地图展示，地图配图使用Carto 的语言进行地图各个图层的配图样式等设计，和css很类似，但是比原先的mapnik的xml要方便和可读性要好很多。TileMill主要的功能有如下：

• 1、支持 ESRI Shapefile, KML, GeoJSON, GeoTIFF, PostGIS, and SQLite数据来源。
• 2、新版本支持大数据量栅格数据的加载与显示，支持山体阴影，分层设色等功能。
• 3、支持数据的查询，也就是属性数据的浏览。
• 4、支持以Carto css样式语言对地图进行配色设计（比xml要方便很多）
• 5、支持svg图标，truetype字体样式等，基于Mapnik提供（mapnik2.0出来了又强大了不少）
• 6、支持地图tooltip、图片、图表、utf-8 Grid(不是很了解这个技术)等自定义信息提示
• 7、支持直接发布到Mapbox，和朋友共享你制作的地图。

制图教程

地图的制图需要制图人员的主观视觉感受去制作，地图的教程在Mapbox网站上已提供，而且很详细，感兴趣想自己制作一幅属于自己的地图可以参照网站的步骤，下载TileMill自己制作。教程地址：http://mapbox.com/tilemill/docs/guides/add-shapefile/ 。相对于ArcGIS等企业级的制图软件来说，TileMill是一个非常不错的平民应用，通过它你可以制作出非常多不错的地图来，是制图人员一个不错的选择。希望能看到更多基于TileMill制作出来的更多美丽的地图。

本文固定链接: http://www.higis.org/2012/05/29/tilemill/ | Hi,GIS

感谢Mapbox，带来了一整套完整的地图方案。

你可以把你的地图放在Mapbox的网站上。也可以使用他们提供的开源软件自己架设地图服务。

Mapbox的地图方案包括web，ios和android。 不过android目前属于不成熟阶段。但是相信很快就会成熟起来。

一个比较舒服的地图自制流程如下：

Qgis 处理各种GIS数据，导出为shp或GeoJson等格式 ==> TileMill 生成 .mbtile ==> tilestream 在线地图服务 或 直接由Android/IOS SDK 渲染地图。

QGIS的使用推荐教程：http://www.qgistutorials.com/en/

TileMill教程：https://www.mapbox.com/tilemill/docs/crashcourse/introduction/

TileStream的资料稍微少些，这里重点讲下。

首先，假设你在TileMill教程中导出的地图文件为abc.mbtile

存放在/Users/fangjian/Documents/MapBox/export

假设你已经安装了nodejs ，然后安装tilestream. 

sudo npm install -g tilestream

装好以后启动服务

tilestream --tiles=/Users/fangjian/Documents/MapBox/export

更多设置参见: http://linuxdev.dk/articles/tilestream-openlayers-and-drupal-7

这个时候访问：http://localhost:8888

已经可以看到地图了。点地图图标进入到地图页面后，点“i"图标可以看到这个地图服务的网址。如：http://localhost:8888/v2/abc/{z}/{x}/{y}.png

下面把这个范例拿来用：https://www.mapbox.com/mapbox.js/example/v1.0.0/external-layers/

保存为mapbox.html

其中的网址部分改成：var stamenLayer = L.tileLayer('http://localhost:8888/v2/abc/{z}/{x}/{y}.png'

打开mapbox.html，就可以看到地图了。

如果使用mapbox.js

对应的tilejson为 http://localhost:8888/v2/abc.json

如果想解包为纯静态的图片，用mbutil https://github.com/mapbox/mbutil

 

sudo easy_install mbutil

mb-util abc.mbtiles abc

abc/metadata.json为tilejson文件

abc/z/x/y.png是瓦片文件

abc/z/x/y.grid.json是UTFGRID文件

进一步了解详见 http://blog.thematicmapping.org/2012/11/exploring-mapbox-stack-mbtiles-tilejson.html

近期，应公司要求，开始接触MapBox For Android的开发。

经过初步的接触，发现MapBox与我之前使用的Arcgis有很多不同，相比起来，MapBox更清洁，更轻便，也更容易使用，但是相对的，MapBox相对于Arcgis缺少了很多的功能实现，许多的东西都需要自己去进行处理才能实现。
下面是我一步步接触并使用MapBox的记录，可能会比较乱。我这里提供了目录的功能， 请不要使用csdn的极客模式，不然看不到目录的，另外，由于是一步步的写下来了，可能前期的看法或者结论，到了后期就不一样了，我会定期修改，但是可能会存在漏网的，欢迎指出。
首先是接入，相比于Arcgis又需要导入包文件，又需要导入lib，又需要设置jcenter，打包下来，直接就几十兆的Apk，一编译就是一分钟。
MapBox只需要导入一下代码即可

compile('com.mapbox.mapboxsdk:mapbox-android-sdk:5.0.2@aar') {
        transitive = true
    }

哦，对了，还有mavencentral，一般来说，应该都设置了的

allprojects {
    repositories {
        jcenter()
        mavenCentral()
    }
}

一般来说，下载一段时间后，就可以了，如果不可以，就试着，设置代理什么的，这里不细说了。

MapBox和Arcgis相同，在Xml中添加一个MapView就可以了

<com.mapbox.mapboxsdk.maps.MapView
        android:id="@+id/mapView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

如果是从网上，或者demo上学习的朋友，可能会遇到一个问题
就是在xml上无法设置初始坐标，zoom等参数，只能强行写出来，我估计是该控件item的问题。为了更好的学习，我将这些功能都放到了代码中来实现。

申请accessToken

就和arcgis的key类似，就是一个使用凭证，就不多说了，可以去官方网站申请。

进行初始化

申请完毕后，在Activity的onCreate()中添加如下代码，进行初始化

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //设置accessToken
        Mapbox.getInstance(this, getString(R.string.accessToken));
 setContentView(R.layout.activity_simple_map); }

敲黑板，这里的初始化代码一定要放到setContentView之前，否则无法使用。

初始化Mapview

mapView = (MapView) findViewById(R.id.mapView);
        mapView.setStyleUrl("mapbox://styles/mapbox/streets-v9");
        mapView.onCreate(savedInstanceState);

注意，其中的setStyleUrl，就是设置地图样式，可以采用默认样式，Light，Dark等，也可以使用网络地址，事实上默认的Style.LIGHT也是一个地址

还有下面的

mapView.onCreate(savedInstanceState);

需要在初始化的时候设置，同时，除了onCreate，还包括以下

// Add the mapView lifecycle to the activity's lifecycle methods
    @Override
    public void onResume() {
        super.onResume();
        mapView.onResume();
    }


    @Override
    protected void onStart() {
        super.onStart();
        mapView.onStart();
    }


    @Override
    protected void onStop() {
        super.onStop();
        mapView.onStop();
    }


    @Override
    public void onPause() {
        super.onPause();
        mapView.onPause();
    }


    @Override
    public void onLowMemory() {
        super.onLowMemory();
        mapView.onLowMemory();
    }


    @Override
    protected void onDestroy() {
        super.onDestroy();
        mapView.onDestroy();
    }


    @Override
    protected void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        mapView.onSaveInstanceState(outState);
    }

都要进行设置，建议封装到baseactvity中

异步加载地图

mapView.getMapAsync(new OnMapReadyCallback() {
            @Override
            public void onMapReady(MapboxMap mapboxMap) {

            }
        });

该方法即是对地图进行加载，加载成功后，会返回MapboxMap对象，只有有了这个对象，我们才可能对地图进行各种操作，和Arcgis不同，arcgis的大部分操作，都是在mapview上进行操作的，但是MapBox的mapview并没有太多的功能元素，像地图定点、polygon、marker等操作，都得对mapboxmap进行操作，我估计很多朋友都会和我一样，想进行初始化时中心点设置的时候，尝试了centerAt、location、setCenter、setPosition、moveTo、moveCamere。。等等一系列的姿势去设置，都失败了。

更多操作

从上一步开始，地图已经可以跑起来了，下面就是一些进一步的使用，一下排序不分先后，纯粹是我做到哪，写到哪，不过我提供了目录，需要的朋友可以直接在目录中进行搜索，如果是和我一样才开始学习的，可以跟着我的代码一直敲就可以了。

将地图移动到某一点

这个方法有很多

LatLng latLng = new LatLng(29.735281, 106.99155);
mapboxMap.moveCamera(CameraUpdateFactory.newLatLng(latLng));

最简单的地图定点，是的，没错，这就centerAt的功能

首先我来看前面的方法moveCamera;这个方法就是简单将地图中心定到某个位置，更多的还有

注意，这个LatLng不仅仅可以传入坐标，还可以传入location的

mapboxMap.animateCamera(CameraUpdateFactory.newLatLng(latLng),2000);//动画移动，花费两秒时间，动态的移动到该位置，时间可以不写
mapboxMap.easeCamera(CameraUpdateFactory.newLatLng(latLng),2000);//讲真，我也没发现和其他的有什么区别

然后是后面的参数

后面可以有四种形式

很显然，一个必填，三个可填。
主要呢是必填项CamerUpdate类型的参数，CameraUpdate呢，其实可以当做一个数据处理命令集来使用，即先将要move到的位置的各种参数设置完成，封装好后，再来进行处理。
CameraUpdate的构造需要用到CamaeraUpdateFactory（目前就我了解的话）
CamaeraUpdateFactory专门是用来构建CameraUpdate的，是他的工厂类，我们来看看他的new方法（zoomby，scrollby我没用过。。）
①.newLatLng 根据简单的坐标点来进行构造

这里只需要传入一个坐标参数即可，LatLng，用过Arcgis等地图的都知道，这就是一个坐标，可以用new LatLng（double latitude,double longitude）来进行构造，同下，我们统一用animateCamera来进行举例。

mapboxMap.animateCamera(CameraUpdateFactory.newLatLng(latLng),2000);

②.newCameraPosition 根据CameraPosition来进行构造

这里需要传入的是一个CameraPosition的对象，初始化

CameraPosition cameraPosition = new CameraPosition.Builder()
            .target(new LatLng(latLng.getLatitude(), latLng.getLongitude()))
                        .zoom(17)//放大尺度 从0开始，0即最大比例尺，最大未知，17左右即为街道层级
                        .bearing(180)//地图旋转，但并不是每次点击都旋转180度，而是相对于正方向180度，即如果已经为相对正方向180度了，就不会进行旋转
                        .tilt(30)//地图倾斜角度，同上，相对于初始状态（平面）成30度
                        .build();//创建CameraPosition对象

敲黑板了，注意其中的参数，这几个参数在很多地方都有用到。

mapboxMap.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition), 2000);

使用就很简单了，大同小异。

③.newLatLngBounds 根据一个坐标坐标边界进行移动，这个有两种方法，除了必传的LatLngBounds，都一样，不一样的就是padding，一种是统一padding，一种是四个方向，这个我就不细细说了，我只说统一padding

LatLngBounds latLngBounds = new LatLngBounds.Builder()//根据坐标集，初始化一个坐标界限
                        .include(latlng1)
                        .include(latlng2)
                        .include(latlng3)
                        .include(latlng4)
                        .build();

构造是很简单的，传入坐标点即可，除了include，每次只添加一个点，也可以采用includes，一次传入一个点的集合

mapboxMap.animateCamera(CameraUpdateFactory.newLatLng(latLngBounds,50), 2000);

其中的50指的是padding，使用这种构造，地图会将比例尺自动调节到刚好能显示全部点以及点外面的padding的程度。
④newLatLngZoom 这个和第一个很相似

无非是这个还可以传入一个zoom即缩放尺度的值

mapboxMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng,13),2000);

至此，移动的方法就全部用完了。

mapview在fragment中的使用

用过arcgis的可能都知道，mapview在fragment中的使用和在activity中使用其实是一样的，但是在mapbox中，还为fragment提供了另外一种构造方式，

SupportMapFragment。
@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_fragment_map);
        //设置accessToken
        Mapbox.getInstance(this, getString(R.string.accessToken));
 }

为了加深记忆，初始化这个再写一次，可能有人发现了，这里我们的getInstance的方法并没有放到setContentView里面，这是我故意的，因为如果mapview要在activity中使用，就必须放在setContentView之前，但是如果在fragment中使用就不需要了。

// Create fragment
        final FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();


        if (savedInstanceState == null) {
            // Build mapboxMap
            MapboxMapOptions options = new MapboxMapOptions();
            options.styleUrl(Style.LIGHT);
            options.camera(new CameraPosition.Builder()
                    .target(new LatLng(29.735281, 106.99155))
                    .zoom(13)
                    .build());

            // Create map fragment
            mapFragment = SupportMapFragment.newInstance(options);


            // Add map fragment to parent container
            transaction.add(R.id.container, mapFragment, "com.mapbox.map");
            transaction.commit();
        } else {
            mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentByTag("com.mapbox.map");
        }

        mapFragment.getMapAsync(new OnMapReadyCallback() {
            @Override
            public void onMapReady(MapboxMap mapboxMap) {

            }
        });

以上就是构建的方法，比较长，一句一句的看，首先我再看看xml文件

xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/whitesmoke">


    <TextView
        android:id="@+id/fragment_below_textview"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="8dp"
        android:gravity="center_horizontal"
        android:text="集成在fragment上的"/>


    <android.support.v7.widget.CardView
        android:id="@+id/cardview"
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:layout_below="@id/fragment_below_textview"
        android:layout_marginBottom="8dp"
        android:layout_marginEnd="8dp"
        android:layout_marginLeft="8dp"
        android:layout_marginRight="8dp"
        android:layout_marginStart="8dp"
        android:layout_marginTop="8dp"
        app:cardCornerRadius="2dp"
        app:cardElevation="@dimen/cardview_default_elevation">


        <FrameLayout
            android:id="@+id/container"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
    android.support.v7.widget.CardView>




RelativeLayout>

只需要看其中的container，这个是用来存放fragment的容器，首先创建一个FragmentTranstion对象

final FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();

再动态实例化地图对象

// Build mapboxMap
            MapboxMapOptions options = new MapboxMapOptions();
            options.styleUrl(Style.LIGHT);
            options.camera(new CameraPosition.Builder()
                    .target(new LatLng(29.735281, 106.99155))
                    .zoom(13)
                    .build());
            // Create map fragment
            SupportMapFragment mapFragment = SupportMapFragment.newInstance(options);

再次敲个黑板，这里的MapBoxOptions，是用于地图初始化时给地图初始化设置各种参数的。相当于配置文件，这里使用options初始化了SupportMapFragment

，options也可以在activity中进行使用，比如这样

MapboxMapOptions options = new MapboxMapOptions()
      .styleUrl(Style.OUTDOORS)
      .camera(new CameraPosition.Builder()
        .target(new LatLng(43.7383, 7.4094))
        .zoom(12)
        .build());

    // create map
    mapView = new MapView(this, options);
    mapView.onCreate(savedInstanceState);
    mapView.getMapAsync(new OnMapReadyCallback() {
      @Override
      public void onMapReady(MapboxMap mapboxMap) {
        // Customize map with markers, polylines, etc.

      }
    });

    setContentView(mapView);

其实设置options和在onMapReady中进行设置，或者定位是差不多的，只是一个是动态添加使用，一个是在xml中添加使用，这里就先不细说了。我们继续刚刚的

// Add map fragment to parent container
            transaction.add(R.id.container, mapFragment, "com.mapbox.map");
            transaction.commit();

这个就是将fragment添加到容器中去，这是android的代码，不是mapbox的代码，没什么好说的。
至此就实现了mapbox在fragment中的使用，如下图

其实设置options和在onMapReady中进行设置，或者定位是差不多的，只是一个是动态添加使用，一个是在xml中添加使用，这里就先不细说了。我们继续刚刚的

// Add map fragment to parent container
            transaction.add(R.id.container, mapFragment, "com.mapbox.map");
            transaction.commit();

这个就是将fragment添加到容器中去，这是android的代码，不是mapbox的代码，没什么好说的。

至此就实现了mapbox在fragment中的使用，如下图

地图风格，StyleUrl

这个就是mapview.setStyleUrl了，这个参数呢，可以通过mapview来进行设置，也可以通过mapboxmap来进行设置，上面大概的说了一点，这里详细的说一下。
这个就是地图的风格，其实不管是系统自带的风格，还是自己的写的其他的，都是一个url地址而已。
先看系统自带：

Style.MAPBOX_STREETS  默认的
Style.DARK 黑色主题的
Style.LIGHT 亮色主题
Style.OUTDOORS  户外的，具体有什么不同数不清楚我
Style.SATELLITE 影像图
Style.SATELLITE_STREETS 更为详细的影像图

他们都是一个地址，比如DARK，他的地址就是mapbox://styles/mapbox/dark-v9

你也可以尝试一下

"https://www.mapbox.com/android-sdk/files/mapbox-raster-v8.json"

等，更多的我也没有尝试过了，毕竟我一般来说都不会用官方提供的地址，而是使用天地图

地图标记，Marker

很好理解

首先是最基础的使用

mapboxMap.addMarker(new MarkerOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .title("MarkerTitle")
                        .snippet("Message detail"));

addMarker就是添加一个地图标记，需要传入一个MarkerOptions或者BaseMarkerOptions、BaseMarkerViewOptions这三种的其中一种如果传入BaseMarkerViewOptions，还可以传入一个OnMarkerViewAddedListener，这个之后再说先看最简单的MarkerOptions，这就是一个定点的坐标标记，positon是坐标点，title是点击图标出现的信息的标题，snippet是内容，如图

假如你尝试添加很多个，尝试移除全部重新添加等操作的时候，第一个坑就出现了那就是竟然没有mapboxMap.removeAllMarkers()，这样的方法，一般来说，用脚想这玩意儿也应该是存在的，然而他就是没有。想要移除，一般的方法如下

for (Marker marker : mapboxMap.getMarkers()) {
            mapboxMap.removeMarker(marker);
        }

这就特别坑了，另外你还可以用

mapboxMap.clear();

这个方法，但是这个主要是用来清空mapview上所有添加上去的东西的，或者就是

mapboxMap.removeAnnotations();

这个是用来移除所有注释，不限于标记，但是至少不会移除layer。所以我建议最好还是封装出来removeAllMarker()这样的方法吧。

然后来试一试使用自己的图标

"white-space:pre;">     IconFactory iconFactory = IconFactory.getInstance(this);
                Icon icon = iconFactory.fromResource(R.mipmap.purple_marker);
                MarkerOptions markerOptions = new MarkerOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .title("MarkerTitle")
                        .snippet("MarkerInfo")
                        .icon(icon);
                mapboxMap.addMarker(markerOptions);

如上，想要使用自己的icon，需要先初始化一个icon工厂类，该类可以从bitmap、resource、path、file、asset这几个来源来生成icon

但是，这里又有一个坑，就是大小不是定死的，也就是说，假如你给的图片特别大，他在地图上显示就会特别大，你可以尝试将图片放到不同分辨率的mipmap文件夹中，如果你使用的drawable中来使用，就切换drawable，这是在使用资源文件的情况下，如果你使用的其他类型，一定要提前设置好长和宽。

添加多个Marker

添加多个其实可以采用重复addMarker来实现，这里讲另外一种

MarkerOptions marker1 = new MarkerOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .title("MarkerTitle")
                        .snippet("Message detail");
                MarkerOptions marker2 = new MarkerOptions()
                        .position(new LatLng(29.612261, 106.154911))
                        .title("MarkerTitle")
                        .snippet("Message detail");
                MarkerOptions marker3 = new MarkerOptions()
                        .position(new LatLng(29.519861, 106.547211))
                        .title("MarkerTitle")
                        .snippet("Message detail");
                MarkerOptions marker4 = new MarkerOptions()
                        .position(new LatLng(29.657261, 106.152711))
                        .title("MarkerTitle")
                        .snippet("Message detail");
                List markerList = new ArrayList<>();
                markerList.add(marker1);
                markerList.add(marker2);
                markerList.add(marker3);
                markerList.add(marker4);
                mapboxMap.addMarkers(markerList);

如上，采用addMarkers来进行添加，很简单，不多说。

带动画的Marker

这个其实并不是mapbox提供的方法，是我在官方demo上发现的，貌似得在android 25.0.0版本以上才能使用，我觉得很不错，特意分享一下

final Marker marker = mapboxMap.addMarker(new MarkerViewOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .title("移动")
                        .snippet("也不动"));
                mapboxMap.setOnMapClickListener(new MapboxMap.OnMapClickListener() {
                    @Override
                    public void onMapClick(@NonNull LatLng latLng) {
                        ValueAnimator maValueAnimator = ObjectAnimator.ofObject(marker, "position",
                                new LatLngEvaluator(), marker.getPosition(), latLng);
                        maValueAnimator.setDuration(2000);
                        maValueAnimator.start();
                    }
                });

需要一个内部类

private static class LatLngEvaluator implements TypeEvaluator {
        // Method is used to interpolate the marker animation.

        private LatLng latLng = new LatLng();

        @Override
        public LatLng evaluate(float fraction, LatLng startValue, LatLng endValue) {
            latLng.setLatitude(startValue.getLatitude()
                    + ((endValue.getLatitude() - startValue.getLatitude()) * fraction));
            latLng.setLongitude(startValue.getLongitude()
                    + ((endValue.getLongitude() - startValue.getLongitude()) * fraction));
            return latLng;
        }
    }

实现原理，我没有深度研究，各位可以看看。

marker的详细设置

IconFactory iconFactory1 = IconFactory.getInstance(this);
                Icon icon1 = iconFactory1.fromResource(R.mipmap.purple_marker);
                // marker view using all the different options available
                mapboxMap.addMarker(new MarkerViewOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .icon(icon1)
                        .rotation(70)//倾斜角度
                        .anchor(1f, 1f)
                        .alpha(0.5f)//透明度
                        .title("Hisense Arena")
                        .snippet("Olympic Blvd, Melbourne VIC 3001")
                        .infoWindowAnchor(0.5f, 0.5f)//infowindow的
                        .flat(false));//是否是平的

这里使用的就不是简单的MarkerOption了,这里使用的是MarkerViewOptions

他可以设置rotation即倾斜调度
anchor，这个东西我一直没搞清楚是什么效果，各种设置都没变化

alpha，透明度，不解释

flat，这个，代表了地图倾斜角变化后，标记是否也跟着变扁平，默认是false
infoWindowAnchor，这个也比较好理解，就是infowindow弹出与图标的相对位置

可以看到图标是倾斜的，另外，两个标记，上面那个的flat设置为false，下面的设置为了true

自定义的infowindow

marker点击出现的infowindow的自定义界面，如下

mapboxMap.addMarker(new MarkerOptions()
                        .position(new LatLng(29.619861, 106.515911))
                        .title("infowindow1"));
                mapboxMap.addMarker(new MarkerOptions()
                        .position(new LatLng(29.519861, 106.615911))
                        .title("infowindow2"));
                mapboxMap.addMarker(new MarkerOptions()
                        .position(new LatLng(29.719861, 106.415911))
                        .title("infowindow3"));
                mapboxMap.setInfoWindowAdapter(new MapboxMap.InfoWindowAdapter() {
                    @Nullable
                    @Override
                    public View getInfoWindow(@NonNull final Marker marker) {
                        LinearLayout parent = new LinearLayout(MarkerActivity.this);
                        parent.setLayoutParams(new LinearLayout.LayoutParams(ZXSystemUtil.dp2px(MarkerActivity.this, 200), ZXSystemUtil.dp2px(MarkerActivity.this, 80)));
                        parent.setOrientation(LinearLayout.HORIZONTAL);
                        parent.setBackgroundColor(ContextCompat.getColor(MarkerActivity.this, R.color.whitesmoke));
                        ImageView imageView = new ImageView(MarkerActivity.this);
                        TextView textView = new TextView(MarkerActivity.this);
                        switch (marker.getTitle()) {
                            case "infowindow1":
                                imageView.setImageDrawable(ContextCompat.getDrawable(MarkerActivity.this, R.mipmap.__picker_checkbox_marked));
                                break;
                            case "infowindow2":
                                imageView.setImageDrawable(ContextCompat.getDrawable(MarkerActivity.this, R.mipmap.__picker_ic_camera_p));
                                break;
                            case "infowindow3":
                                imageView.setImageDrawable(ContextCompat.getDrawable(MarkerActivity.this, R.mipmap.__picker_ic_broken_image_black_48dp));
                                break;
                            default:
                                break;
                        }
                        textView.setText(marker.getTitle());
                        textView.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View view) {
                                ZXToastUtil.showToast(MarkerActivity.this, marker.getTitle()+"123");
                            }
                        });
                        parent.addView(imageView);
                        parent.addView(textView);
                        return parent;
                    }
                });

可以看到，我添加了三个marker，并使用了setInfoWindowAdapter这个方法，这个方法就是用于给infowindow设置适配器的，我这里是动态生成的界面，也可以使用View.inflater来添加xml界面生成view，就可以实现在infowindow上进行各种操作。同时可以实现点击事件等，marker是MarkerOption，MarkerViewOption等的父类，可以根据这个marker传过来的title来进行判断是哪一个marker，来区分不同marker实现不同的界面。

但是需要注意的是，这里的parent是无法设置点击事件的，也就是说infowindow内部的view的各种事件可以在这里实现，但是infowindow本身不能在这里设置点击事件，如果需要设置，需要使用另外一个方法，

mapboxMap.setOnInfoWindowClickListener(new MapboxMap.OnInfoWindowClickListener() {
                    @Override
                    public boolean onInfoWindowClick(@NonNull Marker marker) {
                        ZXToastUtil.showToast(MarkerActivity.this, marker.getTitle());
                        return true;
                    }
                });

注：里面的ZXToastUtil是我自己封装的一个Toast方法，你们使用Toast.makeToast就可以了。

同样的，还可以实现setOnInfoWindowLongClickListener和setOnInfoWindowCloseListener两个监听

地图定位

地图定位，不多说了，都懂，直接看代码

1.基础使用

//获取定位引擎并激活
        LocationSource locationEngine = LocationSource.getLocationEngine(this);
        locationEngine.activate();

ps：地图基础设置那些，我就不写了，和前面一样。

我这里添加了一个FloatingActionButton，为了测试定位的开启和关闭，你们可以使用按钮什么的  都可以

fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                if (mapboxMap != null) {
                    toggleGps();
                }
            }
        });

只需要看里面的toggleGps();这个方法。

//开关定位
    private void toggleGps() {
        if (mapboxMap.isMyLocationEnabled()) {//已开启
            enableLocation(false);//若已开启，就将它关闭
        } else {//未开启
            if (ZXPermissionUtil.checkLocationPermissions(this)) {
                enableLocation(true);//若未开启，就在检查完权限后，将它打开
            } else {
                ZXPermissionUtil.requestLocationPermissions(this);
            }
        }
    }

这个方法呢其实就是打开或者关闭定位

里面有个判断语句

mapboxMap.isMyLocationEnabled()

很好理解，就字面意思，判断定位是否开启。

如果开启，就关闭定位，如果未开启，就先检查权限，如果有权限就打开定位，如果没有权限就开启权限，里面的ZXPermissionUtil是我封装的权限工具，这里就不说的，你们使用checkPermission就可以了，后面有空再将我整合的工具类、view类、manager等拿出来分享。

好，然后是里面的

enableLocation(true)

如下

//设置定位
    private void enableLocation(boolean enable) {
        if (enable) {
            //获取上次定位参数,如果存在先直接使用
            final Location lastlocation = locationEngine.getLastLocation();
            if (lastlocation != null) {
                mapboxMap.animateCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(lastlocation), 15), 1000);
            }
            locationEngineListener = new LocationEngineListener() {
                @Override
                public void onConnected() {
                    //连接到定位服务，不需要操作
                }

                @Override
                public void onLocationChanged(Location location) {
                    if (location != null) {
                        mapboxMap.animateCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(location), 15), 1000);
                        locationEngine.removeLocationEngineListener(this);
                    }
                }
            };
            //设置监听器
            locationEngine.addLocationEngineListener(locationEngineListener);
            fab.setImageResource(R.drawable.ic_location_disabled_24dp);
        } else {
            fab.setImageResource(R.drawable.ic_my_location_24dp);
        }
        //添加或移除定位图层
        mapboxMap.setMyLocationEnabled(enable);
    }

这个就比较长了，慢慢看

//获取上次定位参数,如果存在先直接使用
            final Location lastlocation = locationEngine.getLastLocation();
            if (lastlocation != null) {
                mapboxMap.animateCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(lastlocation), 15), 1000);
            }

这个呢就是获取上次定位时保存好的坐标位置，先给地图一个定位坐标，让地图先定过去再说。这个的用意，用过其他地图的应该都知道。

locationEngineListener = new LocationEngineListener() {
                @Override
                public void onConnected() {
                    //连接到定位服务，不需要操作
                }

                @Override
                public void onLocationChanged(Location location) {
                    if (location != null) {
                        mapboxMap.animateCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(location), 15), 1000);
                        locationEngine.removeLocationEngineListener(this);
                    }
                }
            };
            //设置监听器
            locationEngine.addLocationEngineListener(locationEngineListener);

然后就初始化一个监听器，并设置给定位引擎，我们可以看到，在得到定位的时候，就将地图定了过去。

//添加或移除定位图层
        mapboxMap.setMyLocationEnabled(enable);

这个就简单啦，就是是否要显示定位的那个标记的

fab.setImageResource(R.drawable.ic_location_disabled_24dp);
fab.setImageResource(R.drawable.ic_my_location_24dp);

里面这两句是设置按钮的背景的，不细说。

另外，还要注意几个生命周期的重写

@Override
    protected void onStart() {
        super.onStart();
        mapView.onStart();
        if (locationEngine != null && locationEngineListener != null) {
            locationEngine.activate();
            locationEngine.requestLocationUpdates();
            locationEngine.addLocationEngineListener(locationEngineListener);
        }
    }

    @Override
    protected void onStop() {
        super.onStop();
        mapView.onStop();
        if (locationEngine != null && locationEngineListener != null) {
            locationEngine.removeLocationEngineListener(locationEngineListener);
            locationEngine.removeLocationUpdates();
            locationEngine.deactivate();
        }
    }
@Override
    protected void onDestroy() {
        super.onDestroy();
        mapView.onDestroy();
        // Ensure no memory leak occurs if we register the location listener but the call hasn't
        // been made yet.
        if (locationEngineListener != null) {
            locationEngine.removeLocationEngineListener(locationEngineListener);
        }
    }

大意就是在应用重新进入的时候激活定位，设置定位监听

在停止的时候移除监听并取消激活

其实吧，这些吧，写不写都行，不过为了系统性能，可以写上。

设置定位图标的属性

设置定位图标的属性需要获取到一个MyLocationViewSetting的值

MyLocationViewSettings locationSettings = mapboxMap.getMyLocationViewSettings();
                locationSettings.setBackgroundDrawable(ContextCompat.getDrawable(LocationActivity.this, R.drawable.ic_my_location_24dp), new int[]{20, 20, 20, 20});
                locationSettings.setForegroundTintColor(ContextCompat.getColor(this, R.color.seagreen));
                locationSettings.setAccuracyTintColor(ContextCompat.getColor(this,R.color.brown));
                locationSettings.setAccuracyAlpha(50);
                locationSettings.setTilt(30);

如上，获取到后，可以设置定位图标的各种属性，第一个是图片不再多说

setForegroundTintColor，这个是用于设置定位图标中心圆的颜色

setAccuracyTintColor，这个是用于设置定位图标范围框的颜色

setAccuracyAlpha，设置范围框的透明度

setTilt，设置倾斜角，上面用过这个参数

注意，设置drawable同时还设置了padding

地图跟随

地图跟随，就是tracking，如下

TrackingSettings trackingSettings = mapboxMap.getTrackingSettings();
                // 让地图始终以定位点为中心，无法滑动
                trackingSettings.setDismissAllTrackingOnGesture(false);
                // 启用位置和方位跟踪
                trackingSettings.setMyLocationTrackingMode(MyLocationTracking.TRACKING_FOLLOW);
                trackingSettings.setMyBearingTrackingMode(MyBearingTracking.COMPASS);

获取到一个trackingSetting对象，这个对象可用于设置地图跟随的相关属性

首先是setDissmissAllTrackingOnGesture(false),就像我注释说的，是将地图的中心点就固定了，无法移动，只能放大缩小

然后是setMyLocationTrackingMode，这个是设置地图位置模式，TRACKING_FOLLOW就是跟随的意思，就是说如果自身位置移动了，地图中心点也会跟着变化的意思

最后是setMyBearingTrackingMode，这个是设置方位的跟踪模式，有COMPASS，GPS等，值得注意的是，不知道是不是我在室内的原因，这方向箭头只能指向两端两个方位，转动手机到某个位置就直接旋转180度，而不是随着手机转动而慢慢转动角度，我感觉是室内，因为我这gps一向不咋地，毕竟总觉得要是这就是mapbox自带的，也太坑爹了。

可参考该博客：http://blog.csdn.net/stanny_bing/article/details/70230703