在沒(méi)介紹正文之前先給大家說(shuō)下poi是什么意思。
由于工作的關(guān)系，經(jīng)常在文件中會(huì)看到POI這三個(gè)字母的縮寫(xiě)，但是一直對(duì)POI的概念和含義沒(méi)有很詳細(xì)的去研究其背后代表的意思。今天下班之前，又看到了POI這三個(gè)字母，決定認(rèn)認(rèn)真真的搜索一些POI具體的含義。
POI是英文的縮寫(xiě)，原來(lái)的單詞是point of interest, 直譯成中文就是興趣點(diǎn)的意思。興趣點(diǎn)這個(gè)詞最早來(lái)自于導(dǎo)航地圖廠商。地圖廠商為了提供盡可能多的位置信息，花費(fèi)了很大的精力去尋找諸如加油站，餐館，酒店，景點(diǎn)等目的地，這些目的地其實(shí)都可以理解成一個(gè)一個(gè)的POI（興趣點(diǎn)）。POI除了指這些目的地的本身的信息，如電話，點(diǎn)評(píng)之外記錄了目的地的經(jīng)緯度，并能在電子地圖上加以顯示。這就是POI，以實(shí)用谷歌地圖為例，我們搜索北京天安門(mén)，會(huì)有一個(gè)別針樣子的東西在地圖上表示這天安門(mén)的位置，點(diǎn)擊會(huì)看到更多信息。其實(shí)這就是一個(gè)興趣點(diǎn)。
興趣點(diǎn)為什么很重要？現(xiàn)在電子地圖的普及率越來(lái)越高，沒(méi)有千千萬(wàn)萬(wàn)個(gè)興趣點(diǎn)，我們不能很方便的搜索到我們想去的地方。POI已成為現(xiàn)在電子商務(wù)以及O2O不可或缺的一環(huán)。
一、簡(jiǎn)介
POI（Point of Interest），中文可以翻譯為“興趣點(diǎn)”。在地理信息系統(tǒng)中，一個(gè)POI可以是一棟房子、一個(gè)商鋪、一個(gè)郵筒、一個(gè)公交站等。
Android 百度地圖POI搜索功能實(shí)例代碼
百度地圖SDK提供三種類型的POI檢索：周邊檢索、區(qū)域檢索和城市內(nèi)檢索。
l 周邊檢索：以某一點(diǎn)為中心，指定距離為半徑，根據(jù)用戶輸入的關(guān)鍵詞進(jìn)行POI檢索；
l 區(qū)域檢索：在指定矩形區(qū)域內(nèi)、根據(jù)關(guān)鍵詞進(jìn)行POI檢索；
l 城市內(nèi)檢索：在某一城市內(nèi)，根據(jù)用戶輸入的關(guān)鍵字進(jìn)行POI檢索；
自v3.6.1開(kāi)始，城市poi檢索返回結(jié)果新增門(mén)址類列表數(shù)據(jù)。例如：在“北京”搜索“上地十街1號(hào)”，除返回包含“上地十街1號(hào)”的poi列表以外，還包括地址為“上地十街1號(hào)”的明確門(mén)址。
具體來(lái)說(shuō)，即PoiSearch類的SearchInCity(PoiCitySearchOption) 發(fā)起檢索時(shí)返回的結(jié)果增加門(mén)址類數(shù)據(jù)。PoiResult中新增了GetAllAddr()獲取門(mén)址類列表，當(dāng)isHasAddrInfo() 返回true時(shí)，除了原poi列表外，還包含門(mén)址結(jié)果。
Android 百度地圖POI搜索功能實(shí)例代碼
POI詳情檢索是指根據(jù)POI的ID信息，檢索該興趣點(diǎn)的詳情。
Android 百度地圖POI搜索功能實(shí)例代碼
在線建議查詢是指根據(jù)關(guān)鍵詞查詢?cè)诰€建議詞。為了幫助開(kāi)發(fā)者實(shí)現(xiàn)檢索出來(lái)的關(guān)鍵詞快速定位到地圖上，SDK自3.5.0版本起，開(kāi)放了檢索結(jié)果的經(jīng)緯度信息及對(duì)應(yīng)POI點(diǎn)的UID信息。
注意：
a. 在線建議檢索的本質(zhì)是根據(jù)部分關(guān)鍵是檢索出來(lái)可能的完整關(guān)鍵詞名稱，如果需要這些關(guān)鍵詞對(duì)應(yīng)的POI的具體信息，請(qǐng)使用POI檢索來(lái)完成；
b. 在線檢索結(jié)果的第一條可能存在沒(méi)有經(jīng)緯度信息的情況，該條結(jié)果為文字聯(lián)想出來(lái)的關(guān)鍵詞結(jié)果，并不對(duì)應(yīng)任何確切POI點(diǎn)。例如輸入“肯”，第一條結(jié)果為“肯德基”，這條結(jié)果是一個(gè)泛指的名稱，不會(huì)帶有經(jīng)緯度等信息。
二、運(yùn)行截圖
簡(jiǎn)介：介紹關(guān)鍵詞查詢、suggestion查詢和查看餐飲類Place詳情頁(yè)功能
詳述：
（1）點(diǎn)擊某些關(guān)鍵詞查詢后的結(jié)果（如“餐廳”）可跳轉(zhuǎn)到Place詳情頁(yè)；
（2）提供suggestion查詢進(jìn)行聯(lián)想查詢，例如輸入“天安門(mén)”則會(huì)彈出聯(lián)想查詢的列表；
本示例運(yùn)行截圖如下：
三、設(shè)計(jì)步驟
1、添加demo12_poisearch.xml文件
在layout文件夾下添加該文件，然后將代碼改為下面的內(nèi)容：
<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="fill_parent"android:layout_height="fill_parent"android:orientation="vertical" ><LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="fill_parent"android:layout_height="50dip"android:orientation="horizontal" ><TextViewandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:text="在" ></TextView><EditTextandroid:id="@+id/city"android:layout_width="wrap_content"android:layout_height="match_parent"android:text="北京" /><TextViewandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:text="市內(nèi)找" ></TextView><AutoCompleteTextViewandroid:id="@+id/searchkey"android:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_weight="0.88"android:text="餐廳" /></LinearLayout><LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="fill_parent"android:layout_height="50dip"android:orientation="horizontal" ><Buttonandroid:id="@+id/search"android:layout_width="fill_parent"android:layout_height="wrap_content"android:layout_weight="12"android:background="@drawable/button_style"android:padding="10dip"android:text="開(kāi)始" /><Buttonandroid:id="@+id/map_next_data"android:layout_width="fill_parent"android:layout_height="wrap_content"android:layout_weight="12"android:background="@drawable/button_style"android:padding="10dip"android:text="下一組數(shù)據(jù)" /></LinearLayout><fragmentandroid:id="@+id/map"android:layout_width="match_parent"android:layout_height="match_parent"class="com.baidu.mapapi.map.TextureMapFragment" /></LinearLayout>
2、添加OverlayManager.cs文件
新建一個(gè)SrcOverlayUtil文件夾，在該文件夾下添加該文件。
說(shuō)明：SrcOverlayUtil文件夾下的文件用于自定義一些基于基礎(chǔ)覆蓋而組合而成的高級(jí)覆蓋物，包括用于顯示poi數(shù)據(jù)，規(guī)劃路線，公交詳情路線的覆蓋物等。
using Com.Baidu.Mapapi.Map;using Com.Baidu.Mapapi.Model;using System.Collections.Generic;namespace BdMapV371Demos.SrcOverlayUtil{/// <summary>/// 提供一個(gè)能夠顯示和管理多個(gè)Overlay的基類。/// 將覆蓋物點(diǎn)擊事件傳遞給OverlayManager后，OverlayManager才能響應(yīng)點(diǎn)擊事件。/// 在MarkerClick事件中處理Marker點(diǎn)擊事件。/// </summary>public abstract class OverlayManager : Java.Lang.Object, BaiduMap.IOnMarkerClickListener, BaiduMap.IOnPolylineClickListener{BaiduMap mBaiduMap = null;private List<OverlayOptions> mOverlayOptionList = null;protected List<Overlay> mOverlayList = null;public OverlayManager(BaiduMap baiduMap){mBaiduMap = baiduMap;mBaiduMap.SetOnMarkerClickListener(this);if (mOverlayOptionList == null){mOverlayOptionList = new List<OverlayOptions>();}if (mOverlayList == null){mOverlayList = new List<Overlay>();}}/// <summary>/// 重寫(xiě)此方法設(shè)置要管理的Overlay列表/// </summary>/// <returns></returns>public abstract List<OverlayOptions> GetOverlayOptions();/// <summary>/// 將所有Overlay 添加到地圖上/// </summary>public void AddToMap(){if (mBaiduMap == null){return;}RemoveFromMap();List<OverlayOptions> overlayOptions = GetOverlayOptions();if (overlayOptions != null){mOverlayOptionList.AddRange(GetOverlayOptions());}foreach (OverlayOptions option in mOverlayOptionList){mOverlayList.Add(mBaiduMap.AddOverlay(option));}}/// <summary>/// 將所有Overlay從地圖上消除/// </summary>public void RemoveFromMap(){if (mBaiduMap == null){return;}foreach (Overlay marker in mOverlayList){marker.Remove();}mOverlayOptionList.Clear();mOverlayList.Clear();}/// <summary>/// 縮放地圖，使所有Overlay都在合適的視野內(nèi)/// 注： 該方法只對(duì)Marker類型的overlay有效/// </summary>public void ZoomToSpan(){if (mBaiduMap == null){return;}if (mOverlayList.Count > 0){LatLngBounds.Builder builder = new LatLngBounds.Builder();foreach (Overlay overlay in mOverlayList){// polyline 中的點(diǎn)可能太多，只按marker縮放if (overlay is Marker){builder.Include(((Marker)overlay).Position);}}mBaiduMap.SetMapStatus(MapStatusUpdateFactory.NewLatLngBounds(builder.Build()));}}public virtual bool OnMarkerClick(Marker marker){return false;}public virtual bool OnPolylineClick(Polyline polyline){return false;}}} 3、添加PoiOverlay.cs文件
在SrcOverlayUtil文件夾下添加該文件。
using Android.OS;using Android.Widget;using Com.Baidu.Mapapi;using Com.Baidu.Mapapi.Map;using Com.Baidu.Mapapi.Search.Poi;using System.Collections.Generic;namespace BdMapV371Demos.SrcOverlayUtil{/// <summary>/// 顯示一條公交詳情結(jié)果的Overlay，繼承自該類的子類可顯示其他類型的Overlay/// </summary>public class PoiOverlay : OverlayManager{private static readonly int MaxPoiSize = 10;private PoiResult mPoiResult = null;public PoiOverlay(BaiduMap baiduMap) : base(baiduMap){}/// <summary>/// 設(shè)置POI數(shù)據(jù)/// </summary>/// <param name="poiResult">POI結(jié)果數(shù)據(jù)</param>public void SetData(PoiResult poiResult){this.mPoiResult = poiResult;}public override List<OverlayOptions> GetOverlayOptions(){if (mPoiResult == null || mPoiResult.AllPoi == null){return null;}List<OverlayOptions> markerList = new List<OverlayOptions>();int markerSize = 0;for (int i = 0; i < mPoiResult.AllPoi.Count && markerSize < MaxPoiSize; i++){if (mPoiResult.AllPoi[i].Location == null){continue;}markerSize++;Bundle bundle = new Bundle();bundle.PutInt("index", i);markerList.Add(new MarkerOptions().InvokeIcon(BitmapDescriptorFactory.FromAssetWithDpi("Icon_mark"+ markerSize + ".png")).InvokeExtraInfo(bundle).InvokePosition(mPoiResult.AllPoi[i].Location));}return markerList;}/// <summary>/// 獲取該 PoiOverlay 的 poi數(shù)據(jù)/// </summary>public PoiResult GetPoiResult(){return mPoiResult;}/// <summary>/// 重寫(xiě)此方法可改變默認(rèn)點(diǎn)擊行為/// </summary>/// <param name="i">被點(diǎn)擊的poi在PoiResult.AllPoi中的索引</param>/// <returns></returns>public virtual bool OnPoiClick(int i){if (mPoiResult.AllPoi != null && mPoiResult.AllPoi[i] != null){Toast.MakeText(BMapManager.Context,mPoiResult.AllPoi[i].Name, ToastLength.Long).Show();}return false;}public override bool OnMarkerClick(Marker marker){if (!mOverlayList.Contains(marker)){return false;}if (marker.ExtraInfo != null){return OnPoiClick(marker.ExtraInfo.GetInt("index"));}return false;}public override bool OnPolylineClick(Polyline polyline){return false;}}} 4、添加Demo12PoiSearch.cs文件
在SrcSdkDemos文件夾下添加該文件，然后將代碼改為下面的內(nèi)容：
using Android.App;using Android.Content.PM;using Android.OS;using Android.Support.V4.App;using Android.Widget;using BdMapV371Demos.SrcOverlayUtil;using Com.Baidu.Mapapi.Map;using Com.Baidu.Mapapi.Search.Core;using Com.Baidu.Mapapi.Search.Poi;using Com.Baidu.Mapapi.Search.Sug;namespace BdMapV371Demos.SrcSdkDemos{/// <summary>/// 演示poi搜索功能/// </summary>[Activity(Label = "@string/demo_name_poi",ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.KeyboardHidden,ScreenOrientation = ScreenOrientation.Sensor)]public class Demo12PoiSearch : FragmentActivity{private PoiSearch mPoiSearch = null;private SuggestionSearch mSuggestionSearch = null;private BaiduMap mBaiduMap = null;// 搜索關(guān)鍵字輸入窗口private AutoCompleteTextView keyWorldsView = null;private ArrayAdapter<string> sugAdapter = null;private int load_Index = 0;protected override void OnCreate(Bundle savedInstanceState){base.OnCreate(savedInstanceState);SetContentView(Resource.Layout.demo12_poisearch);// 初始化搜索模塊，注冊(cè)搜索事件監(jiān)聽(tīng)mPoiSearch = PoiSearch.NewInstance();mPoiSearch.GetPoiResult += (s, e) =>{var result = e.P0;if (result == null|| result.Error == SearchResult.ERRORNO.ResultNotFound){return;}if (result.Error == SearchResult.ERRORNO.NoError){mBaiduMap.Clear();PoiOverlay overlay = new MyPoiOverlay(this, mBaiduMap);mBaiduMap.SetOnMarkerClickListener(overlay);overlay.SetData(result);overlay.AddToMap();overlay.ZoomToSpan();return;}if (result.Error == SearchResult.ERRORNO.AmbiguousKeyword){// 當(dāng)輸入關(guān)鍵字在本市沒(méi)有找到，但在其他城市找到時(shí)，返回包含該關(guān)鍵字信息的城市列表string strInfo = "在";foreach (CityInfo cityInfo in result.SuggestCityList){strInfo += cityInfo.City;strInfo += ",";}strInfo += "找到結(jié)果";Toast.MakeText(this, strInfo, ToastLength.Long).Show();}};mPoiSearch.GetPoiDetailResult += (s, e) =>{var result = e.P0;if (result.Error != SearchResult.ERRORNO.NoError){Toast.MakeText(this, "抱歉，未找到結(jié)果", ToastLength.Short).Show();}else{Toast.MakeText(this, "成功，查看詳情頁(yè)面", ToastLength.Short).Show();}};mSuggestionSearch = SuggestionSearch.NewInstance();mSuggestionSearch.GetSuggestionResult += (s, e) =>{var res = e.P0;if (res == null || res.AllSuggestions == null) return;sugAdapter.Clear();foreach (SuggestionResult.SuggestionInfo info in res.AllSuggestions){if (info.Key != null) sugAdapter.Add(info.Key);}sugAdapter.NotifyDataSetChanged();};keyWorldsView = FindViewById<AutoCompleteTextView>(Resource.Id.searchkey);sugAdapter = new ArrayAdapter<string>(this, Android.Resource.Layout.SimpleDropDownItem1Line);keyWorldsView.Adapter = sugAdapter;TextureMapFragment map1 = FragmentManager.FindFragmentById<TextureMapFragment>(Resource.Id.map);mBaiduMap = map1.BaiduMap;// 當(dāng)輸入關(guān)鍵字變化時(shí)，動(dòng)態(tài)更新建議列表keyWorldsView.AfterTextChanged += (sender, e) => { };keyWorldsView.BeforeTextChanged += (sender, e) => { };keyWorldsView.TextChanged += (sender, e) =>{string s = e.Text.ToString();if (s.Length <= 0) return;string city = (FindViewById<EditText>(Resource.Id.city)).Text;// 使用建議搜索服務(wù)獲取建議列表，結(jié)果在onSuggestionResult()中更新mSuggestionSearch.RequestSuggestion(new SuggestionSearchOption().Keyword(s).City(city));};Button btnSearch = FindViewById<Button>(Resource.Id.search);btnSearch.Click += delegate{SearchButtonProcess();};Button btnNext = FindViewById<Button>(Resource.Id.map_next_data);btnNext.Click += delegate{load_Index++;SearchButtonProcess();};}protected override void OnPause(){base.OnPause();}protected override void OnResume(){base.OnResume();}protected override void OnDestroy(){mPoiSearch.Destroy();mSuggestionSearch.Destroy();base.OnDestroy();}protected override void OnSaveInstanceState(Bundle outState){base.OnSaveInstanceState(outState);}protected override void OnRestoreInstanceState(Bundle savedInstanceState){base.OnRestoreInstanceState(savedInstanceState);}public void SearchButtonProcess(){EditText editCity = FindViewById<EditText>(Resource.Id.city);EditText editSearchKey = FindViewById<EditText>(Resource.Id.searchkey);mPoiSearch.SearchInCity(new PoiCitySearchOption().City(editCity.Text).Keyword(editSearchKey.Text).PageNum(load_Index));}private class MyPoiOverlay : PoiOverlay{Demo12PoiSearch poiSearchDemo;public MyPoiOverlay(Demo12PoiSearch poiSearchDemo, BaiduMap baiduMap) :base(baiduMap){this.poiSearchDemo = poiSearchDemo;}public override bool OnPoiClick(int index){base.OnPoiClick(index);PoiInfo poi = GetPoiResult().AllPoi[index];if (poi.HasCaterDetails){poiSearchDemo.mPoiSearch.SearchPoiDetail(new PoiDetailSearchOption().PoiUid(poi.Uid));}return true;}}}} 5、修改MainActivity.cs
在MainActivity.cs文件的demos字段定義中，去掉【示例12】下面的注釋。
新聞熱點(diǎn)
疑難解答
圖片精選
