（6）Xamarin.android google map v2

Google Map v1已經在2013年的3月開始停止支援了,目前若要在你的Android手機上使用到Google Map,就必須要使用到Google Map v2的版本.在Xamarin要使用Google Map v2之前,必需要做的動作有下列幾項：

從你計算機裡的keystore裡面查詢個人的指紋憑證(SHA1)。

用SHA1指紋憑證到Google APIs網站申請key。

在Xamarin裡的Android SDK Manager去安裝Google Play services。

在Xamarin.Android項目中加入Google Play Services component。

（原生的Android項目必須在這一步驟加入google-play-services_lib的Library。）

建立一個項目并且在AndroidManifest加入相關的權限設定。

在layout 畫面的Main.axml 中加入地圖控件

總結上述的步驟,在Android裡面要使用Map這樣的功能時,并不像IOS一樣,隻要拖拉一個MapView到你的Layout View就可以.所需要的步驟比較繁瑣.這些步驟又可以被我們分為兩大部份.要使用Google Map在你的裝置上

首先你要先上Google APIs網站上去開啟與Google Map相關的服務.

接着才到Xamarin.Android項目中進行所有需要的設定修改.

接下來我們就開始如何在Xamarin.Android項目裡使用Google map的相關設定:

1. 取得你的SHA1指紋憑證

1.1在Xamarin環境中，當我們裝好Xamarin.android後，我們要在底下的路徑去取得你的SHA1指紋憑證。

指紋憑證被放置在debug.keystore裡面,在Windows與OSX的存放路徑不一樣，請參考下列路徑：

Windows - C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore OSX - /Users/[USERNAME]/.local/share/Xamarin/Mono for Android/debug.keystore

1.2 開啟終端機視窗,你可以直接輸入底下指令來取得你的SHA1指紋憑證. 在[USERNAME]的部分必須要改成你的使用者名稱。

keytool -list -v -keystore /Users/[USERNAME]/.local/share/

Xamarin/Mono\ for\ Android/ 

debug.keystore -alias androiddebugkey -storepass android -keypass android

指令執行成功後可以看到如下圖的資訊，其中SHA1算法後面有一串16進位的數值。這就你個人的指紋憑證，這部分是我們稍後在Google APIs網站上建立API Key會需要用到。

2. 建立你的Google API Project

按下畫面中的Create Project 按鈕來建立一個Google API Project

2.2 建立好Google Project後，按下左邊的Service的标簽，接着在網頁中間會秀出所有的Service.

2.3 拖動下拉Bar，找到Google Map Android API v2 的Service，把這個Service的Switch控件打開成ON.請參考下圖：

到這邊，我們就建立好Google project 與 Google Map Android API v2 服務.接下來我們來看看要如何建立一個API鑰匙，這個鑰匙是當Xamarin.Anaroid要去取用Google Service API時要被用來驗證的Key.

3. 建立你的API鑰匙

接下來這個步驟我們要建立Xamarin.Anaroid要去取用Google Service API時要被用來驗證的Key.

3.1 按下左邊API Access的标簽.

3.2 再接下來的畫面中點選Create new Android Key來建立相對應的鑰匙

3.3 在建立鑰匙的時候會需要剛剛在debug.keystore 裡面的SHA1算法指紋憑證.

3.4 從計算機中複制你的SHA1算法，貼到Configure Android Key for Xamarin Google Map API Android v2 視窗裡面。在你的SHA1指紋憑證後打上一個分号「;」接着輸入你應用程式的package name. 新增完成後按下确定。

注：你的應用程式package name 是來自你在建立Android時，在AndroidManifest.xml檔案裡面所輸入的 package name.這部分兩邊的設定若是不一樣，或導緻你的地圖無法顯示.

在上述程式代碼中，我們透過Intent的GetStringExtra(“參數名稱”)來取得字元串型别的參數。事實上還可以透過類似的方法取得不同型别的參數值。如下圖所示：

3.5 這時可以看到被我們新增出來的Android API Key.到目前為止在Google APIs上的設定已經完成，接下來的就是要到Xamarin裡頭去建立使用Google map的Android App.

4. 建立使用Google Map 的Android Application

4.1 開啟Xamarin，建立一個Android Application方案

4.2 開啟Android SDK Manager 下載下傳安裝Google play Service.

4.3 Binding Google Play Services 

安裝好Google Play Services後，接下來要在Xamarin.Android項目裡面Binding Java binding library. 這邊有兩個方式來綁定：

使用 Google Play Services component

手動bind the Google Play Services client library，這個方法比較類似在eclipse中開發使用Google Map的方式

Google Play Services component是Xamarin幫我們簡化的Binding Java binding library所需要做的步驟，隻要引用這個元件，就可以很輕松的Binding Java binding library.是以在這部分我們選擇使用Google Play Services component.

4.4 新增Google Play Services 元件 

展開你的Android Map項目，在Components檔案夾按下滑鼠右鍵，在彈出的視窗上點選 Get More Components…

4.5 搜尋并下載下傳安裝Google Play Services.

5. 設定Android Application項目

5.1 修改AndroidManifest.xml檔案需要的權限 

開啟專案中的AndroidManifest.xml檔案，新增下方的Xaml檔案權限。

在 package="com.xamarin.docs.android.mapsandlocationdemo2"與 <permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" android:protectionLevel="signature" /> 

這兩個地方要将package name修改成你的Package name.

5.2 接着修改在<meta-data android:name="com.google.android.maps.v2.API_KEY"android:value="YOUR_API_KEY" />

标簽裡面Key值.這個Key是剛剛在Google APIs裡面建立的API Key。完整的修改請參照下方Xml檔案：

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android" android:versionName="4.5"package="com.xamarin.docs.android.mapsandlocationdemo2" android:versionCode="6">

<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="17" />

<!-- Google Maps for Android v2 requires OpenGL ES v2 -->

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

<!-- We need to be able to download map tiles and access Google Play Services-->

<uses-permission android:name="android.permission.INTERNET" />

<!-- Allow the application to access Google web-based services. -->

<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />

<!-- Google Maps for Android v2 will cache map tiles on external storage -->

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- Google Maps for Android v2 needs this permission so that it may check the connection 

state as it must download data -->

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- Permission to receive remote notifications from Google Play Services -->

<!-- Notice here that we have the package name of our application as a prefix on the permissions. -->

<uses-permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" />

<permission android:name="<PACKAGE NAME>.permission.MAPS_RECEIVE" android:protectionLevel="signature" />

<!-- These are optional， but recommended. They will allow Maps to use the My Location provider. -->

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<uses-permission >android:name="android.permission.ACCESS_FINE_LOCATION" />

<application android:label="@string/app_name">

<!-- Put your Google Maps V2 API Key here. -->

<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_API_KEY" />

</application>

</manifest>

5.3 新增一個MapFragment 地圖控件 ，新增完成會看到底下的畫面

<fragment xmlns:android="http://schemas.android.com/apk/res/android"

android:id="@+id/map"

android:layout_width="match_parent"

android:layout_height="match_parent"

class="com.google.android.gms.maps.MapFragment" />

5.4 編譯執行項目，可以看到MapFragment畫面中地圖被下載下傳回來. 

注：要看到地圖被加載，你的Android仿真器必須是要有支援Google Play service的版本。若是仿真器本身如果沒有 支援Google Play service，那你的地圖會無法顯示.

參考資訊

Obtaining a Google Maps API Key

<a href="http://docs.xamarin.com/guides/android/platform_features/maps_and_location/obtaining_a_google_maps_api_key">http://docs.xamarin.com/guides/android/platform_features/maps_and_location/obtaining_a_google_maps_api_key</a>

Maps API

<a href="http://docs.xamarin.com/guides/android/platform_features/maps_and_location/part_2_-_maps_api">http://docs.xamarin.com/guides/android/platform_features/maps_and_location/part_2_-_maps_api</a>

Google Maps Android API v2

<a href="https://developers.google.com/maps/documentation/android/">https://developers.google.com/maps/documentation/android/</a>