街景開發(fā)指南9.0android sdk v0.9

1、地圖 Android街景 SDK 開發(fā)指南V0.92014 年 3 月法律2013，保留一切權(quán)利。本文檔包含的所有內(nèi)容除特別之外，均屬于所有，受中民著作權(quán)法及相關(guān)和中國加入的所有知識方面的國際條約的保護。本公司，任何和個人不得以任何方式（電子或機械，包括影?。┗虮疚臋n的，否則將視為，保留依法其的權(quán)利。地圖 API 的一切有關(guān)權(quán)利屬于所有?？稍诓蛔魅魏伪疚臋n并不代表供應(yīng)商或其的承諾的情況下對本文檔內(nèi)容進行修改。本文檔中所涉及的產(chǎn)品及其后續(xù)升級產(chǎn)品均由制作并負責全權(quán)銷售。本文檔中提到的其它公司及其產(chǎn)品的商標所屬于該商標的所有者。地圖聯(lián)系郵箱：技術(shù)交流：商務(wù)合作聯(lián)系人：張先生/dedituapi：電

2、子郵箱：shiyue.地圖 API 歡迎用戶的任何建議或意見。目錄1 簡介11.11.21.31.4Android 街景 SDK1面向的讀者1兼容性1申請 API Key123配置工程2街景顯示43.13.23.3全景圖的基本信息4顯示設(shè)置4示例44可視區(qū)域操作74.14.24.34.4方向7俯仰角7縮放級別7示例75手勢控制95.15.2縮放手勢9方向手勢96街景控件106.16.2導航線10街道名稱117街景標注117.17.2添加和刪除街景標注12示例128事件響應(yīng)148.18.28.38.48.58.6點擊街景事件14長按街景事件14切換全景圖事件14視角改變事件14街景標注點擊事件1

3、4示例149 街景截屏15I1簡介Android 街景 SDK地圖 Android 街景 SDK 是為 Android 應(yīng)用開發(fā)者提供的在 Android應(yīng)用中展現(xiàn)定點 360度全景圖的開發(fā)包。通過街景，您可以更加真實和全方位地了解城市面貌。此 SDK 有街景展示，對街景縮放移動手勢操作，在街景中添加標注，對當前街景截屏等方法。目前，街景覆蓋城市城市。查看街景面向的讀者地圖Android 街景SDK 是提供給具有一定Android 編程經(jīng)驗和了解面此外，讀者還應(yīng)該對地圖產(chǎn)品有一定的了解。象概念的讀者使用的。用戶在使用中遇到任何問題，都可以通過官網(wǎng)提供的或問答社區(qū)反饋給。兼容性地圖 Androi

4、d 街景 SDK 0.9 版本支持 Android 2.2 及以上系統(tǒng)。申請 API Key為保證服務(wù)可以正常使用，您需要登錄 AMap API申請 API Key。每個帳戶，最多可以申請 10個 Key。Key 申請的具體流程請參照獲取密鑰。| 12配置工程工程配置操作如下：1.從并解壓得到街景顯示包“AMapPanoramaSDK0.9.jar”和文件夾“armeabi”（含libpanoramaAmapV0.9.so 文件）。注意：若您在 Eclipse 上使用 adt22 版本插件，則需要在 Eclipse 上進行如下配置：選中 Eclipse 的工程，右擊選擇“Properties

5、Java Build Path Order and Export”，勾選“Android Privaibraries”。2.開發(fā)工程中新建“l(fā)ibs”文件夾，將街景顯示包拷貝到 libs 的根目錄下?？截愅瓿珊蟮墓こ棠夸?以 V0.9 為例)：3.添加用戶 Key。在工程的“AndroidManifest.xml”文件如下代碼中添加您的用戶 Key。4.添限。在工程的“AndroidManifest.xml”文件中進行添加，請直接拷貝。| 25.clean 工程，結(jié)束配置。| 33街景顯示街景圖像通過一個 AMapPanoramaView（全景圖視圖）對象作為容器來顯示。AMapPanoram

6、aView（全景圖視圖）對象包括 AMapPanoramaCamera 對象來控制全景圖方向、仰俯角、縮放級別，AMapPanoramaListener 對象來街景圖像的事件，AMapPanorama 顯示全景圖的基本信息。AMapPanoramaView 類自動處理以下操作：連接到街景服務(wù)街景數(shù)據(jù)在設(shè)備屏幕上顯示街景顯示各種控件，如方向控件支持各種視區(qū)域操作，如方向、俯仰角使用 AMapPanoramaView 類，必須重載 Activity 生命周期的所有方法，有 onDestroy()， onResume()，onPause(),onStop()。全景圖的基本信息AMapPanorama

7、（全景圖信息）對象用于定義全景圖的基本信息，包括：ID位置（通過指定坐標）坐標顯示特定位置的全景地圖顯示設(shè)置可以設(shè)置街景的街道名稱、導航線是否可見，是否可以縮放或移動街景。示例布局文件（res/layout/ activity_main.xml）程序代碼（com.amap.panorama.MainActivity.java）：| 4public class MainActivity extendivity private sic final_ITEM_COUNTER = 10;| 5/一個 AMapPanoramaView 對象private AMapPanoramaView mPanorm

8、aView; public sic Context context;public double lat = 39.88389419203265; public double lon = 116.4207155882398;/必須重寫Overrideprotected void onCreate(Bundle savedInstane) super.onCreate(savedInstane); this.requestWindowFeature(Window.FEATURE_NO_TITLE);this.getWindow().setFlags(WindowManager.LayoutPara

9、ms.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);context = this.getBaseContext(); setContentView(R.layout.activity_main);/在指定頁面 id 顯示街景試圖mPanormaView = (AMapPanoramaView) this.findViewById(R.id.panoramaViewGroup);/在指定點添加街景視圖mPanormaView.initData(new Lng(39.88389419203205, 116.42071558

10、82398), 64);Overrideprotected void onPause() super.onPause(); mPanormaView.onPause();/必須重寫 OverridepubliconKeyDown(keyCode, KeyEvent event) if (keyCode = KeyEvent.KEYCODE_BACK) mPanormaView.onKeyBack();return super.onKeyDown(keyCode, event);/必須重寫Overrideprotected void onResume() super.onResume();街景的

11、顯示效果如下圖所示：| 6mPanormaView.onResume();/必須重寫Overrideprotected void onStop() super.onStop();/必須重寫Overridepublic void onDestroy() super.onDestroy(); mPanormaView.onDestroy(); mPanormaView.finalize();4可視區(qū)域操作在街景時，可以假設(shè)屏幕為街景的鏡頭，通過調(diào)整鏡頭來展示街景不同的區(qū)域。AMapPanoramaCamera 是用來控制街景可視區(qū)域鏡頭視角的對象，包含以下屬性：方向俯仰角縮放級別在初始化街景地圖時

12、，通過 AMapPanoramaView 對象的 camera 字段，可以指定一個AMapPanoramaCamera 對象來控制全景圖的可視區(qū)域。在街景地圖初始化完成后，在調(diào)整可視區(qū)域的方向、俯仰角或縮放級別后，需要通過設(shè)置AMapPanoramaView 對象的 moveCamera 方法更新可視區(qū)域。方向鏡頭可以在街景地圖水平方向 360 度旋轉(zhuǎn)，在不同的水平旋轉(zhuǎn)角度有不同的街景內(nèi)容，調(diào)整角度能夠看到此地點不同的街景內(nèi)容。方向即指鏡頭在水平方向的旋轉(zhuǎn)角度。通過 AMapPanoramaCamera 對象的 heading 字段可以設(shè)置changeHeading(float mHeadin

13、g)方法用于改變?nèi)皥D的方向，范圍為 0 到 360 度。方向。俯仰角俯仰角是指鏡頭在垂直方向的旋轉(zhuǎn)角度，通過調(diào)整俯仰角可以在垂直方向不同的角度內(nèi)容。通過 AMapPanoramaCamera 對象的 pitch 字段可以設(shè)置俯仰角，范圍為 11 到 90 度。不同的街景changtch(float mPitch)方法用于改變?nèi)皥D的俯仰角。縮放級別縮放級別是指鏡頭在屏幕上的可視區(qū)域范圍，范圍為 40-75 度，40 度表示鏡頭夾角為 40 度時在手機屏幕上的可視區(qū)域范圍，75 度表示鏡頭夾角為 75 度時在屏幕上的可視區(qū)域范圍。通過 AMapPanoramaCamera 對象的 zoom 字

14、段可以設(shè)置縮放級別 changeZoom(float mZoom)方法用于改變?nèi)皥D的縮放級別。示例以下代碼示范了如何調(diào)整并移動可視區(qū)域。| 7AMapPanoramaCamera camera = view.getCamera(); camera.changeHeading(30);| 8mPanormaView.moveCamera(camera);5手勢控制街景全景圖支持方向手勢縮放手勢勢操作有：縮放手勢改變可視區(qū)域的縮放級別，地圖可以響應(yīng)勢如下：雙擊街景視圖可以使街景視圖放大一級兩個手指捏/拉伸通過 AMapPanoramaView 對象的 setZoomGesturesEnabled

15、(否可用。設(shè)置為 true 表示縮放手勢可用，false 表示禁用縮放手勢。示例代碼：)方法可以設(shè)置縮放手勢是方向手勢街景視圖的方向包括俯仰角和方向，方向手勢如下：在屏幕上下滑動改變街景視圖的俯仰角在屏幕左右滑動改變街景視圖的方向通過AMapPanoramaView 對象的setOrienionGesturesEnabled(否可用。設(shè)置為 true 表示方向手勢可用，false 表示禁用方向手勢。示例代碼：)方法可以方向手勢是| 9mPanormaView.setOrienionGesturesEnabled(true);mPanormaView.setZoomGesturesEnabled

16、(true);6街景控件街景 SDK 提供一些內(nèi)置的 UI 控件：導航線（南北箭頭），街道名稱。導航線街景 SDK 提供內(nèi)置的導航線，顯示在街景的正下方來控制街景的移動方向。默認是可見的。通過 AMapPanoramaView 的 setNavigationLinksHiddenEnabled() 方法來控制導航線（南北箭頭）的可見性。顯示效果圖如下：示例代碼如下：| 10/導航線隱藏 mPanormaView.setStreetNamesHiddenEnabled(true);/導航線顯示 mPanormaView.setStreetNamesHiddenEnabled(false);街道名

17、稱街景 SDK 提供各街道名稱的顯示和隱藏。默認是可見的。通過 AMapPanoramaView 的 setStreetNamesHiddenEnabled() 方法來控制街道名稱的可見性。顯示效果圖如下：示例代碼如下：7街景標注開發(fā)者可以在街景視圖的指定點添加標注，標注擁有自己的地理坐標。街景標注模擬真實的人眼與物體的關(guān)系，當鏡頭離標注越近標注顯示越大，當鏡頭離標注越遠標注顯示越小。| 11/街道名稱隱藏 mPanormaView.setStreetNamesHiddenEnabled(true);/街道名稱顯示 mPanormaView.setStreetNamesHiddenEnable

18、d(false);AMapPanoramaMarker 是用來添加街景標注的對象。通過指定ID 來設(shè)置其唯一標識。添加街景標注如下圖所示，左邊為添加 marker，右邊為 marker 刪除。點來添加標注，設(shè)置標注的添加和刪除街景標注構(gòu)造標注：AMapPanoramaMarker 類是用來添加標注的對象街景標注的 ID 是其唯一標識。添加： AMapPanoramaView 的 addMarker()方法來添加標注。刪除：AMapPanoramaView 的 clear()方法來刪除所有標注，AMapPanoramaMarker 的 remove()方法用來刪除單個標注。示例以下示例向您展示如

19、何定義一個街景標記并添加到街景，以及如何刪除標注。| 12/初始化 m1 標注對象AMapPanoramaMarker m1 = new AMapPanoramaMarker(new Lng(| 1339.88459419203205, 116.4207155882398);/設(shè)置標注 ID m1.setId(m1);/在地圖上添加標注 mPanormaView.addMarker(m1);/刪除添加的所有標注 mPanormaView.clear();8事件響應(yīng)通過 AMapPanoramaView 的 setAMapPanoramaListener() 方法來對街景地圖進行事件過重寫各個事件函數(shù)來處理當操作街景時的事件響應(yīng)結(jié)果。通點擊街景事件onPanoramaViewClick() 為點擊街景時的函數(shù)。如果用戶點擊街景上的某個點，會調(diào)用此方法。長按街景事件onPanoramaViewLongClick()為長按街景時的函數(shù)。如果用戶長按街景上的某個點，會調(diào)用此