1. 程式人生 > >Android仿美團地址選擇

Android仿美團地址選擇

最近做了這個功能,分享一下,用的是百度地圖api,和美團外賣的地址選擇介面差不多,也就是可以搜尋或者滑動地圖展示地址列表給使用者選擇,看下效果圖先。

 

          

 

文章重點

1、展示地圖並定位到“我”的位置
2、滑動地圖獲取周邊poi(逆地理編碼)
3、搜尋框輸入查詢poi(POI檢索)


 

前言

這裡先提一下,我們要選擇的地址資訊其實是POI(Point of Interest),即“興趣點”。在地理資訊系統中,一個POI可以是一棟房子、一個景點、一個郵筒或者一個公交站等。
百度地圖SDK提供三種類型的POI檢索:城市內檢索、周邊檢索和區域檢索(即矩形區域檢索)。這裡我就不詳細介紹了,具體請檢視百度地圖開發文件(http://lbsyun.baidu.com/index.php?title=androidsdk)。

 

需求分析

我們要實現的功能主要包括兩個操作:滑動地圖和搜尋框搜尋。

  • 滑動地圖:滑動地圖主要是獲取滑動後地圖中心點座標,然後獲取poi資訊,但是這裡不能用上面提到的三種POI檢索方式,POI檢索都需要傳入關鍵字(不能為空),而我們僅僅只是滑動地圖,所以需要用另外一種方式:逆地理編碼檢索。使用逆地理編碼檢索時,可以通過檢索結果ReverseGeoCodeResult類的getPoiList()方法獲取傳入位置周圍的POI資訊。
  • 搜尋框搜尋:這裡就可以使用百度地圖SDK提供的三種POI檢索方式來進行檢索,同時為了方便檢視,還可以計算出每個POI和使用者之間的距離。

 

具體實現

一、展示地圖並定位到“我”的位置

1.展示地圖

展示地圖非常簡單,首先需要呼叫SDKInitializer.initialize()方法來進行初始化操作,它接收一個全域性的Context引數,記得初始化操作一定要在setContentView()方法前呼叫(可以到application中進行初始化),然後呼叫findViewById()方法獲取MapView例項,最後記得要對MapView進行資源釋放。

2.移動到我的位置

 2.1 獲取我的位置
 首先要確定自己的位置,程式碼如下所示:

public class MainActivity extends AppCompatActivity implements OnGetPoiSearchResultListener {
    private MyLocationListener myListener = new MyLocationListener();
    public LocationClient mLocationClient = null;
    private LocationClientOption option = null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initLocation();
    }

    /**
     * 初始化定位相關
     */
    private void initLocation() {
        // 宣告LocationClient類
        mLocationClient = new LocationClient(getApplicationContext());
        mLocationClient.setLocOption(option);
        // 註冊監聽函式
        mLocationClient.registerLocationListener(myListener);
        mLocationClient.start();
    }

    /**
     * 監聽當前位置
     */
    public class MyLocationListener extends BDAbstractLocationListener {
        @Override
        public void onReceiveLocation(BDLocation location) {
            //mapView 銷燬後不在處理新接收的位置
            if (location == null || mMapView == null) {
                return;
            }
            if (location.getLocType() == BDLocation.TypeGpsLocation
                    || location.getLocType() == BDLocation.TypeNetWorkLocation) {
                Log.e(TAG, "當前“我”的位置:" + location.getAddrStr());
                navigateTo(location);
            }
        }
    }
}

 

可以看到,我們首先建立LocationClient例項,然後呼叫LocationClient的registerLocationListener()方法來註冊一個定位監聽器,當獲取到位置資訊的時候,就會回撥這個定位監聽器。開啟定位很簡單,只需要呼叫一下LocationClient的start()方法就可以了。
定位的結果會回撥到監聽器中,也就是MyLocationListener,在onReceiveLocation()方法中即可通過BDLocation物件獲取相關位置詳細資訊。

注:定位屬於危險許可權,所以要動態許可權申請,記得不要忘記了。

 

2.2 移動到我的位置
獲取到定位後就需要將地圖中心點移動到當前位置,程式碼如下:

    private boolean isFirstLocation = true;
    /**
     * 根據獲取到的位置在地圖上移動“我”的位置
     *
     * @param location
     */
    private void navigateTo(BDLocation location) {
        double longitude = location.getLongitude();
        double latitude = location.getLatitude();
        if (isFirstLocation) {
            currentLatLng = new LatLng(latitude, longitude);
            MapStatus.Builder builder = new MapStatus.Builder();
            MapStatus mapStatus = builder.target(currentLatLng).zoom(17.0f).build();
            mBaiduMap.animateMapStatus(MapStatusUpdateFactory
                    .newMapStatus(mapStatus));
            isFirstLocation = false;
        }
       //讓“我”顯示在地圖上
        MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
        locationBuilder.latitude(location.getLatitude());
        locationBuilder.longitude(location.getLongitude());
        MyLocationData locationData = locationBuilder.build();
        mBaiduMap.setMyLocationData(locationData);
    }

這裡首先將位置資訊封裝到LatLng物件中,然後呼叫MapStatusUpdateFactory
的newMapStatus()將LatLng物件傳入,接著返回的MapStatusUpdate物件作為引數傳入到BaiduMap的animateMapStatus()方法中。上述程式碼中還使用了一個變數來防止多次呼叫animateMapStatus()方法,因為移動地圖只需要在程式第一次定位時呼叫一次。
同時為了顯示一個當前裝置的游標,可以利用MyLocationData.Builder類來實現,如程式碼所示,就可將“我”顯示在地圖上了。

二、滑動地圖獲取poi(逆地理編碼)

1. 逆地理編碼

前面已經提到了,我們這裡滑動地圖需要用到逆地理編碼,也就是反向地理解析,逆地理編碼就是將座標轉換為詳細的地址資訊,程式碼如下:

    //反向地理解析(含有poi列表)
    mGeoCoder.reverseGeoCode(new ReverseGeoCodeOption().location(center));

    /**
     * 反向地理解析,結果中含有poi資訊,用於剛進入地圖和移動地圖時使用
     */
    private void initGeoCoder() {
        mGeoCoder = GeoCoder.newInstance();
        mGeoCoder.setOnGetGeoCodeResultListener(new OnGetGeoCoderResultListener() {
            @Override
            public void onGetGeoCodeResult(GeoCodeResult geoCodeResult) {

            }

            @Override
            public void onGetReverseGeoCodeResult(ReverseGeoCodeResult reverseGeoCodeResult) {
                if (reverseGeoCodeResult.error.equals(SearchResult.ERRORNO.NO_ERROR)) {
                    //獲取poi列表
                    if (reverseGeoCodeResult.getPoiList() != null) {
                        poiInfoListForGeoCoder = reverseGeoCodeResult.getPoiList();
                    }
                } else {
                    Toast.makeText(mContext, "該位置範圍內無資訊", Toast.LENGTH_SHORT);
                }
            }
        });
    }

這裡我們首先獲取一個GeoCoder例項,然後註冊監聽器,當有解析結果時便會回撥到onGetReverseGeoCodeResult()方法中,而解析結果便有我們需要的poi列表。反向解析只需要呼叫GeoCoder的reverseGeoCode()方法並傳入移動後地圖的中心座標點即可。

 

2. 監聽地圖滑動

百度地圖提供了一個地圖狀態改變的監聽器,當雙擊、滑動、縮放等操作時便進行回撥,如下:

        mBaiduMap.setOnMapStatusChangeListener(new BaiduMap.OnMapStatusChangeListener() {

            /**
             * 手勢操作地圖,設定地圖狀態等操作導致地圖狀態開始改變。
             * @param mapStatus 地圖狀態改變開始時的地圖狀態
             */
            @Override
            public void onMapStatusChangeStart(MapStatus mapStatus) {
            }

            /** 因某種操作導致地圖狀態開始改變。
             * @param mapStatus 地圖狀態改變開始時的地圖狀態
             * @param i 取值有:
             * 1:使用者手勢觸發導致的地圖狀態改變,比如雙擊、拖拽、滑動底圖
             * 2:SDK導致的地圖狀態改變, 比如點選縮放控制元件、指南針圖示
             * 3:開發者呼叫,導致的地圖狀態改變
             */
            @Override
            public void onMapStatusChangeStart(MapStatus mapStatus, int i) {
                Log.e(TAG, "地圖狀態改變開始時:" + i + "");
            }

            /**
             * 地圖狀態變化中
             * @param mapStatus 當前地圖狀態
             */
            @Override
            public void onMapStatusChange(MapStatus mapStatus) {
                LatLng latlng = mBaiduMap.getMapStatus().target;
                addMarker(latlng);
            }

            /**
             * 地圖狀態改變結束
             * @param mapStatus 地圖狀態改變結束後的地圖狀態
             */
            @Override
            public void onMapStatusChangeFinish(MapStatus mapStatus) {
                center = mBaiduMap.getMapStatus().target;
                //反向地理解析(含有poi列表)
                mGeoCoder.reverseGeoCode(new ReverseGeoCodeOption()
                        .location(center));
            }
        });

如上,當地圖從滑動到結束會回撥4個方法,我們需要用到的是:地圖狀態變化中和地圖狀態改變結束,也就是對應地圖滑動中和滑動結束時。
滑動結束:當滑動結束時便呼叫反向地理解析出結果,這個上面已經說了。
滑動中:我們會發現當我們滑動地圖時,地圖上會有一個圖示始終處於地圖中心,這裡就是利用地圖狀態變化中這個回撥來新增一個marker,也就是在地圖上新增一個圖示,不過這個方法一次滑動可能會回撥很多次,但是如果只在滑動結束後新增,使用者體驗不好,所以如果實在要考慮效能的話可以換個思路,將圖示固定在螢幕上大致地圖的中心,這樣滑動地圖看起來也一樣的。
新增marker的方法就不詳解了,原始碼裡有,一看就懂了。

三、搜尋框輸入查詢poi(POI檢索)

搜尋框搜尋也就是使用關鍵字檢索POI資訊,這裡不要和Sug檢索弄混了,Sug(Suggestion POI search)檢索是根據部分關鍵字檢索出可能的完整關鍵字名稱,即關鍵字匹配。而POI檢索是根據關鍵字檢索符合的POI具體資訊。
上面說過POI檢索有三種方式,這裡結合我們的需求來說,使用城市內檢索更加合適,也就是傳入城市和關鍵字進行查詢,當然你也可以使用另外兩種檢索方式,步驟如下:

1. 建立POI檢索例項

mPoiSearch = PoiSearch.newInstance();

 

2. 建立POI檢索監聽器

OnGetPoiSearchResultListener listener = new OnGetPoiSearchResultListener() {
    /**
     * 獲取POI搜尋結果
     * @param poiResult Poi檢索結果,包括城市檢索,周邊檢索,區域檢索
     */
    @Override
    public void onGetPoiResult(PoiResult poiResult) {
        if (poiResult.error == SearchResult.ERRORNO.NO_ERROR) {
            poiInfoListForSearch = poiResult.getAllPoi();//POI集合
        }

        if (poiResult.error == SearchResult.ERRORNO.AMBIGUOUS_KEYWORD) {
            // 當輸入關鍵字在本市沒有找到,但在其他城市找到時,返回包含該關鍵字資訊的城市列表
            String strInfo = "在";
            for (CityInfo cityInfo : poiResult.getSuggestCityList()) {
                strInfo += cityInfo.city;
                strInfo += ",";
            }
            strInfo += "找到結果";
            Toast.makeText(mContext, strInfo, Toast.LENGTH_LONG).show();
        }
    }
    @Override
    public void onGetPoiDetailResult(PoiDetailSearchResult poiDetailSearchResult) {

    }
    @Override
    public void onGetPoiIndoorResult(PoiIndoorResult poiIndoorResult) {

    }
    //廢棄
    @Override
    public void onGetPoiDetailResult(PoiDetailResult poiDetailResult) {

    }
};

 

3. 設定檢索監聽器

mPoiSearch.setOnGetPoiSearchResultListener(listener);

 

4. 發起檢索請求

mPoiSearch.searchInCity((new PoiCitySearchOption())
        .city(cityName)//城市名稱
        .keyword(keyword)//必填
        .pageCapacity(pageSize)//每頁條數
        .pageNum(loadIndex));//分頁頁碼

 

5. 釋放檢索例項

mPoiSearch.destroy();


為了方便使用者檢視,我們可以在列表中展示每一個poi和使用者之間的距離,利用DistanceUtil類的getDistance()方法傳入兩個點座標的LatLng物件即可計算,如下:

double distance=DistanceUtil.getDistance(currentLatLng, latLng);

 

最後利用EditText的addTextChangedListener監聽器監聽輸入框,如果值改變就進行檢索。


 

至此,整個功能也就做完了,demo裡沒有做列表分頁和動態許可權申請,這個常用的你們就自個加咯,最後放下demo地址:
GitHub:https://github.com/yangxch/BaiDuMapSelectDemo

 

原創不易,轉載請註明出處!