廢話

前后兩千萬，拍照更清晰。大家好，這里是OPPO R11獨家冠名贊助播出的大型情感類電視連續(xù)劇《Android高德之旅》，我是主持人大公爵。這期節(jié)目，我們來講一下厲害的POI。

簡介

POI（Point of Interest，興趣點），在地圖表達中，一個 POI 可代表一棟大廈、一家商鋪、一處景點等等。通過POI搜索，完成找餐館、找景點、找?guī)鹊鹊墓δ堋５貓D SDK 的搜索功能提供多種獲取 POI 數(shù)據(jù)的接口。
我們這里要講的是四種：

• POI關(guān)鍵詞搜索
• POI周邊搜索
• POI ID搜索
• POI沿途搜索。

1、POI關(guān)鍵詞搜索

所謂關(guān)鍵詞搜索就是根據(jù)關(guān)鍵詞搜索POI（等于沒說），直接看代碼吧。

PoiSearch.Query query = new PoiSearch.Query(關(guān)鍵詞, POI類型, 城市名\城市編碼\空串);
query.setPageSize(10);
query.setPageNum(pageNo);
PoiSearch poiSearch = new PoiSearch(this, query);
poiSearch.setOnPoiSearchListener(new PoiSearch.OnPoiSearchListener() {
    @Override
    public void onPoiSearched(PoiResult poiResult, int rCode) {
 
    }

    @Override
    public void onPoiItemSearched(PoiItem poiItem, int rCode) {

    }
});
poiSearch.searchPOIAsyn();

代碼很簡單。構(gòu)建Query對象時，需要傳三個參數(shù)，第一個是關(guān)鍵詞，第二是POI類型，這兩個參數(shù)只要傳其一即可，第三個參數(shù)是城市名或城市編碼，如果傳空串，則會在全國范圍內(nèi)搜索。下面是設(shè)置分頁查詢的參數(shù)。

構(gòu)建好Query對象后，就可以構(gòu)建PoiSearch對象，調(diào)用searchPOIAsync方法搜索，搜索結(jié)果會通過onPoiSearched(PoiResult poiResult, int rCode)方法回調(diào)，我們拿到結(jié)果后，可以用前面的Marker技術(shù)展示在地圖中。

poiSearch.setOnPoiSearchListener(new PoiSearch.OnPoiSearchListener() {
    @Override
    public void onPoiSearched(PoiResult poiResult, int rCode) {
        ArrayList<PoiItem> pois = poiResult.getPois();
        List<MultiPointItem> list = new ArrayList<>();
        for (PoiItem item : pois) {
            LatLonPoint latLonPoint = item.getLatLonPoint();
            list.add(new MultiPointItem(new LatLng(latLonPoint.getLatitude(), latLonPoint.getLongitude())));
        }
        showResultOnMap(list);
    }

    @Override
    public void onPoiItemSearched(PoiItem poiItem, int rCode) {

    }
});

private void showResultOnMap(List<MultiPointItem> list) {
    MultiPointOverlayOptions overlayOptions = new MultiPointOverlayOptions();
    overlayOptions.icon(BitmapDescriptorFactory.fromResource(R.drawable.icon_mdl));
    overlayOptions.anchor(0.5f,0.5f);

    multiPointOverlay = aMap.addMultiPointOverlay(overlayOptions);
    multiPointOverlay.setItems(list);

    aMap.setOnMultiPointClickListener(new AMap.OnMultiPointClickListener() {
        @Override
        public boolean onPointClick(MultiPointItem pointItem) {
            return false;
        }
    });
}

2、POI周邊搜索

所謂周邊搜索就是搜索周邊POI，仍然可以傳關(guān)鍵詞，直接看代碼吧。

PoiSearch.Query query = new PoiSearch.Query(關(guān)鍵詞, POI類型, "");
query.setPageSize(10);
query.setPageNum(pageNo);

poiSearch = new PoiSearch(this, query);
LatLonPoint latLon = new LatLonPoint(39.993743, 116.472995);
poiSearch.setBound(new PoiSearch.SearchBound(latLon, 5000, true));
poiSearch.setOnPoiSearchListener(new PoiSearch.OnPoiSearchListener() {
    @Override
    public void onPoiSearched(PoiResult poiResult, int rCode) {

    }

    @Override
    public void onPoiItemSearched(PoiItem poiItem, int rCode) {

    }
});
poiSearch.searchPOIAsyn();

因為是查詢周邊，所以就不要傳城市名了，而是調(diào)用poiSearch.setBound()方法，設(shè)置你所在的地方。查詢結(jié)果的展示和上面關(guān)鍵詞搜索一樣。

3、POI ID搜索

這個當(dāng)時把我看蒙了，半天沒明白這個ID是什么東西。其實這個ID就是用關(guān)鍵詞或者周邊搜索搜出來的POI的ID。比如下面這個回調(diào)，我們獲得了一組PoiItem，如果你對某個PoiItem感興趣，就可以記錄一下它的id，將來直接用id就可以搜索之前感興趣的PoiItem。

poiSearch.setOnPoiSearchListener(new PoiSearch.OnPoiSearchListener() {
    @Override
    public void onPoiSearched(PoiResult poiResult, int rCode) {
        ArrayList<PoiItem> pois = poiResult.getPois();
        for (PoiItem item : pois) {
            if (感興趣) {
                save(item.getPoiId());
            }
        }
        showResultOnMap(list);
    }

    @Override
    public void onPoiItemSearched(PoiItem poiItem, int rCode) {

    }
});

4、POI沿途搜索

這個稍微高大上一點，比如我要開車去北京朝陽區(qū)，但是我車子快沒油了，于是我想搜索在我去朝陽區(qū)的沿途有哪些加油站，這就派上用場了，看代碼。

（1）首先，我們要確定兩個點：出發(fā)點，目的地

LatLonPoint mStartPoint = new LatLonPoint(39.742295, 116.235891);
LatLonPoint mEndPoint = new LatLonPoint(39.995576, 116.481288);

（2）為了看的更明顯，我們?yōu)檫@兩個點添加Marker

LatLng start = new LatLng(mStartPoint.getLatitude(), mStartPoint.getLongitude());
aMap.addMarker(new MarkerOptions()
        .position(start)
        .icon(BitmapDescriptorFactory.fromResource(R.drawable.start)));

LatLng end = new LatLng(mEndPoint.getLatitude(), mEndPoint.getLongitude());
aMap.addMarker(new MarkerOptions()
        .position(end)
        .icon(BitmapDescriptorFactory.fromResource(R.drawable.end)));

（3）顯示出導(dǎo)航路徑

為了凸顯出POI的搜索結(jié)果是真正的“沿途”，我們要把導(dǎo)航路徑顯示出來。

private void searchRoute() {
    mRouteSearch = new RouteSearch(this);
    mRouteSearch.setRouteSearchListener(new RouteSearch.OnRouteSearchListener() {
        @Override
        public void onBusRouteSearched(BusRouteResult busRouteResult, int i) {
            // 暫時不講
        }

        @Override
        public void onDriveRouteSearched(DriveRouteResult result, int errorCode) {
            // 暫時不講
        }

        @Override
        public void onWalkRouteSearched(WalkRouteResult walkRouteResult, int i) {
            // 暫時不講
        }

        @Override
        public void onRideRouteSearched(RideRouteResult rideRouteResult, int i) {
            // 暫時不講
        }
    });

    final RouteSearch.FromAndTo fromAndTo = new RouteSearch.FromAndTo(
            mStartPoint, mEndPoint);
    RouteSearch.DriveRouteQuery query = new RouteSearch.DriveRouteQuery(
            fromAndTo, //路徑規(guī)劃的起點和終點
            RouteSearch.DrivingDefault, //駕車模式
            null, //途經(jīng)點
            null, //示避讓區(qū)域
            null //避讓道路
    );
    mRouteSearch.calculateDriveRouteAsyn(query);
}

（4）搜索沿途POI

準(zhǔn)備工作做好了，下面要開始真正的搜索沿途的POI

private void searchRoutePOI() {
    RoutePOISearchQuery query = new RoutePOISearchQuery(
            mStartPoint ,mEndPoint, //起始點
            RouteSearch.DrivingDefault, //搜索模式是駕車模式
            RoutePOISearch.RoutePOISearchType.TypeGasStation, //搜索POI類型是加油站
            250
    );
    routePOISearch = new RoutePOISearch(this, query);
    routePOISearch.setPoiSearchListener(new RoutePOISearch.OnRoutePOISearchListener() {
        @Override
        public void onRoutePoiSearched(RoutePOISearchResult routePOISearchResult, int i) {
            //同上
        }
    });
    routePOISearch.searchRoutePOIAsyn();
}

（5）多類型

我們既然可以搜索加油站，當(dāng)然也可以搜索其它類型的POI，這里演示一下搜索三種類型。

總結(jié)

OK，以上就是POI的全部內(nèi)容了，本期節(jié)目就到這里，感謝大家收看，我們下期再見~