ArcGIS for Android Runtime100 基本操作（四）——GPS定位

      对于定位大家应该都不陌生，在Android设备里，主要存在GPS定位、网络基站定位、AGPS定位等。在这里我们不对各位定位方式做深入阐述，默认以AGPS来说明下如何在Runtime100实现定位。

      其实ArcGIS Runtime系列一直自带有定位的接口，但据说是不好用，所以以往大家往往用的是Android原生自带的定位方法来实现定位。不过对于Runtime100，我进行了一些测试，发现新的接口也挺好用，所以打算将Android原生的定位和Runtime100里的方法分别进行下说明。

Android原生定位方法——LocationManager

      在Android原生里，定位都是通过LocationManager来实现的。最基本的用法如下所示：

LocationManager locationManager=(LocationManager)this.getSystemService(Context.LOCATION_SERVICE);
final List providers=locationManager.getProviders(true);
for(String provider:providers){
    Location location=locationManager.getLastKnownLocation(provider);
    if(location!=null) {
        Log.i(provider+"==", String.valueOf(location.getLongitude()) + "," + String.valueOf(location.getLatitude()));
    }else{
        Log.i(provider+"==",null);
    }
}

      先实例化一个LocationManager，然后通过LocationManager.getLastKnownLocation（）方法就可以获取当前位置信息，运行结果如下：

      可以看出在LocationManager里一共有四种方式提供位置信息，分为是:

passive	被动方式，通过获取其他设备或者本设备之前获取的数据提供位置信息
gps	通过GPS芯片获取到位置信息
network	通过wifi或者基站信息获取位置信息
local_database	通过本地数据库里获取位置信息

      上述方法是主动请求获取位置信息，如果要开通一个自动监听，则需要采用LocationListener，其方法依然是先实例化一个LocationManger，然后请求监听，代码如下：

LocationManager locationManager=(LocationManager)this.getSystemService(Context.LOCATION_SERVICE);
locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, new LocationListener() {
    @Override
    public void onLocationChanged(Location location) {
        //位置信息变化时触发
        if(location!=null) {
            Log.i("GPS==", String.valueOf(location.getLongitude()) + "," + String.valueOf(location.getLatitude()));
        }else{
            Log.i("GPS==","空的");
        }
    }

    @Override
    public void onStatusChanged(String provider, int status, Bundle extras) {
        //GPS状态变化时触发
    }

    @Override
    public void onProviderEnabled(String provider) {
        //GPS开启时触发
    }

    @Override
    public void onProviderDisabled(String provider) {
        //GPS禁用时触发
    }
});

      对于LocationListener，里面一共含有四个参数，分别是：

• 参数1，设备：有GPS_PROVIDER和NETWORK_PROVIDER两种，前者是GPS,后者是GPRS以及WIFI定位 
• 参数2，位置信息更新周期.单位是毫秒 
• 参数3，位置变化最小距离：当位置距离变化超过此值时，将更新位置信息 
• 参数4，监听 
• 备注：参数2和3，如果参数3不为0，则以参数3为准；参数3为0，则通过时间来定时更新；两者为0，则随时刷新 

ArcGIS Runtime 100定位方法——LocationDisplay

      在ArcGIS Runtime 100里新增了一个类LocationDisplay，其官方解释为：管理当前位置在显示地图里的展示，包括当前位置的信息，符号，以及随地图的平移、旋转、缩放等进行自动变化。

      也就是有了这个类，不仅可以获取当前位置信息进行定位，也可以将位置信息展示出来。

      不多说，直接上代码。首先是LocationDisplay的构造方法，LocationDisplay基于现实地图进行展示，所以是通过MapView获取的：

mMapView = (MapView) findViewById(R.id. mapview ) ;

String theURLString =

"http://map.geoq.cn/arcgis/rest/services/ChinaOnlineCommunity/MapServer" ;

ArcGISTiledLayer mainArcGISTiledLayer = new ArcGISTiledLayer(theURLString) ;

Basemap mainBasemap = new Basemap(mainArcGISTiledLayer) ;

arcGISMap .setBasemap(mainBasemap) ;

mMapView .setMap( arcGISMap ) ;

locationDisplay = mMapView .getLocationDisplay() ;

locationDisplay .setAutoPanMode(LocationDisplay.AutoPanMode. RECENTER ) ;

locationDisplay .startAsync() ;

 

     然后是获取当前位置信息了。对于位置信息，LocationDisplay里有两种方法，分别如下：

Point point= locationDisplay .getMapLocation() ;

Log. i ( "sss=" , point.toString()) ;

LocationDataSource.Location location= locationDisplay .getLocation() ;

Point point2=location.getPosition() ;

Log. i ( "sss=" , point2.toString()) ;

      我们运行下看看呢，结果如下：

                       

      由此我们可以看出，getMapLocation获取的点是基于当前地图坐标系的点，而getPosition是获取基于GPS的位置信息，再获取的点是基于WGS84的经纬度坐标。

      如果要在LocationDisplay里进行位置信息的自动监听，方法也很简单，只需要LocationDisplay.addLocationChangedListener即可，代码如下：

locationDisplay .addLocationChangedListener( new LocationDisplay.LocationChangedListener() {

@Override

public void onLocationChanged (LocationDisplay.LocationChangedEvent locationChangedEvent) {

LocationDataSource.Location location=locationChangedEvent.getLocation() ;

Point point=location.getPosition() ;

Log. i ( "sss=" , point.toString()) ;

}

}) ;

      如此便可进行位置信息的自动监听了。

      不过如果和原生的方法一样，那也就失去了意义。所以在定位功能上ArcGIS Runtime 100一共有了以下几个特点：

1.位置监听的自动扫描模式

      位置监听的自动扫描模式可能有点拗口，算是对于这个功能的直译吧。这个功能的意思是当你的位置信息变化时候，如何在地图上展示出来。使用方法为：LocationDisplay.setAutoPanMode(LocationDisplay.AutoMode)。

      模式一共有四种，其官方API如下所示：

      简要翻译下就是：

     COMPASS_NAVIGATION 和NAVIGATION 分别最适用于步行导航和车载导航，用户的位置符号会固定显示在屏幕的某个点上，并且指向设备的顶部（也就是地图会随着用户移动而平移，随用户转弯而旋转）；

     OFF 模式，用户位置符号会随位置变化而移动，但地图不会动；      

      RECENTER模式，当用户位置处于当前地图范围内时候，用户位置符号会随位置变化而移动，但地图不会动；当用户位置处于地图边缘时候，地图会自动平移是用户的当前位置重新居于显示地图中心。

2.LocationDisplay类里可以直接设置位置符号样式      

      当我们执行LocationDisplay.startAsync()方法时候，会在地图上显示出我们当前位置，默认的符号如下所示：

      如果我们想要改变这个符号样式，只需要重新设置符号即可，代码如下所示:

locationDisplay = mMapView.getLocationDisplay();
Resources resources=getResources();
BitmapDrawable bitmapDrawable= new BitmapDrawable(BitmapFactory.decodeResource(resources,R.drawable.location));
final PictureMarkerSymbol campsiteSymbol = new PictureMarkerSymbol(bitmapDrawable);
campsiteSymbol.loadAsync();
campsiteSymbol.addDoneLoadingListener(new Runnable() {
    @Override
    public void run() {
        locationDisplay.setDefaultSymbol(campsiteSymbol);//设置默认符号
        locationDisplay.setShowAccuracy(false);//隐藏符号的缓存区域
    }
});

      符号样式变化如下：

      对于位置符号的设置有以下几种：

locationDisplay .setAcquiringSymbol(campsiteSymbol) ; //设置当前位置的填充符号

locationDisplay .setAccuracySymbol(campsiteSymbol) ; //设置最后一个已知位置的标记符号

locationDisplay .setPingAnimationSymbol(campsiteSymbol) ; //设置当前位置更新时候的动画

locationDisplay .setCourseSymbol(campsiteSymbol) ; //设置当前位置的路线符号

locationDisplay .setHeadingSymbol(campsiteSymbol) ; //设置当前位置设备面对方向的符号

locationDisplay .setDefaultSymbol(campsiteSymbol) ; //设置默认符号

3.位置符号隐藏

      在ArcGIS Runtime 100里假如我们只是想获取位置信息，而不需要显示出来，我们只需要将位置监听的模式设置为OFF，然后执行以下代码即可。

locationDisplay .setShowLocation( false ) ; //隐藏符号

locationDisplay .setShowAccuracy( false ) ; //隐藏符号的缓存区域

locationDisplay .setShowPingAnimation( false ) ; //隐藏位置更新的符号动画