Google マップ KML インポート ユーティリティ

1. はじめに
2. KML レイヤを追加する
3. KML レイヤを消去する
4. KML コンテナにアクセスする
5. KML 目印と KML 地面オーバーレイにアクセスする
6. KML プロパティにアクセスする
7. KML でサポートされている機能

はじめに

KML は XML データ形式の拡張で、地図上の地理データを表します。このユーティリティを使用すると、KML オブジェクトを地理的図形に変換して、地図上にレイヤとしてレンダリングできます。地図に GeoJSON データを追加する場合は addLayerToMap() を、地図からこのデータを削除する場合は removeLayerFromMap() を呼び出します。KML オブジェクトのプロパティにアクセスするには、任意の Placemark、GroundOverlay、Document、または Folder で getProperties() を呼び出します。

地図に KML レイヤを追加する

地図にデータレイヤを追加するには、まず KmlLayer クラスのインスタンスを作成します。KmlLayer をインスタンス化するには、2 つの方法があります。

ローカル リソースから KML データセットをインポートしてレンダリングする場合は、以下のものが必要です。

• レイヤをレンダリングする GoogleMap オブジェクト。
• KML データを含むローカル リソース ファイル。
• Context オブジェクト。これはローカル リソース ファイルを開くために必要です。

KmlLayer layer = new KmlLayer(map, R.raw.geojson_file, context);

      

val layer = KmlLayer(map, R.raw.geojson_file, context)

      

ローカル ストリームから KML データセットをインポートしてレンダリングする場合は、以下のものが必要です。

• レイヤをレンダリングする GoogleMap オブジェクト。
• KML データを含む InputStream。
• Context オブジェクト。これはローカル リソースを開くために必要です。

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

KmlLayer を作成したら、addLayerToMap()() を呼び出して、インポートしたデータを地図に追加します。

layer.addLayerToMap();

      

layer.addLayerToMap()

      

KML レイヤを消去する

たとえば、次の KmlLayer を作成したとします。

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

地図からレイヤを削除するには、removeLayerFromMap() を呼び出します。

layer.removeLayerFromMap();

      

layer.removeLayerFromMap()

      

KML コンテナにアクセスする

レイヤに追加したコンテナにアクセスするには、作成したレイヤで getContainers() を呼び出します。いずれかのコンテナ内にコンテナがネストされているかどうかをチェックするには、hasContainers() を呼び出します。これらのネストされたコンテナにアクセスするには、レイヤでの操作と同様に、getContainers() を呼び出します。

KmlLayer または KmlContainer: にネストされていないコンテナにアクセスするには、以下のようにします。

for (KmlContainer containers : layer.getContainers()) {
    // Do something to container
}

      

for (containers in layer.containers) {
    // Do something to container
}

      

KmlLayer または KmlContainer にネストされているコンテナにアクセスするには、以下のようにします。

public void accessContainers(Iterable<KmlContainer> containers) {
    for (KmlContainer container : containers) {
        if (container.hasContainers()) {
            accessContainers(container.getContainers());
        }
    }
}

      

fun accessContainers(containers: Iterable<KmlContainer>) {
    for (container in containers) {
        if (container.hasContainers()) {
            accessContainers(container.containers)
        }
    }

      

KML 目印と KML 地面オーバーレイにアクセスする

レイヤに追加されている目印や地面オーバーレイにアクセスするには、レイヤまたはコンテナで getPlacemarks() または getGroundOverlays() を呼び出します。これらを呼び出すと、それぞれ KmlPlacemarks または KmlGroundOverlays の iterable が返されます。

たとえば、レイヤから KmlPlacemark オブジェクトにアクセスするには、次のようにします。

for (KmlPlacemark placemark : layer.getPlacemarks()) {
    // Do something to Placemark
}

      

for (placemark in layer.placemarks) {
    // Do something to Placemark
}

      

KML プロパティにアクセスする

コンテナまたは目印のプロパティにアクセスするには、getProperty() を呼び出して、プロパティキーを渡します。hasProperty() を呼び出して、そのプロパティが存在するかどうかをチェックすることもできます。このサンプルは、プロパティ値「name」が存在する場合に、それをコンテナから取得する方法を示しています。

for (KmlContainer container : layer.getContainers()) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"));
    }
}

      

for (container in layer.containers) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"))
    }
}

      

KML ジオメトリ クリック イベント

KmlLayer.OnFeatureClickListener() を使って、地図上のジオメトリ対象物に対するクリック イベントをリッスンできます。次の例は、ユーザーによって対象物がクリックされた際にその対象物の ID をログに記録しています。

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener(new KmlLayer.OnFeatureClickListener() {
    @Override
    public void onFeatureClick(Feature feature) {
        Log.i("KML", "Feature clicked: " + feature.getId());
    }
});

      

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener { feature ->
    Log.i(
        "KML",
        "Feature clicked: " + feature.id
    )
}

      

デモアプリを見る

KML ファイルをインポートし、それを使用してレイヤを作成する例については、ユーティリティ ライブラリに付属のデモアプリにある KmlDemoActivity をご覧ください。また、設定ガイドでは、デモアプリを実行する方法を説明しています。

KML でサポートされている機能