（6）Xamarin.android google map v2

原文 Xamarin.android google map v2

Google Map v1已经在2013年的3月开始停止支持了,目前若要在你的Android手机上使用到Google Map,就必须要使用到Google Map v2的版本.在Xamarin要使用Google Map v2之前,必需要做的动作有下列几项：

1. 从你计算机里的keystore里面查询个人的指纹凭证(SHA1)。
2. 用SHA1指纹凭证到Google APIs网站申请key。
3. 在Xamarin里的Android SDK Manager去安装Google Play services。
4. 在Xamarin.Android项目中加入Google Play Services component。
   （原生的Android项目必须在这一步骤加入google-play-services_lib的Library。）
5. 新建一个项目并且在AndroidManifest加入相关的权限设定。
6. 在layout 画面的Main.axml 中加入地图控件

总结上述的步骤,在Android里面要使用Map这样的功能时,并不像IOS一样,只要拖拉一个MapView到你的Layout View就可以.所需要的步骤比较繁琐.这些步骤又可以被我们分为两大部份.要使用Google Map在你的装置上

1. 首先你要先上Google APIs网站上去开启与Google Map相关的服务.
2. 接着才到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

2.1前往Google APIS网站去建立你的Google API( https://code.google.com/apis/console/ )

按下画面中的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. 这边有两个方式来绑定：

1. 使用 Google Play Services component
2. 手动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 地图控件 ，新增完成会看到底下的画面

<?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"
class="com.google.android.gms.maps.MapFragment" />

5.4 编译执行项目，可以看到MapFragment画面中地图被下载回来. 
注：要看到地图被加载，你的Android仿真器必须是要有支持Google Play service的版本。若是仿真器本身如果没有 支持Google Play service，那你的地图会无法显示.

 

参考信息

• Obtaining a Google Maps API Key
  http://docs.xamarin.com/guides/android/platform_features/maps_and_location/obtaining_a_google_maps_api_key
• Maps API
  http://docs.xamarin.com/guides/android/platform_features/maps_and_location/part_2_-_maps_api
• Google Maps Android API v2
  https://developers.google.com/maps/documentation/android/