Google Map Android API V2 setup guide, 按圖施工保證成功

1. Google Map #1
根據Google Maps Android API
V2更新
曾吉弘
nissin@cavedu.com
1

2. 大綱
• Google Maps Android API V2
• 申請Google Map API Key
• 載入Google Map - GMap
2

3. 環境建置
Google Maps Android API V2
3

4. 步驟
1. 安裝 Google Play services SDK
2. 取得SHA1 憑證
3. Google APIs Console取得API key
4. 設定權限
5. 加入地圖
4

5. V1 / V2比一比
• V1 的專案版本一定要為GoogleAPI，V2則
免。
• V1 的地圖元件為 MapView，現已停用。
V2之後改為 Fragment
5

6. 新增專案Maps
package name需與金鑰相同
根據Google 官方文件操作
https://developers.google.com/m
aps/documentation/android/start
?hl=zh-TW
6

7. 安裝Google Play services SDK
• 請由 SDK Manager 中安裝[Google Play
services]
7

8. 匯入到Eclipse中
• FileImport
• Existing Android Code Into Workspace
– <SDK>extras/google/google_play_services
/libproject/google-play-services_lib 專案。
8

9. 勾選Is Library
• 請勾選Is Library，
否則無法從外部
專案匯入。

10. 會在畫面左側看到這個lib

11. 新增專案GMap

12. 在專案中匯入libs
• 對專案目錄點右鍵
PropertiesAn
droid
• Add libraries，請
記得不要勾選 Is
Library。Lib本身
才要勾選。
• 完成如右圖
12

13. 產生SHA1
• 在cmd下切換到 cd C:Program FilesJavajdk1.7.0_10bin
• 輸入：
– keytool -list -v -keystore C:Usersuser.androiddebug.keystore
• 以上紅字會因為不同電腦或軟體版本有所不同
• 金鑰密碼請直接按ENTER
13

14. 找到SHA1 那一行，其他不是
14

15. 自己產生debug.keystore
• C:Program FilesJava<JDK>bin>輸入：
• keytool -genkey -v -keystore <完整路徑
>debug.keystore -storepass android -alias
androiddebugkey -keypass android -dname
"CN=Android Debug,O=Android,C=US
– http://stackoverflow.com/questions/8576732/ther
e-is-no-debug-keystore-in-android-folder
• Win7 C:/Users/<帳號>/.android/
• XP  Document and Settings (路徑包含空格會造
成錯誤，可將檔案產生在其它位置)
15

16. Google API console
• https://code.google.com/apis/console/
#project:48090014903
16

17. 啟動 Google Maps Android API V2服務
17

18. API Access取得API Key
18

19. 格式：SHA1;package name
package name改成自己的專案名稱
19

20. 修改AndroidManifest.xml -1
• 在<application>元素中加入子標籤
• your_api_key請填入剛剛申請好API KEY
– <meta-data
android:name="com.google.android.maps.v2.API
_KEY"
android:value="your_api_key"/>
– <meta-data
android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_v
ersion"/>
20

21. 修改AndroidManifest.xml -2
• 加入權限
– <permission
android:name="com.example.mapdemo.p
ermission.MAPS_RECEIVE"
android:protectionLevel="signature"/>
– <uses-permission
android:name="com.example.mapdemo.p
ermission.MAPS_RECEIVE"/>
• 其中com.example.mapdemo換成自己的。
21

22. 加入其他權限
1. <uses-permission android:name="android.permission.INTERNET"/>
2. <uses-permission
android:name="android.permission.ACCESS_NETWORK_STATE"/>
3. <uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
4. <uses-permission
android:name="com.google.android.providers.gsf.permission.READ_G
SERVICES"/>
5. <uses-permission
android:name="android.permission.ACCESS_COARSE_LOCATION"/>
6. <uses-permission
android:name="android.permission.ACCESS_FINE_LOCATION"/>
• 5, 6項只有要用到定位功能時才要加入，但通常都會用到所以就加吧
22

23. Layout(fragment_main.xml)
內容要改為 fragment
<?xml version="1.0" encoding="utf-8"?>
<fragment
xmlns:android="http://schemas.android.com/apk
/res/android"
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:name="com.google.android.gms.m
aps.MapFragment"/>
以上請將layout.xml 內容全部取代掉即可，不用改東
西
23

24. 修改MainActivity.xml
public class MainActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout. fragment_main);
//只載入畫面無進一步動作
}
}

25. 載入Google Map
25

26. 除錯小提醒
1. 請確認使用 debug.keystore 來產生 SHA1
2. 記得在 AndroidManifest.xml 中加入 API
Key 、meta data與相關權限
3. 確認網路暢通
4. 有無匯入 Google Play services libraries
26

27. Package 要修改的地方

28. 如果要執行於模擬器則較麻煩
• 因為模擬器並未安裝Google Play service，所
以要另外安裝。
• 建議實機操作
• http://nkeegamedev.blogspot.tw/2012/
12/android-google-maps-api-
v2.html#uds-search-results
28

29. 載入官方example
• https://developers.google.com/maps/d
ocumentation/android/intro#sample_co
de
• 改為自己的 package name 與 API Key
29

30. Google Map Javascript V3
• https://developers.google.com/maps/documenta
tion/javascript/tutorial?hl=zh-tw
• 使用 Javascript 來取得地圖網頁
• 教學：
– http://nkeegamedev.blogspot.tw/2012/12/android-
google-map-v3-1.html
• 好用的生成器：
http://www.nap.st/google_map_generator/?lang
=zh-TW
30

31. 資料
• https://developers.google.com/maps/documentation/and
roid/start
• 原有的怎麼辦？還是可以用，但無法再取得V1 的API Key了。
• http://www.moke.tw/wordpress/computer/advanced/410
• http://nkeegamedev.blogspot.tw/2012/12/android-
google-maps-api-v2.html
• http://saleh360.blogspot.tw/2012/12/android-running-
google-maps-api-v2_12.html
• http://fecbob.pixnet.net/blog/post/38591179-google-
maps-android-api-
v2%E4%BD%BF%E7%94%A8%E5%8F%8A%E5%95%8F%E
9%A1%8C%E8%A7%A3%E6%B1%BA
31

32. 資料
• 中研院GIS中心
• http://gis.rchss.sinica.edu.tw/
• 中研院GIS中心工具集
http://gis.ascc.net/ISTIS/tools.html
• http://simonown.wordpress.com/2009/11/
22/aa0007/
• 金門大學 http://gogkmit.wikidot.com/start
• 畫出GPS路徑
http://changyy.pixnet.net/blog/post/28058
989
32

33. 資料
• 座標轉換
http://gis.thl.ncku.edu.tw/coordtrans/co
ordtrans.aspx
• 景點分享
• http://www.wikigps.com/
33

34. 補充資料：取得Google MAPs
android API V2
• http://wangshifuola.blogspot.tw/2013/01/androidgo
ogle-maps-android-api-v2.html
• http://www.moke.tw/wordpress/computer/advanced/
410
• 按部就班http://cheng-min-i-
taiwan.blogspot.tw/2013/04/google-maps-android-
api-v2-android.html
34