Google Maps Android API V2を使ってみる

Google Maps Android API v2の公式ページはこちら

では、早速使ってみます。

ターゲットはAndroid 2.3.3として、Eclipseを開発環境として使います。

手順は５つほどです。

１：Maps API SDKのインストール（Google Play servicesのライブラリをEclipseにインポート）

２：Google Play servicesライブラリのプロジェクトを作成

３：Google Maps V2を表示するアプリのプロジェクトを作成

４：MapsのAPIキー取得

５：取得したキーをプロジェクトに登録して、アプリをスマホにインストール

なお、このページのサンプルコードは、表示するための基本コードであり、初期位置などの設定はactive_main.xmlに記述しています。

MainActivityにハードコードするような場合は、こちらをご参照ください。

Google Maps Android API V2を使ってみる２

１：Maps API SDKのインストール

（Google Play servicesのライブラリをEclipseにインポート）

Eclipse起動後、メニュのWindow -> Android SDK Managerで「SDK Manager」を立ち上げます。

SDK Managerの、Tools、Android 2.3.3、Extrasにチェックをいれます。
Google Play Servicesのチェックは必須です。

installのボタンをクリック。
以上です。

２：Google Play servicesライブラリのプロジェクトを作成

メニュのFile -> New -> Projectで新しいプロジェクトを作成。

「Android Project from Existing Code」を使います。

「Root Directory」は、
“C:\Program Files\Android\android-sdk\extras\google\google_play_services\libproject\google-play-services_lib”です。

「Copy project into workspace」にチェックを入れてFinish。

Package Explorerに表示されます。

３：Google Maps V2を表示するアプリのプロジェクトを作成

メニュのFile -> New -> Projectで新しいプロジェクトを作成。

「Android Application Project」を使います。

画像の情報は例です。適当に変えてください。

Targetはとりあえず2.3.3のみに設定しています。
Themeはなしにしておきます。

以後、Nextをクリックして、最後にFinish。

新しいプロジェクトでは、Google Play Servicesのライブラリを使います。

Package Explorerに表示されたプロジェクト名を右クリックして、「Properties」を選択。

「is Library」にチェックが入っていないのを確認して「Add」をクリック。

「google-play-services_lib」を選んで、OK。

Google Maps v2を表示するため、３つのファイルをいじります。

○MainActivity.java

○AndroidManifest.xml

○activity_main.xml

MainActivity.java

<span class="keyword">import</span> android.os.Bundle;
<span class="keyword">import</span> android.support.v4.app.FragmentActivity;
<span class="keyword">import</span> android.view.Menu;

<span class="keyword">public</span> <span class="keyword">class</span> MainActivity <span class="keyword">extends</span> FragmentActivity {

    @Override
    <span class="keyword">protected</span> <span class="keyword">void</span> onCreate(Bundle savedInstanceState) {
        <span class="keyword">super</span>.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    <span class="keyword">public</span> <span class="keyword">boolean</span> onCreateOptionsMenu(Menu menu) {
        <span class="rem">// Inflate the menu; this adds items to the action bar if it is present.</span>
        getMenuInflater().inflate(R.menu.activity_main, menu);
        <span class="keyword">return</span> true;
    }

}

import android.os.Bundle;

import android.support.v4.app.FragmentActivity;

import android.view.Menu;

public class MainActivity extends FragmentActivity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

}

@Override

public boolean onCreateOptionsMenu(Menu menu) {

// Inflate the menu; this adds items to the action bar if it is present.

getMenuInflater().inflate(R.menu.activity_main, menu);

return true;

}

AndroidManifest.xml

下のコードで、「APIキー」と書かれている部分は、後で修正します。

xxxxxの部分は、ご自分のパッケージ名で置き換えてください。

<span class="tag">&lt;?xml version="1.0" encoding="utf-8"?&gt;</span>
<span class="tag">&lt;manifest <span class="attr">xmlns:android=</span><span class="value">"http://schemas.android.com/apk/res/android"</span>
    <span class="attr">package=</span><span class="value">"<span style="color: #ff0000;">xxxxx</span>"</span>
    <span class="attr">android:versionCode=</span><span class="value">"1"</span>
    <span class="attr">android:versionName=</span><span class="value">"1.0"</span> &gt;</span>

    <span class="tag">&lt;uses-sdk
        <span class="attr">android:minSdkVersion=</span><span class="value">"10"</span>
        <span class="attr">android:targetSdkVersion=</span><span class="value">"10"</span> /&gt;</span>
    
    
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"android.permission.INTERNET"</span> /&gt;</span>
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"android.permission.WRITE_EXTERNAL_STORAGE"</span> /&gt;</span>
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"android.permission.ACCESS_COARSE_LOCATION"</span> /&gt;</span>
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"android.permission.ACCESS_FINE_LOCATION"</span> /&gt;</span>
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"<span style="color: #ff0000;">xxxxx</span>.permission.MAPS_RECEIVE"</span> /&gt;</span>
    <span class="tag">&lt;uses-permission <span class="attr">android:name=</span><span class="value">"com.google.android.providers.gsf.permission.READ_GSERVICES"</span> /&gt;</span>
   
    <span class="tag">&lt;uses-feature
        <span class="attr">android:glEsVersion=</span><span class="value">"0x00020000"</span>
        <span class="attr">android:required=</span><span class="value">"true"</span> /&gt;</span>
    
    
    
    <span class="tag">&lt;application
        <span class="attr">android:allowBackup=</span><span class="value">"true"</span>
        <span class="attr">android:icon=</span><span class="value">"@drawable/ic_launcher"</span>
        <span class="attr">android:label=</span><span class="value">"@string/app_name"</span>
        <span class="attr">android:theme=</span><span class="value">"@style/AppTheme"</span> &gt;</span>
        
        <span class="tag">&lt;meta-data
            <span class="attr">android:name=</span><span class="value">"com.google.android.maps.v2.API_KEY"</span>
            <span class="attr">android:value=</span><span class="value">"<span style="color: #ff0000;">APIキー</span>"</span> /&gt;</span>
        <span class="tag">&lt;activity
        	<span class="attr">android:name=</span><span class="value">"<span style="color: #ff0000;">xxxxx</span>.MainActivity"</span>
            <span class="attr">android:screenOrientation=</span><span class="value">"portrait"</span>
            
            <span class="attr">android:label=</span><span class="value">"@string/app_name"</span> &gt;</span>
            <span class="tag">&lt;intent-filter&gt;</span>
                <span class="tag">&lt;action <span class="attr">android:name=</span><span class="value">"android.intent.action.MAIN"</span> /&gt;</span>

                <span class="tag">&lt;category <span class="attr">android:name=</span><span class="value">"android.intent.category.LAUNCHER"</span> /&gt;</span>
            <span class="tag">&lt;/intent-filter&gt;</span>
        <span class="tag">&lt;/activity&gt;</span>
    <span class="tag">&lt;/application&gt;</span>

<span class="tag">&lt;/manifest&gt;</span>

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

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

package="xxxxx"

android:versionCode="1"

android:versionName="1.0" >

<uses-sdk

android:minSdkVersion="10"

android:targetSdkVersion="10" />

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

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

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

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

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

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

<uses-feature

android:glEsVersion="0x00020000"

android:required="true" />

<application

android:allowBackup="true"

android:icon="@drawable/ic_launcher"

android:label="@string/app_name"

android:theme="@style/AppTheme" >

<meta-data

android:name="com.google.android.maps.v2.API_KEY"

android:value="APIキー" />

<activity

android:name="xxxxx.MainActivity"

android:screenOrientation="portrait"

android:label="@string/app_name" >

<intent-filter>

</intent-filter>

</activity>

</application>

</manifest>

activity_main.xml

map:cameraTargetLatとmap:cameraTargetLngはMapsの初期位置です。
map:cameraTiltは、数字が大きくなると、目線が下がったアングルで見るので立体感が増します。

<span class="tag">&lt;LinearLayout <span class="attr">xmlns:android=</span><span class="value">"http://schemas.android.com/apk/res/android"</span>
    <span class="attr">xmlns:map=</span><span class="value">"http://schemas.android.com/apk/res-auto"</span>
    <span class="attr">android:layout_width=</span><span class="value">"match_parent"</span>
    <span class="attr">android:layout_height=</span><span class="value">"match_parent"</span>
    <span class="attr">android:background=</span><span class="value">"#EDEDED"</span>
    <span class="attr">android:orientation=</span><span class="value">"vertical"</span> &gt;</span>
    <span class="tag">&lt;fragment
        <span class="attr">android:id=</span><span class="value">"@+id/map"</span>
        <span class="attr">android:layout_width=</span><span class="value">"match_parent"</span>
        <span class="attr">android:layout_height=</span><span class="value">"0dp"</span>
        <span class="attr">android:layout_margin=</span><span class="value">"4dp"</span>
        <span class="attr">android:layout_weight=</span><span class="value">"1"</span>
        <span class="attr">class=</span><span class="value">"com.google.android.gms.maps.SupportMapFragment"</span>
        <span class="attr">map:cameraTargetLat=</span><span class="value">"34.68649042051079"</span>
        <span class="attr">map:cameraTargetLng=</span><span class="value">"135.51943183877566"</span>
        <span class="attr">map:cameraTilt=</span><span class="value">"70"</span>
        <span class="attr">map:cameraZoom=</span><span class="value">"18"</span> /&gt;</span>
<span class="tag">&lt;/LinearLayout&gt;</span>

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

xmlns:map="http://schemas.android.com/apk/res-auto"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:background="#EDEDED"

android:orientation="vertical" >

<fragment

android:id="@+id/map"

android:layout_width="match_parent"

android:layout_height="0dp"

android:layout_margin="4dp"

android:layout_weight="1"

class="com.google.android.gms.maps.SupportMapFragment"

map:cameraTargetLat="34.68649042051079"

map:cameraTargetLng="135.51943183877566"

map:cameraTilt="70"

map:cameraZoom="18" />

</LinearLayout>

注意
Google Play Servicesのライブラリで不具合がおこることがあります。
こんな感じで、プロジェクトとして認識されない現象です。

この場合は、SDK Managerを起動して、「Google Play Services」を一度削除して、再インストールしてください。

以上です。

４：MapsのAPIキー取得

MapsのAPIキーには２種類あります。デバッグ用と本番用です。

MapsのAPIキーを取得するには、デバッグ用の場合は２ステップ、本番用の場合は３ステップふみます。

１：キーストア（証明書）作成

デバッグ用は既存のものを使うのでこのステップはいりませんが、本番用の場合は作成する必要があります。

[デバッグ]

キーストアは以下の場所にあります。

“C:\Documents and Settings\＜ユーザー名＞\.android\debug.keystore”

[本番]

以下のような情報を準備しておきます。exampleの部分は適当に修正。

●格納場所：どこでもいいです、適当な場所にフォルダーを作成
●証明書のファイル名：example1.keystore
●別名（エイリアス）：example2key
●キーストアのパスワード：example3
●姓名：example4
●組織単位名：example5
●組織名：example6.com
●都市名または地域名：tokyo
●州名または地方名：tokyo
●国番号：jp

キーストアの作成にはkeytool.exeを使います。javaのインストールフォルダー内にあります。

例：”C:\Program Files\Java\jre7\bin”

DOS窓を開いて、binフォルダーに移動して以下のコマンドを実行。

keytool -genkey -v -keyalg RSA -keystore ＜格納場所＞\＜証明書のファイル名＞ -alias ＜エイリアス＞ -validity 10000

２：フィンガープリントの取得

v1ではMD5のものを使っていましたが、v2ではSHA1を使います。

フィンガープリントの取得にもkeytool.exeを使います。

keytool -list -v -keystore ＜キーストアの格納場所＞

３：MapsのAPIキーの取得

v1ではひとつですみましたが、v2ではプロジェクトごとに取得します。

キー取得ページ

v1の場合