地図/位置情報/GPSを使うAndroidアプリを作るには：Androidで動く携帯Javaアプリ作成入門（16）（2/3 ページ）

[緒方聡，株式会社イーフロー] PC用表示関連情報

LINE

Hatena

前のページへ | 次のページへ

Android Mapsを使った地図の表示

　まずは、地図を表示してみましょう。Android Mapsを使用するうえで必要な手順は、以下の通りです。

ADTのProject Build TargetをGoogle APIsにする

　Android MapsはGoogleの拡張APIなので、ターゲットはGoogle APIsに設定する必要があります。

図2　Project Build Target

　今回は、最新のAndroid 2.1を使用していますが、Android MapsはAPI Level 4なので、少なくともAndroid 1.6以上を指定する必要があります。

AndroidManifest.xmlの設定

　AndroidManifest.xmlには以下、4つの設定が必要です。

<?xml version="1.0" encoding="utf-8"?>
<manifest ...>
  <application ...>
    <uses-library android:name="com.google.android.maps" /><!-- 【1】 -->
  </application>
  <uses-permission android:name="android.permission.INTERNET" /><!-- 【2】 -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/><!-- 【3】 -->
  <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION"/><!-- 【4】 -->
</manifest>

Android Mapsのライブラリを使用する宣言
インターネットアクセスを行うパーミッション
実機でロケーションサービスを使用するためのパーミッション
エミュレータでロケーション（位置情報）サービスを使用するためのパーミッション

　上記の【3】【4】は、厳密にはAndroid Mapsではなく、今回Android Mapsと組み合わせて使用したロケーションサービスのための設定ですが、組み合わせて使用することが多いと思いますので、紹介しておきます。

Android Maps API Keyの埋め込み

　あらかじめ取得しておいたAndroid Maps API Keyをアプリに埋め込みます。今回は複数のActivityで使いまわすので、strings.xmlに埋め込んであります。

MapActivityを継承

　Android Mapsを使用するためには通常のActivityではなくMapActivityクラスを継承する必要があります。

　MapActivityは抽象メソッドが1つ定義されていて、それを実装しなければなりません。


メソッド	処理概要
abstract boolean isRouteDisplayed()	ルート情報を表示しているならtrueを返す
boolean isLocationDisplayed()	位置情報を表示しているならtrueを返す
表2　MapActivityのメソッド

　上記表はMapActivityに定義されているメソッドです。1つは抽象メソッドなので、必ず実装しなければなりません。ルート情報の詳細について調べてみましたが、Javadocの以下の説明以上の情報がありません。

For accounting purposes, the server needs to know whether or not you are currently displaying any kind of route information, such as a set of driving directions. Subclasses must implement this method to truthfully report this information, or be in violation of our terms of use. TODO: provide link

　ルート情報は例えば走行方向などなのですが、Android Mapsには走行方向が分かる機能が用意されているわけではなく、こうしたルート情報は自前で実装し、それを表示しているかどうかを返す、ということのようです。後述する「Google Maps Navigation」向けの機能のようにも思えます。

　説明の最後のTODOで「リンクを貼る」と書かれているので、Javadocが更新されれば詳細が分かるかもしれません。

　位置情報は、後述するMyLocationOverlayを使用して表示する場合は、自動的に適切な値が返されるように実装されていますが、独自の位置情報表示を行っている場合、メソッドをオーバーライドして適切な値を返す必要があります。

MapViewの作成

　MapViewの作成方法は、XMLでレイアウトを定義する方法と、Javaでコーディングする方法があります。

<?xml version="1.0" encoding="utf-8"?>
<com.google.android.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:apiKey="@string/map_key" />

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.map);
}

　上記はレイアウトをXMLで定義し、Javaからレイアウトを読み出す方法です。

　以下はJavaでコーディングを行う例です。

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    MapView mapView = new MapView(this,
        getResources().getString(R.string.map_key));
    setContentView(mapView);
}

　今回のほとんどのサンプルは簡単のためJavaでコーディングを行う方法を採用しています。

　実行すると、以下のように地図が表示されます。

図3　地図の表示

地図のさまざまな設定／表示と操作

　Android Mapsには、簡単で効果的な設定がいくつか存在します。

図4　左より交通量表示、ストリートビュー表示、衛星写真切り替え


メソッド	説明
setTraffic(boolean)/isTraffic()	交通量を表示／表示しているかどうかを取得
setStreetView(boolean)/isStreetView()	ストリートビューを表示／表示しているかどうかを取得
setSatellite(boolean)/isSatellite()	衛星写真で表示／表示しているかどうかを取得
表3　MapViewの表示切り替えメソッド