《騰訊1+x安卓應(yīng)用開發(fā)（中級(jí)）》教案

一、教案設(shè)計(jì)課題項(xiàng)目3任務(wù)1顯示基礎(chǔ)地圖課型理論課理論課時(shí)1課時(shí)實(shí)踐課時(shí)2課時(shí)教學(xué)目標(biāo)知識(shí)目標(biāo)能力（技能）目標(biāo)1.熟悉騰訊位置服務(wù)地圖key的獲取和配置方法2.熟悉在項(xiàng)目中集成SDK的方法。3.熟悉顯示地圖需要哪些權(quán)限。能利用騰訊提供的位置服務(wù)在界面上顯示基礎(chǔ)地圖。教學(xué)重點(diǎn)掌握顯示基礎(chǔ)地圖的方法。教學(xué)難點(diǎn)圖形繪制的常用類和方法的靈活使用教學(xué)內(nèi)容想要使用騰訊位置服務(wù)地圖SDK，必須先申請(qǐng)一個(gè)開發(fā)者賬號(hào)，申請(qǐng)地址：/dev/console/home。然后前往/console/key.html，申請(qǐng)APIKey。1.獲取key（1）進(jìn)入控制臺(tái)左側(cè)應(yīng)用管理->我的應(yīng)用，創(chuàng)建新密鑰。圖6-2創(chuàng)建新密鑰（2）點(diǎn)擊創(chuàng)建應(yīng)用，設(shè)置應(yīng)用名稱和應(yīng)用類型。圖6-3創(chuàng)建應(yīng)用（3）點(diǎn)擊添加KEY，填寫KEY名稱、描述、閱讀并同意使用條款等應(yīng)用信息。圖6-4添加KEY（4）key需要勾選地圖SDK權(quán)限配置。在紅框處填寫包名。圖6-5勾選地圖SDK權(quán)限配置2.在項(xiàng)目中集成SDK（1）在Project的build.gradle文件中配置repositories，添加maven或jcenter倉庫地址。AndroidStudio默認(rèn)會(huì)在Project的build.gradle為所有module自動(dòng)添加jcenter倉庫地址，如果已存在，則不需要重復(fù)添加。buildscript{repositories{google()jcenter()mavenCentral()}dependencies{classpath"com.android.tools.build:gradle:4.1.1"}}allprojects{repositories{google()jcenter()mavenCentral()}}（2）在主工程appmodule的build.gradle文件配置dependencies。如需引入指定版本SDK（所有SDK版本號(hào)與官網(wǎng)發(fā)版一致），則在appmodule的build.gradle中修改maven倉庫版本號(hào)。dependencies{//地圖庫implementation'com.tencent.map:tencent-map-vector-sdk:4.4.1'}3.在AndroidManifest.xml的application標(biāo)簽中配置key在AndroidManifest.xml文件的application標(biāo)簽里，添加名稱為TencentMapSDK的meta，如下所示，value值是步驟1中申請(qǐng)的key。<application <meta-dataandroid:name="TencentMapSDK"android:value="申請(qǐng)的key"/></application>4.在AndroidManifest.xml中添加權(quán)限配置地圖SDK需要使用網(wǎng)絡(luò)，訪問硬件存儲(chǔ)等系統(tǒng)權(quán)限，在AndroidManifest.xml文件里，添加如下權(quán)限。<!--通過GPS得到精確位置--><uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/><!--通過網(wǎng)絡(luò)得到粗略位置--><uses-permissionandroid:name="android.permission.ACCESS_COARSE_LOCATION"/><!--訪問網(wǎng)絡(luò)，某些位置信息需要從網(wǎng)絡(luò)服務(wù)器獲取--><uses-permissionandroid:name="android.permission.INTERNET"/><!--訪問WiFi狀態(tài)，需要WiFi信息用于網(wǎng)絡(luò)定位--><uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/><!--修改WiFi狀態(tài)，發(fā)起WiFi掃描,需要WiFi信息用于網(wǎng)絡(luò)定位--><uses-permissionandroid:name="android.permission.CHANGE_WIFI_STATE"/><!--訪問網(wǎng)絡(luò)狀態(tài),檢測(cè)網(wǎng)絡(luò)的可用性，需要網(wǎng)絡(luò)運(yùn)營商相關(guān)信息用于網(wǎng)絡(luò)定位--><uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/><!--訪問網(wǎng)絡(luò)的變化,需要某些信息用于網(wǎng)絡(luò)定位--><uses-permissionandroid:name="android.permission.CHANGE_NETWORK_STATE"/><!--訪問手機(jī)當(dāng)前狀態(tài),需要某些信息用于網(wǎng)絡(luò)定位--><uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/>5.顯示基礎(chǔ)地圖（1）在局部文件中添加騰訊地圖組件<?xmlversion="1.0"encoding="utf-8"?><androidx.constraintlayout.widget.ConstraintLayoutxmlns:android="/apk/res/android"xmlns:app="/apk/res-auto"xmlns:tools="/tools"android:layout_width="match_parent"android:layout_height="match_parent"tools:context=".ui.activity.TencentMapActivity"><androidx.appcompat.widget.LinearLayoutCompatandroid:layout_width="match_parent"android:layout_height="match_parent"><com.tencent.tencentmap.mapsdk.maps.MapViewandroid:id="@+id/tencent_mapview"android:layout_width="match_parent"android:layout_height="match_parent"/></androidx.appcompat.widget.LinearLayoutCompat></androidx.constraintlayout.widget.ConstraintLayout>（2）在TencentMapActivity.java中管理地圖的生命周期。創(chuàng)建地圖視圖之后，需要跟應(yīng)用綁定生命周期，以保障地圖在應(yīng)用的不同生命周期中，能夠正確地處理顯示和刷新邏輯。（3）在TencentMapActivity.java中獲取地圖實(shí)例。TencentMapActivity.java代碼如下：packagecom.example.helloworld.ui.activity;…//省略導(dǎo)入包publicclassTencentMapActivityextendsAppCompatActivity{privateMapViewmapView;protectedTencentMaptencentMap;@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.activity_tencent_map);mapView=findViewById(R.id.tencent_mapview);//獲取地圖實(shí)例tencentMap=mapView.getMap();}@OverrideprotectedvoidonStart(){super.onStart();mapView.onStart();}@OverrideprotectedvoidonResume(){super.onResume();mapView.onResume();}@OverrideprotectedvoidonPause(){super.onPause();mapView.onPause();}@OverrideprotectedvoidonStop(){super.onStop();mapView.onStop();}@OverrideprotectedvoidonRestart(){super.onRestart();mapView.onRestart();}@OverrideprotectedvoidonDestroy(){super.onDestroy();mapView.onDestroy();}}教學(xué)準(zhǔn)備教材，PPT、教綱、教案參考資料/mobile/androidMapSDK/developerGuide/androidSummary教學(xué)過程方法與手段教學(xué)備注【課堂導(dǎo)入】騰訊位置服務(wù)是如何實(shí)現(xiàn)基礎(chǔ)地圖顯示的呢？騰訊位置服務(wù)地圖SDK（Android）是一套基于Android4.1及以上版本的多種地理位置服務(wù)的應(yīng)用程序接口。通過調(diào)用該接口，可以輕松訪問騰訊地圖服務(wù)和數(shù)據(jù)，構(gòu)建功能豐富、交互性強(qiáng)、契合各種行業(yè)場(chǎng)景的地圖類應(yīng)用程序。也可以在自己的Android應(yīng)用中加入地圖相關(guān)的功能，包括：地圖展示、標(biāo)注、繪制圖形等?！窘虒W(xué)實(shí)施】6.1.1任務(wù)描述利用騰訊提供的位置服務(wù)在界面上顯示基礎(chǔ)地圖，如圖所示。6.1.2問題引導(dǎo)騰訊位置服務(wù)是如何實(shí)現(xiàn)基礎(chǔ)地圖顯示的呢？騰訊位置服務(wù)地圖SDK（Android）是一套基于Android4.1及以上版本的多種地理位置服務(wù)的應(yīng)用程序接口。通過調(diào)用該接口，可以輕松訪問騰訊地圖服務(wù)和數(shù)據(jù)，構(gòu)建功能豐富、交互性強(qiáng)、契合各種行業(yè)場(chǎng)景的地圖類應(yīng)用程序。也可以在自己的Android應(yīng)用中加入地圖相關(guān)的功能，包括：地圖展示、標(biāo)注、繪制圖形等。6.1.3知識(shí)準(zhǔn)備申請(qǐng)一個(gè)開發(fā)者賬號(hào)獲取key在項(xiàng)目中集成SDK在AndroidManifest.xml的application標(biāo)簽中配置key在AndroidManifest.xml中添加權(quán)限配置顯示基礎(chǔ)地圖6.1.4完成基礎(chǔ)地圖的顯示6.1.5知識(shí)拓展地圖白屏的原因和解決辦法地圖黑屏的原因和解決辦法【知識(shí)（技能）鞏固練習(xí)】完成基礎(chǔ)地圖的顯示【教學(xué)小結(jié)】講授、演示課后作業(yè)與訓(xùn)練完成項(xiàng)目3課后練習(xí)對(duì)應(yīng)的習(xí)題。教學(xué)反思

課題項(xiàng)目3任務(wù)2在地圖上實(shí)現(xiàn)定位課型理論課理論課時(shí)2課時(shí)實(shí)踐課時(shí)2課時(shí)教學(xué)目標(biāo)知識(shí)目標(biāo)能力（技能）目標(biāo)1.熟悉安卓系統(tǒng)下GPS核心API。2.熟悉騰訊位置服務(wù)地圖SDK的使用。1.能夠獲取定位信息，通過模擬器發(fā)送GPS信息。2.能夠整合地圖服務(wù)，根據(jù)GPS在地圖上定位。教學(xué)重點(diǎn)1.定位信息的獲取。2.在地圖上實(shí)現(xiàn)定位。教學(xué)難點(diǎn)GPS核心API的靈活運(yùn)用。教學(xué)內(nèi)容定位分為GPS定位、基站定位和WIFI定位三種方式。GPS定位精度高，定位精度與環(huán)境有關(guān)，室內(nèi)不能用，耗電大；基站定位精度較低，功耗大，但不受環(huán)境影響，不需要開啟WIFI；Wi-Fi定位精度一般不受使用環(huán)境影響，但需要開啟Wi-Fi。1.Android中GPS的核心API。（1）LocationManager類所有GPS定位相關(guān)的服務(wù)、對(duì)象都由該對(duì)象產(chǎn)生。該類提供的常用方法見表6-1。表6-1LocationManager類的方法方法名說明addGpsStatusListener添加一個(gè)監(jiān)聽GPS狀態(tài)的監(jiān)聽器。addProximityAlert添加一個(gè)臨近警告。getAllProviders獲取所有的LocationProvider列表。getBestProvider根據(jù)制定條件返回最優(yōu)的LocationProvider對(duì)象。getGpsStatus獲取GPS狀態(tài)。getLastKnownLocation根據(jù)LocationProvider獲取最近一次已知的Location。getProvider根據(jù)名稱來獲取LocationProvider。getProviders(,)根據(jù)制定條件獲取滿足條件的全部LocationProvier的名稱。getProviders(booleanenabledOnly)獲取所有可用的LocationProvider。isProviderEnabled判斷制定名稱的LocationProvider是否可用。removeGpsStatusListener刪除GPS狀態(tài)監(jiān)聽器。removeProximityAlert刪除一個(gè)趨近警告。requestLocationUpdates該方法有一個(gè)PendingIntent參數(shù)。通過指定的LocationProvider周期性獲取定位信息，并通過Intent啟動(dòng)相應(yīng)的組件。requestLocationUpdates該方法有一個(gè)LcoationListener參數(shù)。通過指定的LocationProvider周期性的獲取定位信息，并觸發(fā)listener對(duì)應(yīng)的觸發(fā)器。（2）LocationProvider類通過該類可以獲取位置提供商的相關(guān)信息。該類提供的常用方法見表6-2。表6-2LocationProvider類的方法方法名說明getName返回該LocationProvider的名稱。getAccuracy返回該LocationProvider的精度。getPowerRequirement返回該LocationProvider的電源需求。hasMonetaryCost返回LocationProvider是收費(fèi)還是免費(fèi).meetsCriteria判斷該LocationProvider是否滿足Criteria條件。requiresCell判斷該LocationProvider是否需要訪問網(wǎng)路基站。requiresNetword判斷該LocationProvider是否需要網(wǎng)路數(shù)據(jù)。requiresStatellite判斷該LocationProvider是否需要訪問衛(wèi)星的定位系統(tǒng)。supportsAltitude判斷該LocationProvider是否支持高度信息。supportsBearing判斷該LocationProvider是否支持方向信息。supportsSpeed判斷該LocationProvider是否支持速度信息。（3）Location類通過該類可以獲取定位的相關(guān)信息。該類提供的常用方法見表6-3。表6-3Location類的方法方法名說明getAccuracy獲取定位信息的精度。getAltitude獲取定位信息的高度。getBearing獲取定位信息的方向。getLatitude獲取定位信息的經(jīng)度。getLongitude獲取定位信息的緯度。getProvider獲取提供該定位信息的LocationProvider。getSpeed獲取定位信息的速度。hasAccuracy判斷該定位信息是否有經(jīng)度信息。hasAltitude判斷定位信息是否有高度信息。hasBearing判斷定位信息是否有方向信息。hasSpeed判斷定位信息是否有速度信息。2.獲取GPS信息的步驟（1）獲取LocationManager對(duì)象通過調(diào)用Context.getSystemService()方法可以獲取實(shí)例對(duì)象；LocationManagerlocationManager=(LocationManager)getActivity().getSystemService(Context.LOCATION_SERVICE);（2）獲取LocationProviderLocationProvider通常有三個(gè)：LocationManager.PASSIVE_PROVIDER、LocationManager.GPS_PROVIDER、LocationManager.NETWORK_PROVIDER。//獲得基于GPS的LocationProviderLocationProvidergpsProvider=lm.getProvider(LocationManager.GPS_PROVIDER);（3）獲取定位信息//從GPS獲取最近的定位信息Locationlocation=lm.getLastKnownLocation(LocationManager.GPS_PROVIDER);//每1秒獲取一次GPS的定位信息locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER,1000,8,newLocationListener(){ @Override publicvoidonStatusChanged(Stringprovider,intstatus,Bundleextras){ } @Override publicvoidonProviderEnabled(Stringprovider){ } @Override publicvoidonProviderDisabled(Stringprovider){ } @Override publicvoidonLocationChanged(Locationlocation){ //GPS定位信息發(fā)生改變時(shí)，更新位置 }});3.騰訊地圖定位分為單次定位和連續(xù)定位。單次定位是指發(fā)起一次定位請(qǐng)求只返回一次定位結(jié)果。單次定位一般只會(huì)返回網(wǎng)絡(luò)定位信息，這是因?yàn)槭謾C(jī)的GPS模塊通常獲取定位信息要晚于網(wǎng)絡(luò)定位。而且單次定位不需要配置TencentLocationRequest，默認(rèn)requestLevel是REQUEST_LEVEL_NAME，且不需要主動(dòng)調(diào)用停止定位。連續(xù)定位是指發(fā)起一次定位請(qǐng)求后位置服務(wù)將按照按用戶指定周期，周期性的返回定位結(jié)果的一種定位方式。這種定位方式是最常見的一種定位方式。4.騰訊地圖實(shí)現(xiàn)定位的常用接口介紹（1）接口TencentLocationListener該接口有兩個(gè)方法，分別是onLocationChanged()和onStatusUpdate()。onLocationChanged用于接收定位結(jié)果，通過該方法的第1個(gè)參數(shù)tencentLocation能獲得位置的信息，onStatusUpdate用于接收GPS、WiFi、Cell狀態(tài)碼。（2）接口LocationSource該接口有兩個(gè)方法，分別是activate()和deactivate()。activate用于設(shè)置位置變化回調(diào)接口，deactivate用于取消位置變化回調(diào)。教學(xué)準(zhǔn)備教材，PPT、教綱、教案參考資料/mobile/androidMapSDK/developerGuide/androidSummary教學(xué)過程方法與手段教學(xué)備注【課堂導(dǎo)入】GPS定位應(yīng)用非常廣泛，隨著航天科技的飛速發(fā)展，GPS定位系統(tǒng)可實(shí)現(xiàn)的功能也越來越多，本任務(wù)我們將解決如何利用騰訊位置服務(wù)提供的API實(shí)現(xiàn)GPS定位的問題?！窘虒W(xué)實(shí)施】6.2.1任務(wù)描述通過模擬器發(fā)送經(jīng)度和維度，整合地圖服務(wù)，根據(jù)經(jīng)緯度在地圖上實(shí)現(xiàn)定位。如圖所示。6.2.2問題引導(dǎo)GPS定位應(yīng)用非常廣泛，隨著航天科技的飛速發(fā)展，GPS定位系統(tǒng)可實(shí)現(xiàn)的功能也越來越多，本任務(wù)我們將解決如何利用騰訊位置服務(wù)提供的API實(shí)現(xiàn)GPS定位的問題。6.2.3知識(shí)準(zhǔn)備Android中GPS的核心API獲取GPS信息的步驟騰訊地圖的單次定位和連續(xù)定位介紹騰訊地圖實(shí)現(xiàn)定位的常用接口介紹6.2.4實(shí)現(xiàn)騰訊地圖的連續(xù)定位。6.2.5知識(shí)拓展騰訊地圖單次定位的實(shí)現(xiàn)【知識(shí)（技能）鞏固練習(xí)】實(shí)現(xiàn)騰訊地圖的連續(xù)定位【教學(xué)小結(jié)】講授、演示課后作業(yè)與訓(xùn)練完成項(xiàng)目3課后練習(xí)對(duì)應(yīng)的習(xí)題。教學(xué)反思

課題項(xiàng)目3任務(wù)3地址解析和反向地址解析課型理論課理論課時(shí)2課時(shí)實(shí)踐課時(shí)2課時(shí)教學(xué)目標(biāo)知識(shí)目標(biāo)能力（技能）目標(biāo)1.熟悉安卓系統(tǒng)下GPS核心API。2.熟悉騰訊位置服務(wù)地圖SDK的使用能夠進(jìn)行地址解析和反向地址解析。教學(xué)重點(diǎn)地址解析和反向地址解析的實(shí)現(xiàn)方法。教學(xué)難點(diǎn)GPS核心API的靈活運(yùn)用教學(xué)內(nèi)容騰訊位置服務(wù)為地址解析和逆地址解析提供了接口。通過發(fā)送GET請(qǐng)求，返回json數(shù)據(jù)，數(shù)據(jù)中包含了經(jīng)緯度和地址的相關(guān)信息。1.地址解析（1）請(qǐng)求URL/ws/geocoder/v1/?address=您需要解析的地址&key=您申請(qǐng)的APIKey。（2）返回的json數(shù)據(jù)結(jié)構(gòu)表6-6json數(shù)據(jù)結(jié)構(gòu)表名稱類型說明statusnumber狀態(tài)碼，0為正常，其它為異常（可關(guān)注message信息）messagestring狀態(tài)說明resultobject地址解析結(jié)果titlestring解析到坐標(biāo)所用到的關(guān)鍵地址、地點(diǎn)locationstring解析到的坐標(biāo)（GCJ02坐標(biāo)系）latnumber緯度lngnumber經(jīng)度address_componentsobject解析后的地址部件provincestring省citystring市districtstring區(qū)，可能為空字串streetstring街道，可能為空字串street_numberstring門牌，可能為空字串a(chǎn)d_infoobject行政區(qū)劃信息adcode行政區(qū)劃代碼similaritynumber即將下線，由reliability代替deviationnumber即將下線，由level代替reliabilitynumber可信度參考：值范圍1<低可信>-10<高可信>

我們根據(jù)用戶輸入地址的準(zhǔn)確程度，在解析過程中，將解析結(jié)果的可信度(質(zhì)量)，由低到高，分為1-10級(jí)，該值>=7時(shí)，解析結(jié)果較為準(zhǔn)確，<7時(shí)，會(huì)存各類不可靠因素，開發(fā)者可根據(jù)自己的實(shí)際使用場(chǎng)景，對(duì)于解析質(zhì)量的實(shí)際要求，進(jìn)行參考。levelnumber解析精度級(jí)別，分為11個(gè)級(jí)別，一般>=9即可采用（定位到點(diǎn)，精度較高）也可根據(jù)實(shí)際業(yè)務(wù)需求自行調(diào)整，完整取值表見下文。2.逆地址解析（1）請(qǐng)求URL/ws/geocoder/v1/?location=緯度,經(jīng)度&key=您申請(qǐng)的APIKey&get_poi=1。（2）返回的json數(shù)據(jù)結(jié)構(gòu)表6-7json數(shù)據(jù)結(jié)構(gòu)表statusnumber狀態(tài)碼，0為正常，其它為異常（可關(guān)注message信息）messagestring狀態(tài)說明request_idstring本次請(qǐng)求的唯一標(biāo)識(shí)resultobject逆地址解析結(jié)果addressstring以行政區(qū)劃+道路+門牌號(hào)等信息組成的標(biāo)準(zhǔn)格式化地址formatted_addressesobject結(jié)合知名地點(diǎn)形成的描述性地址，更具人性化特點(diǎn)recommendstring推薦使用的地址描述，描述精確性較高roughstring粗略位置描述address_componentobject地址部件，address不滿足需求時(shí)可自行拼接nationstring國家provincestring省citystring市districtstring區(qū)，可能為空字串streetstring街道，可能為空字串street_numberstring門牌，可能為空字串a(chǎn)d_infoobject行政區(qū)劃信息nation_codestring國家代碼（ISO3166標(biāo)準(zhǔn)3位數(shù)字碼）adcodestring行政區(qū)劃代碼city_codestring城市代碼，由國家碼+行政區(qū)劃代碼（提出城市級(jí)別）組合而來，總共為9位namestring行政區(qū)劃名稱locationobject行政區(qū)劃中心點(diǎn)坐標(biāo)latnumber緯度lngnumber經(jīng)度nationstring國家provincestring省/直轄市citystring市/地級(jí)區(qū)及同級(jí)行政區(qū)劃districtstring區(qū)/縣級(jí)市及同級(jí)行政區(qū)劃address_referenceobject坐標(biāo)相對(duì)位置參考famous_areaobject知名區(qū)域，如商圈或人們普遍認(rèn)為有較高知名度的區(qū)域idstring地點(diǎn)唯一標(biāo)識(shí)titlestring名稱/標(biāo)題locationobject坐標(biāo)latnumber緯度lngnumber經(jīng)度_distancenumber此參考位置到輸入坐標(biāo)的直線距離_dir_descstring此參考位置到輸入坐標(biāo)的方位關(guān)系，如：北、南、內(nèi)business_areaobject商圈，目前與famous_area一致townobject鄉(xiāng)鎮(zhèn)街道idstring地點(diǎn)唯一標(biāo)識(shí)titlestring名稱