Androidアプリに Google Maps を組み込むには： Google Maps Android APIの導入について


自作のAndroidアプリにGoogle Mapを入れてみたいケースは多いと思います。その場合はGoogle Maps Android APIを使います。

結論から先に言うと、Googel Maps APIを使うためにはアプリを認証してAPIキーを取得する必要があります。

この記事では、サンプルアプリを使って、取得したAPIキーを使って、アプリ内でAPIを実行するところについてを説明します。全体の手順は以下の通り。

1. Androidアプリをダウンロード
2. Google Developersのページへ行く。
3. Google Developers Console で作業し、アプリを認証してAPIキーを取得。
4. Android Studioでxmlファイルを修正し、実行

では、始めます。


##１、Androidアプリをダウンロード
Google Maps Android APIを使っているサンプルアプリなら何でも良いのだが、ここでは下記のサンプルを使用する。RecyclerViewを使って、各CardViewに地図を表示している。
https://github.com/saxman/android-map_list.git


###サンプルアプリのダウンロード
ターミナルで下記コマンドを入力

```Bash
git clone https://github.com/saxman/android-map_list.git
```

###サンプルアプリの起動
Android Studioを起動して、上記プロジェクトを開いて実行してみる。しかし、このまま実行しても、アプリは起動するが地図が表示されないはず。なぜなら自分のAPIキーを取得する必要があるため。

以下、APIキーの取得方法について説明するが、その前にパッケージ名を確認しておく(後で必要になるため)。上記サンプルアプリの場合、com.example.google.maplistになっているはず。
![スクリーンショット 2016-05-08 10.52.27.png](https://qiita-image-store.s3.amazonaws.com/0/64560/fe9fd4b9-2744-d938-22e4-b10c356fa162.png "スクリーンショット 2016-05-08 10.52.27.png")


##２、Google Developersのページへ行く。
https://developers.google.com/maps/documentation/android-api/
キーを取得ボタンを押して、「続ける」をクリック。
![スクリーンショット 2016-05-08 11.21.37.png](https://qiita-image-store.s3.amazonaws.com/0/64560/2766a6fb-788a-18fb-5227-eaf4f884d395.png "スクリーンショット 2016-05-08 11.21.37.png")

##３、Google Developers Console で次の作業を行う

###新しいプロジェクトを作成
Google Maps Android API を有効するアプリケーションを登録するため、新しいプロジェクトを作成する。そのまま「作成」ボタンをクリック。
![スクリーンショット 2016-05-08 10.27.43.png](https://qiita-image-store.s3.amazonaws.com/0/64560/efa12873-d8e9-e0a3-0435-1e04cec56e66.png "スクリーンショット 2016-05-08 10.27.43.png")

###認証情報：Android APIキーの生成
**名前**は何でも良い。後から分かりやすいようにアプリ名などの名前を入れれば良い。
![スクリーンショット 2016-05-08 10.33.09.png](https://qiita-image-store.s3.amazonaws.com/0/64560/48ed8252-4e0e-62e0-9025-07da763908c9.png "スクリーンショット 2016-05-08 10.33.09.png")


###フィンガープリント取得
ターミナルで下記のコマンドを実行し、フィンガープリントを取得する。

```Bash
keytool -keystore ~/.android/debug.keystore -list -v
```

なお、「パスワードを入力してください：」と出るが、そのままEnterすれば良い。
SHA1のフィンガープリントをコピーしておく※フィンガープリントの内容は伏せている
![スクリーンショット 2016-05-08 10.44.27.png](https://qiita-image-store.s3.amazonaws.com/0/64560/5ed57c53-b00c-450a-b2af-253f307c562c.png "スクリーンショット 2016-05-08 10.44.27.png")


###フィンガープリントの入力
＋パッケージ名とフィンガープリントを追加　のボタンをクリックすると入力欄が開くので、
SHA-1 証明書のフィンガープリント欄にペーストする
![スクリーンショット 2016-05-08 10.41.19.png](https://qiita-image-store.s3.amazonaws.com/0/64560/0246935f-958d-a39a-ccb7-8280f8180e7c.png "スクリーンショット 2016-05-08 10.41.19.png")

###パッケージ名の入力
Androidアプリのパッケージ名を入力欄に入力
ここでは、先ほどGit cloneしたサンプルアプリの com.example.google.maplist となる。
※フィンガープリントの内容は伏せている
![スクリーンショット 2016-05-08 10.52.53.png](https://qiita-image-store.s3.amazonaws.com/0/64560/8999a9a8-871c-c44f-9eac-72c86c62d5d6.png "スクリーンショット 2016-05-08 10.52.53.png")

###APIキーの生成
作成ボタンを押すと、APIキーが生成されるので、コピーしておく。※キーの内容は伏せている
![スクリーンショット 2016-05-08 10.53.15.png](https://qiita-image-store.s3.amazonaws.com/0/64560/7d1dd7a3-896e-7522-05df-bd108cc8f31a.png "スクリーンショット 2016-05-08 10.53.15.png")

##4、Android Studioでxmlファイルを修正し、実行

###APIキーの入力
res > values 内の strings.xml (1) を開き、”google_maps_key” (2) の部分にAPIキーをペースト
![スクリーンショット 2016-05-08 10.53.58.png](https://qiita-image-store.s3.amazonaws.com/0/64560/0b1d1cee-e36c-df4b-02a7-b9239a82cf03.png "スクリーンショット 2016-05-08 10.53.58.png")

###実行する
Google Mapが表示される。Have fun!
![スクリーンショット 2016-05-08 11.15.39.png](https://qiita-image-store.s3.amazonaws.com/0/64560/89a65dcd-12f8-8da4-4eae-315085f2a620.png "スクリーンショット 2016-05-08 11.15.39.png")


以上