Android--Google Map API V2使用

標籤：android   des   style   blog   class   code   

一、擷取API Key

1、先擷取SHA-1 fingerprint

數位憑證是有兩種，一種是debug，還有release。前者只能用於測試；後者才可以用於實際產品。

debug：在命令列中輸入命令：keytool -list -v -keystore "C:\Users\your_user_name\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

release：替換籤名檔案路徑；替換密碼即可

SHA-1 fingerprint也可以在Eclipse中擷取，

2、登入網站擷取API Key

網址：https://code.google.com/apis/console/ 用Gmail的賬戶登入，如果是第一次的話，需要建立項目，預設情況會建立一個叫做API Project的項目。

點擊左邊的Services，會在中間看到很多的APIs和Services，找到Google Maps Android API v2，然後把它設定成on，需要接受一些服務條款。

在左邊的導航條中選擇API Access。在出來的頁面中選擇Create New Android Key...就可以產生key了：

3、建立項目

AndroidManifest.xml中聲明許可權

<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/><uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/><!-- The following two permissions are not required to use     Google Maps Android API v2, but are recommended. --><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

聲明api key

<!-- Google Map Key --><meta-data       android:name="com.google.android.maps.v2.API_KEY"       android:value="前面申請的key" /><meta-data       android:name="com.google.android.gms.version"       android:value="4030500" />

由於google maps v2需要opengl es v2的支援，所以必須在androidmanifest.xml裡添加以下元素

<uses-feature        android:glEsVersion="0x00020000"        android:required="true"/>

匯入google-play-services.jar

載入map要用到SupportMapFragment

SupportMapFragment fragment = SupportMapFragment.newInstance();getSupportFragmentManager().beginTransaction().add(R.id.ll_map, fragment).commit();

4、委任標記物Marker

預設的Marker

private GoogleMap mMap;mMap = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();mMap.addMarker(new MarkerOptions()        .position(new LatLng(0, 0))        .title("Hello world"));

自訂Marker

private static final LatLng MELBOURNE = new LatLng(-37.81319, 144.96298);private Marker melbourne = mMap.addMarker(new MarkerOptions()                            .position(MELBOURNE)                            .title("Melbourne")                            .snippet("Population: 4,137,400")                            .icon(BitmapDescriptorFactory.fromResource(R.drawable.arrow)));

自訂Marker時使用了BitmapDescriptorFactory建立一個自訂的Marker表徵圖，在使用BitmapDescriptorFactory之前先看看先看看它的文檔，使用這個類的任何方法之前，你必須做下列操作之一，以確保這個類被初始化：1：從MapFragment或者MapView中添加一個GoogleMap，你可以通過調用GoogleMap.getMap()方法，判斷返回是否為空白。2：調用  MapsInitializer.initialize(Context)方法，只要不拋出com.google.android.gms.common.GooglePlayServicesNotAvailableException GooglePlayServicesNotAvailableException這個異常就可以正常起始化。

      還有Marker的點擊事件，GoogleMap.setOnMarkerClickListener(); Marker的拖動事件，GoogleMap.setOnMarkerDragListener();（Marker預設是不能拖動的，建立Marker時設定melbourne.setDraggable(true)為可拖動）

      點擊 Marker時會預設彈出資訊視窗Info Windows，你可以使用InfoWindowAdapter介面，調用GoogleMap.setInfoWindowAdapter()去自訂Info Windows，InfoWindowAdapter要實現兩個方法 getInfoWindow(Marker)和getInfoContents(Marker)。api會先調用getInfoWindow(Marker)方法，如果返回null，再繼續調用getInfoContents(Marker)方法，如果繼續返回null，api將調用預設的info windows。info windows跟marker一樣具有點擊事件GoogleMap.setOnInfoWindowClickListener()。