地図項目を追加します

HERE SDK を使用すると、地図ポリラインやマーカーなど、複数の種類のアイテムを地図に追加できます。 詳細については、以下のセクションで説明します。 現在、次の地図アイテムがサポートされています。

• 地図ポリライン： 移動できないレンダリングされた直線。
• 地図の矢印 : 地図上に矢印のアイコンを表示する便利な方法です。
• ポリゴンのマップ : 移動できないレンダリングされたシェイプです。
• 地図の円 : ジオポリゴンとして定義できる、移動できないレンダリングされた円。
• 地図のマーカー : 地図上の「マーク」固有のスポットに固定できる画像。
• マップ マーカークラスタリング : ズーム レベルに依存してクラスタ化できるマップマーカーのグループ。
• 組み込み POI: 公共交通機関、レストラン、 ATM 、その他の施設など、あらかじめ設定された選択可能な POI オブジェクトおよび埋め込みの Carto POIs が地図上に表示されます。
• 地図マーカー 3D ： 指定した地理座標でマップ上にレンダリングされた 3D シェイプ。
• 地図上の地図のマーカー : 地図と一緒に回転および傾斜する地図の平面マーカー。
• 地図 上の現在のデバイスの場所を示す位置情報インジケータの定義済みアセット。
• マップ ビューピン : ネイティブの Android View レイアウトを地図に表示する便利な方法です。

ポリライン、ポリゴン、および円は現在のズーム レベルに基づいてサイズを調整しますが、マーカーはズームしても変更されません。

すべての地図アイテムを使用 すると、地図から簡単に選択できます。

地図ポリラインを追加します

ポリラインは、マップ上のルートジオメトリなどをレンダリングする場合に便利です。 次のように作成できます。

private MapPolyline createPolyline() {
    ArrayList<GeoCoordinates> coordinates = new ArrayList<>();
    coordinates.add(new GeoCoordinates(52.53032, 13.37409));
    coordinates.add(new GeoCoordinates(52.5309, 13.3946));
    coordinates.add(new GeoCoordinates(52.53894, 13.39194));
    coordinates.add(new GeoCoordinates(52.54014, 13.37958));

    GeoPolyline geoPolyline;
    try {
        geoPolyline = new GeoPolyline(coordinates);
    } catch (InstantiationErrorException e) {
        // Thrown when less than two vertices.
        return null;
    }

    float widthInPixels = 20;
    Color lineColor = Color.valueOf(0, 0.56f, 0.54f, 0.63f)); // RGBA
    MapPolyline mapPolyline = new MapPolyline(geoPolyline, widthInPixels, lineColor);

    return mapPolyline;
}

は MapPolyline 、次の 3 つの要素で構成されて

• 地図上でポリラインを配置する場所を定義する 2 つ以上の地理座標のリスト。
• GeoPolyline この座標のリストを含む。
• DashPatternやLineCapなどのスタイルパラメーターを使用して、ポリラインの表示方法を定義します。

形状直線は 2 つ以上の点で定義されているため、ArrayListを作成する必要があります。これには、少なくとも 2 つのGeoCoordinates点が含まれている必要があります。 それ以外の場合は、例外がスローされます。 線の外観を変更するには、線の太さをピクセル単位および色単位で設定します。 スクリーンショットの例については、を参照してください。

1 つ以上のマップポリラインを作成した後、次のものを使用してそれらのマップをマップ シーンに追加できます。

mapScene = mapView.getMapScene();

mapPolyline = createPolyline();
mapScene.addMapPolyline(mapPolyline);

マップポリラインインスタンスがすでにマップ シーンに添付されている場合、それ以上追加しようとすると無視されます。

マップ ビューでは 1 つのシーンのみが許可され、すべての地図アイテムがそのシーンに直接配置されます。 マップアイテムをグループ化する場合は、配列を使用してマップアイテムを整理し、個別に追加または削除できます。

mapPolyline 次の電話番号を使用すると、をマップからただちに削除できます。

mapScene.removeMapPolyline(mapPolyline);

メモ :MapPolyline アイテム はピック可能Metadata で、アイテムをピックするときに取得できるを保存できます。 例については、以下のマップマーカーのセクションを参照してください。

MapMeasureRange アイテムのリストを設定することで、現在 MapPolyline のズームレベルに応じての表示/非表示を調整できます。

地図の矢印を追加します

地図の矢印は MapPolyline アイテムと似ており、任意の数のポイントを持つポリラインで構成されていますが 、矢印の先端が最後に表示されます 地図の矢印は、 13 を超えるズームレベルでのみ表示されます。 ルートジオメトリの一部にレンダリングする場合など、マップ上の方向を示すのに便利です。

private MapArrow createMapArrow() {
    ArrayList<GeoCoordinates> coordinates = new ArrayList<>();
    coordinates.add(new GeoCoordinates(52.53032, 13.37409));
    coordinates.add(new GeoCoordinates(52.5309, 13.3946));
    coordinates.add(new GeoCoordinates(52.53894, 13.39194));
    coordinates.add(new GeoCoordinates(52.54014, 13.37958));

    GeoPolyline geoPolyline;
    try {
        geoPolyline = new GeoPolyline(coordinates);
    } catch (InstantiationErrorException e) {
        // Thrown when less than two vertices.
        return null;
    }

    float widthInPixels = 20;
    Color lineColor = Color.valueOf(0, 0.56f, 0.54f, 0.63f); // RGBA
    MapArrow mapArrow = new MapArrow(geoPolyline, widthInPixels, lineColor);

    return mapArrow;
}

は MapArrow 、次の 3 つの要素で構成されて

• 地図上でポリラインを配置する場所を定義する 2 つ以上の地理座標のリスト。
• GeoPolyline この座標のリストを含む。
• color またはなどのスタイルパラメーター widthInPixels を使用して、矢印の表示方法を定義します。

幾何学的な線は 2 つ以上の点で定義 GeoCoordinatesされているため、配列を作成する必要があります。この配列には、少なくとも 2 つの点が含まれている必要があります。 それ以外の場合は、例外がスローされます。 線の外観を変更するには、線の太さをピクセル単位および色単位で設定します。 スクリーンショットの例については、を参照してください。

1 つ以上の地図矢印を作成したら、次のものを使用してマップ シーンに追加できます。

mapScene = mapView.getMapScene();

mapArrow = createMapArrow();
mapScene.addMapArrow(mapArrow);

マップの矢印インスタンスがすでにマップ シーンに添付されている場合、それ以上追加しようとすると無視されます。

マップ ビューでは 1 つのシーンのみが許可され、すべての地図アイテムがそのシーンに直接配置されます。 マップアイテムをグループ化する場合は、配列を使用してマップアイテムを整理し、個別に追加または削除できます。

mapArrow 次の電話番号を使用すると、をマップからただちに削除できます。

mapScene.removeMapArrow(mapArrow);

メモ :MapArrow アイテム はピック可能Metadata で、アイテムをピックするときに取得できるを保存できます。 例については、以下のマップマーカーのセクションを参照してください。

地図ポリゴンを追加します

は MapPolygon 、少なくとも 3 つの座標で構成されているシェイプです。そうでない場合は、レンダリングできません。 と同様 MapPolylineに、座標が接続されます。 ポリゴンは、マップ上の領域を強調表示するのに役立ちます。

注 : 座標の順序は重要です。

ポリゴンの作成方法については、以下の例を参照してください。 座標は、リスト内の時計回りの順序に基づいて接続されます。 結果のシェイプは、次の色で塗りつぶすことができます。

private MapPolygon createPolygon() {
    ArrayList<GeoCoordinates> coordinates = new ArrayList<>();
    // Note that a polygon requires a clockwise order of the coordinates.
    coordinates.add(new GeoCoordinates(52.54014, 13.37958));
    coordinates.add(new GeoCoordinates(52.53894, 13.39194));
    coordinates.add(new GeoCoordinates(52.5309, 13.3946));
    coordinates.add(new GeoCoordinates(52.53032, 13.37409));

    GeoPolygon geoPolygon;
    try {
        geoPolygon = new GeoPolygon(coordinates);
    } catch (InstantiationErrorException e) {
        // Thrown when less than three vertices.
        return null;
    }

    Color fillColor = Color.valueOf(0, 0.56f, 0.54f, 0.63f); // RGBA
    MapPolygon mapPolygon = new MapPolygon(geoPolygon, fillColor);

    return mapPolygon;
}

は MapPolygon 、次の 3 つの要素で構成されて

• 地図上でポリゴンを配置する場所を定義する 3 つ以上の地理座標のリスト。
• GeoPolygon この座標のリストを含む。
• を Color 使用して、多角形領域の塗りつぶし色を定義します。

ポリゴンは 3 つ以上のポイントで定義されているため GeoCoordinates、 3 つ以上のポイントを含む配列リストを作成する必要があります。 それ以外の場合は、例外がスローされます。 スクリーンショットの例については、を参照してください。

マップポリゴンを使用して、複雑な塗りつぶしまたは塗りつぶしなしの図形を作成できます。 ただし、自己交差する多角形は、座標がリストの順序で結合されているため、望ましくない結果につながる可能性があります。 別の方法として、複数のポリゴンを追加することも、目的の図形のアウトラインに表示されている座標を追加することもできます。

地図のポリラインとは異なり、地図の多角形のアウトラインは、最後の座標と一覧表の最初の座標の間で自動的に接続されます。

1 つ以上のマップポリゴンを作成したら、次のものを使用してマップ シーンに追加できます。

MapPolygon mapPolygon = createPolygon();
MapScene mapScene = mapView.getMapScene();
mapScene.addMapPolygon(mapPolygon);

マップポリゴンがすでにマップ シーンに添付されている場合、それ以上追加しようとすると無視されます。

マップ ビューでは 1 つのシーンのみが許可され、すべての地図アイテムがそのシーンに直接配置されます。 マップアイテムをグループ化する場合は、配列を使用してマップアイテムを整理し、個別に追加または削除できます。

を mapPolygon マップからただちに削除するには、次のコマンドを呼び出します。

mapScene.removeMapPolygon(mapPolygon);

メモ :MapPolygon アイテム はピック可能 で、 Metadata アイテムをピックするときに取得できるストアがあります。 例については、以下のマップマーカーのセクションを参照してください。

MapMeasureRange アイテムのリストを設定することで、現在 MapPolygon のズームレベルに応じての表示/非表示を調整できます。

地図の円を追加します

円形の図形は、地図上の領域の強調表示、位置の精度のハローの描画、または地図上の特定の位置のマーク付けを行う場合に便利です。 円は、技術的には三角形の多角形のシーケンスとしてレンダリングされます。

このため、次 MapPolygon のものを使用して、円をインスタンスとして作成できます GeoCircle。

private MapPolygon createMapCircle() {
    float radiusInMeters = 300;
    GeoCircle geoCircle = new GeoCircle(new GeoCoordinates(52.530932, 13.384915), radiusInMeters);

    GeoPolygon geoPolygon = new GeoPolygon(geoCircle);
    Color fillColor = Color.valueOf(0, 0.56f, 0.54f, 0.63f); // RGBA
    MapPolygon mapPolygon = new MapPolygon(geoPolygon, fillColor);

    return mapPolygon;
}

円は多角形の特殊なシェイプであるため MapPolygon 、前述のセクションで示したように、円をマップ シーンに追加（または から削除）できます。

地図マーカーを追加します

地図のマーカーを使用して、地図上の位置を正確にポイントできます。 地図のマーカーは、地図に表示されている他のものの上に常に描画されます。

次のコードでは、マップ マーカーが地図に追加されます。

MapImage mapImage = MapImageFactory.fromResource(context.getResources(), R.drawable.here_car);
MapMarker mapMarker = new MapMarker(geoCoordinates, mapImage);

mapView.getMapScene().addMapMarker(mapMarker);

この例では、リソースから PNG （ "here_care.png" ）を読み込み MapImage 、その中からを作成します。 これ MapImage を MapMarker インスタンスに設定できます。

上に移動すると、デフォルトのピクセルサイズで画像がロードされます。 を使用して MapImage(@NonNull byte[] imageData, @NonNull ImageFormat imageFormat, long width, long height) 、カスタムサイズを設定できます。

イメージを表示する MapMarker には、をマップ シーンに追加する必要があります。 MapImage は、提供さ geoCoordinatesれたの中央に表示されます。

geoCoordinates マーカーがマップに追加された後で、を更新することもできます。 mapMarker.setCoordinates() が呼び出された後、ただちに新しい場所に表示されます。

MapMarker を削除する場合は、次のように呼び出します。

mapView.getMapScene().removeMapMarker(mapMarker);

一 List<MapMarker> 度にタイプの地図マーカーのリストを削除することもできます。

mapView.getMapScene().removeMapMarkers(mapMarkerList);

同様 addMapMarkers(mapMarkerList)に、を使用してバッチ呼び出しで複数のマップマーカーを追加できます。

HERE SDK で MapMarker は、アイテムのカスタマイズ性の高いアニメーションサポートも提供されています。 フェードインのアニメーションは、次の 1 行のコードで適用できます。

// Optionally, enable a fade in-out animation.
mapMarker.setFadeDuration(Duration.ofSeconds(3));

マーカーがに追加または削除されるたび MapViewに、アニメーションがフェードインまたはフェードアウトします。 アニメーションは、マーカーがビューポイント に戻されたとき、つまりマップをパンすることでマーカーが再び表示されたときにも再生されます。

クラスでは、マーカーの移動などの高度なカスタムアニメーションを使用 MapMarkerAnimation できます。

MapMeasureRange アイテムのリストを設定することで、現在 MapMarker のズームレベルに応じての表示/非表示を調整できます。

さらに、不透明 度の値を設定してマーカーを透明にするなど、より多くの機能を使用できます。

アンカー付き POI マーカー

デフォルトでは、各画像は指定した位置にセンタリングされており、一部の種類のマーカーでこの設定を変更できます。 POI マーカーの例としては、通常、下中央の位置を指す POI マーカーがあります。

そのため、画像をレンダリングする場所をシフトする必要があります。 デフォルトの中心は (0.5 、 0.5) です。 ビューの右下隅が設定 GeoCoordinates した位置を指すようにする場合は、アンカーポイントを (1,1) に設定する必要があります。

アンカーポイントを使用すると、マーカーをレンダリングする場所を簡単に指定できます。 左上隅は (0,0) のアンカーポイントに相当し、右下隅は (1,1) のアンカーポイントに相当します。 ビューの大きさに関係なく、幅または高さの半分のポイントは常に 0.5 になります。これは、正規化されたテクスチャ UV 座標の概念に似ています。

POI をその場所をポイントするようにシフトする場合は、デフォルトの中央の位置（ 0.5 ）を維持できますが、画像を 1 つ上にシフトする必要があります。 1 は画像の高さと同じ長さになります。 1 より大きい値、または 0 より小さい値を指定して、イメージを任意の場所に移動することもできます。 2 は画像の高さの 2 倍を表します。

アンカー付き POI マーカーを地図に追加するには、以下の例を参照してください。

MapImage mapImage = MapImageFactory.fromResource(context.getResources(), R.drawable.poi);

// The bottom, middle position should point to the location.
// By default, the anchor point is set to 0.5, 0.5.
Anchor2D anchor2D = new Anchor2D(0.5F, 1);
MapMarker mapMarker = new MapMarker(geoCoordinates, mapImage, anchor2D);

mapView.getMapScene().addMapMarker(mapMarker);

上記の例では、「 poi.png 」という名前のカスタム POI 画像が、プロジェクトのさまざまな解像度で追加されています。 Android プラットフォームは、デバイスの表示密度に基づいて適切な画像解像度を選択します。 この方法については、付属のサンプルアプリを参照してください。

ポリラインとは異なり、マップ MapImage のズームインまたはズームアウト量に関係なく、各マップのサイズが保持されます。

[ 地図マーカー ] を選びます

地図に地図マーカーを追加した後、タップジェスチャリスナーを使用して、ユーザーがマップ マーカーをタップしたかどうかを確認できます。

private void setTapGestureHandler() {
    mapView.getGestures().setTapListener(new TapListener() {
        @Override
        public void onTap(@NonNull Point2D touchPoint) {
            pickMapMarker(touchPoint);
        }
    });
}

private void pickMapMarker(final Point2D touchPoint) {
    float radiusInPixel = 2;
    mapView.pickMapItems(touchPoint, radiusInPixel, new MapViewBase.PickMapItemsCallback() {
        @Override
        public void onPickMapItems(@Nullable PickMapItemsResult pickMapItemsResult) {
            if (pickMapItemsResult == null) {
                // An error occurred while performing the pick operation.
                return;
            }
            List<MapMarker> mapMarkerList = pickMapItemsResult.getMarkers();
            if (mapMarkerList.size() == 0) {
                return;
            }
            MapMarker topmostMapMarker = mapMarkerList.get(0);

            showDialog("Map marker picked:", "Location: " +
                    topmostMapMarker.getCoordinates().latitude + ", " +
                    topmostMapMarker.getCoordinates().longitude);
        }
    });
}

タップジェスチャが検出されるとすぐに、画面上のタップされた位置のビュー座標を使用して、その位置を囲む地図マーカーをマップ ビューに要求できます。 ほとんどの場合、半径を 2 ピクセルに指定するのが適切です。 次に、MapPolygonまたはMapMarkerなど、検出された地図アイテムにPickMapItemsCallbackアクセスできるようになります。

メタデータの追加中

多くの場合、ユーザーは表示されているマーカーと対話したい場合があります。たとえば、検索結果をタップして、レストランの詳細を確認できます。 この目的のために、MapMarkerはMetadataクラスのインスタンスを保持できるので、さまざまな種類のデータをクラスに添付できます。カスタムタイプもサポートされています。

Metadata 複数のキー / 値のペアを保持できます。 以下では、という名前の新しいキーを作成し "key_poi" 、 String マーカーのタイプに関する情報を含む値としてを設定します。

Metadata metadata = new Metadata();
metadata.setString("key_poi", "This is a POI.");
mapMarker.setMetadata(metadata);

必要に応じて、任意の情報を設定できます。 Metadata インスタンスの内容を読み取る瞬間に、キーに保存されているデータを要求するだけです。 "key_poi" この例を次に示します。

Metadata metadata = topmostMapMarker.getMetadata();
if (metadata != null) {
    String message = "No message found.";
    String string = metadata.getString("key_poi");
    if (string != null) {
        message = string;
    }
    showDialog("Map Marker picked", message);
    return;
}

デフォルトでは、MapMarkerインスタンスにはMetadatamapMarker.getMetadata()が含まれておらず、null返される可能性があります。 キーによってアクセスされるデータは、Metadataオブジェクトにそのような情報が含まれていない場合にもnull使用できます。

存在する場合は、格納されているキー"key_poi"Stringを探し、ヘルパーメソッドを呼び出して、格納されているStringをユーザーに提示します。 設定に基づいて任意の文字列をキーとして選択できますが、一意のキーを使用するか、または別のデータアイテムに保存されているコンテンツを上書きします。 サンプルのソースコード全体を確認 するには、 MapMarker のサンプルアプリを確認してください。

マップ マーカークラスタを追加します

ズーム レベルによっては、複数 MapMarker のアイテムを重ねることができます。 MapMarkerCluster クラスを使用 MapMarker すると、複数のアイテムをグループ化して視覚的な乱雑さを軽減できます。 オーバーラップしているマーカーは、単一の画像表現に置き換えられます。 このようなクラスタイメージはピックでき、内に含まれているマーカーのみが含まれています。

次のコードは、複数 MapMarker のアイテムを含むクラスタを作成する方法を示しています。

public void showMapMarkerCluster() {
    MapImage clusterMapImage = MapImageFactory.fromResource(context.getResources(), R.drawable.green_square);

    // Defines a text that indicates how many markers are included in the cluster.
    MapMarkerCluster.CounterStyle counterStyle = new MapMarkerCluster.CounterStyle();
    counterStyle.textColor = new Color(0, 0, 0, 1); // Black
    counterStyle.fontSize = 40;
    counterStyle.maxCountNumber = 9;
    counterStyle.aboveMaxText = "+9";

    MapMarkerCluster mapMarkerCluster = new MapMarkerCluster(
            new MapMarkerCluster.ImageStyle(clusterMapImage), counterStyle);
    mapView.getMapScene().addMapMarkerCluster(mapMarkerCluster);
    mapMarkerClusterList.add(mapMarkerCluster);

    for (int i = 0; i < 10; i++) {
        mapMarkerCluster.addMapMarker(createRandomMapMarkerInViewport("" + i));
    }
}

MapImage 複数の重複するマップマーカーのクラスタを表すために使用するを設定できます。

MapMarker 地図 MapMarkerCluster にすでに表示されているにアイテムを追加したり、削除したりできます。 すべてのマーカーを含むクラスタを削除する場合は、次の呼び出しを行います。

mapView.getMapScene().removeMapMarkerCluster(mapMarkerCluster);

MapMarker クラスタに含まれているアイテムは、の一部では pickMapItemsResult.getMarkers()ありません。 そのため、 pickMapItems() 以下に示すコードを使用して、個別に集荷できます。電話対応の結果を受け取った後に MapMarker 行います ( セクションを参照 ) 。

private void handlePickedMapMarkerClusters(PickMapItemsResult pickMapItemsResult) {
    List<MapMarkerCluster.Grouping> groupingList = pickMapItemsResult.getClusteredMarkers();
    if (groupingList.size() == 0) {
        return;
    }

    MapMarkerCluster.Grouping topmostGrouping = groupingList.get(0);
    int clusterSize = topmostGrouping.markers.size();
    if (clusterSize == 0) {
        // This cluster does not contain any MapMarker items.
        return;
    }
    if (clusterSize == 1) {
        showDialog("Map marker picked",
                "This MapMarker belongs to a cluster. Metadata: " + getClusterMetadata(topmostGrouping.markers.get(0)));
    } else {
        String metadata = "";
        for (MapMarker mapMarker: topmostGrouping.markers) {
            metadata += getClusterMetadata(mapMarker);
            metadata += " ";
        }
        showDialog("Map marker cluster picked",
                "Number of contained markers in this cluster: " + clusterSize + ". " +
                "Contained Metadata: " + metadata + ". " +
                "Total number of markers in this MapMarkerCluster: " + topmostGrouping.parent.getMarkers().size());
    }
}

private String getClusterMetadata(MapMarker mapMarker) {
    Metadata metadata = mapMarker.getMetadata();
    String message = "No metadata.";
    if (metadata != null) {
        String string = metadata.getString("key_cluster");
        if (string != null) {
            message = string;
        }
    }
    return message;
}

このコードを使用すると、クラスタが選択されたかどうかを検出し、含まれているマーカーをユーザーに通知できます。 markersリストに 1 つのアイテムのみが含まれている場合は、 1 つのMapMarkerインスタンスを指定することもできます。

通常 MapMarkerCluster 、必要なインスタンスは 1 つだけです。このインスタンスを超えると、最上位のクラスタのみが処理されます。

マーカーの距離に応じ MapMarkerCluster て、同じインスタンスに複数のクラスタイメージを表示できます。各イメージには、クラスタ化されたマーカーの合計数のサブセットが含まれています。

GitHub の例については、 MapItems アプリを参照してください。

[ 埋め込み POI] を選択します

埋め込み Carto は MapView、すでに事前設定され、に表示されているデフォルトの POI マーカーです。 MapMarker アイテムとは異なり、アイテムの内容や外観は HERE Style Editor を使用せずに変更できません。 ただし、このようなアイコンをタップして、場所や PlaceCategory POI の名前などの情報を取得することはできます。

埋め込み POI は MapMarker 、別の地図アイテムによって現在非表示になっていない限り、地図に表示されている他のアイテムと並行してピックできます。

private void setTapGestureHandler() {
    mapView.getGestures().setTapListener(new TapListener() {
        @Override
        public void onTap(@NonNull Point2D touchPoint) {
            pickMapMarker(touchPoint);
        }
    });
}

private void pickMapMarker(final Point2D touchPoint) {
    // You can also use a larger area to include multiple carto POIs.
    Rectangle2D rectangle2D = new Rectangle2D(touchPoint, new Size2D(1, 1));
    mapView.pickMapContent(rectangle2D, new MapViewBase.PickMapContentCallback() {
        @Override
        public void onPickMapContent(@Nullable PickMapContentResult pickMapContentResult) {
            if (pickMapContentResult == null) {
                // An error occurred while performing the pick operation.
                return;
            }

            List<PickMapContentResult.PoiResult> cartoPOIList = pickMapContentResult.getPois();
            int listSize = cartoPOIList.size();
            if (listSize == 0) {
                return;
            }

            PickMapContentResult.PoiResult topmostCartoPOI = cartoPOIList.get(0);
            showDialog("Carto POI picked:", topmostCartoPOI.name + ", Location: " +
                    topmostCartoPOI.coordinates.latitude + ", " +
                    topmostCartoPOI.coordinates.longitude + ". ");
        }
    });
}

拡張場所の詳細は 、 Navigate Edition でのみ利用できます。

地図に埋め込まれている POI の表示範囲は、MapScene.setPoiVisibility()で制御 できます。この機能を使用すると、 POI カテゴリのリストのVisibilityStateを設定できます。

すべての POI カテゴリがすべてのマップスキームで利用できるわけではありません。

サポートされているカテゴリの一覧については 、 HERE Style Editor のドキュメントを参照してください。

Explore Editionでは、埋め込み POI として表示されるすべての PlaceCategory フィールドがサポートされているわけではありません。たとえば、 EAT_AND_DRINK および SHOPPING は 、 Navigate Edition を使用している場合にのみ表示されます。

以下の埋め込み POI カテゴリグループは、現在 MapViewExplore Edition のに表示されていません。

• 宿泊施設
• 自動車関連
• 飲食施設もある
• ショッピング

3D マップマーカーを追加します

HERE SDK を使用すると、カスタム 3D モデルをマップに追加できます。 オプション Colorで、これらのモデルをブレンドと一緒にテクスチャ化できます。 common.obj ファイル形式は、 3D モデルの形状を指定するために使用されます。 無料の 3.js オンラインエディタなど、一般的な 3D モデリングソフトウェアを使用して生成できます。

obj ファイル形式では、モデルのレンダリング方法を定義する頂点、法線、テクスチャ座標、およびフェースを指定します。 結果のモデルは、その座標を更新することで、マップの周囲を移動できます。 ベアリング、ピッチ、ロールを更新することで、その方向を変更できます。

HERE SDK では、材料ファイル（ * 。 mtl ）およびマルチテクスチャリングはサポートされていません。

obj 形式でモデルを定義し、モデルを囲むテクスチャを作成したら、両方のファイルをプロジェクトの assets ディレクトリに追加します。 例 : app/src/main/assets/...

次に、 1 つの obj ファイルと PNG テクスチャを追加しました。

• app/src/main/assets/Obstacle.obj
• app/src/main/assets/obstacle_texture.png にアクセスします

ヒントとして、 Android を使用 AssetManager して、次のようにファイルが存在することを確認します。

private void checkIfFileExistsInAssetsFolder(String fileName) {
    AssetManager assetManager = context.getAssets();
    try {
        assetManager.open(fileName);
    } catch (IOException e) {
        Log.e("MapMarkerExample", "Error: File not found!");
    }
}

この設定を使用すると、予期したファイルの場所にファイルが存在しない場合に例外が発生します。

次のコードを使用して MapMarker3D 、をマップに追加できるようになりました。

String geometryFile = "obstacle.obj";
String textureFile = "obstacle_texture.png";
checkIfFileExistsInAssetsFolder(geometryFile);
checkIfFileExistsInAssetsFolder(textureFile);

MapMarker3DModel mapMarker3DModel = new MapMarker3DModel(geometryFile, textureFile);
MapMarker3D mapMarker3D = new MapMarker3D(geoCoordinates, mapMarker3DModel);
mapMarker3D.setScale(6);
mapMarker3D.setDepthCheckEnabled(true);

mapView.getMapScene().addMapMarker3d(mapMarker3D);

上の例 MapMarker3DModel では、モデルを定義するコンストラクタに両方のアセットファイルを渡します。 同様に、MapImage要素についてすでに確認したように、使用可能なMapMarker3Dコンストラクタのいずれかにモデルを渡すことができます。 モデルが 6 倍以上に見えるようにスケール係数も設定します。 obj モデルは 3D 座標空間で定義されているため、長さの単位は含まれていません。

MapMarker3D を使用 MapSceneして、他の地図アイテムと同様にアイテムを追加および削除できます。

以下に、表示方法の例を示します。 モデルは、提供された地理座標を中心に配置されます。 モデルの中心は、その座標系の原点によって定義されます。

このメソッド setDepthCheckEnabled は、レンダリング中に 3D マーカーの頂点の深さを考慮するかどうかを決定し、デフォルトで false に設定されます。

• MapMarker3D が setDepthCheckEnabled false に設定されている場合、アイテムは常に地図に表示されている他のアイテムの上に描画されます。
• setDepthCheckEnabled が true に設定されている場合、 3D マーカーは、押し出された建物などの他のマップオブジェクトによって隠されている可能性があります。 このメソッド setDepthCheckEnabled は、外側と内側の領域を持つトーラスのような複雑な 3D オブジェクトを描画するのに役立ちます。

2D MapMarker アイテムと同様に、MapMarker3Dは マップを拡大または縮小してもサイズは変更されませんが、マップと一緒に回転します。

3D マーカーを地図と合わせて拡大 / 縮小する場合は、どうすればよいですか？

このためには MapMarker3D 、を受け取るの簡易コンストラクタを使用します RenderSize.Unit。 たとえば densityIndependentPixels 、拡大縮小を禁止する場合に使用します。その結果作成されるマーカーは、ズーム レベル とは独立した固定サイズで作成されます。 RenderSize.Unit スケーリング meters を許可するには、とを使用します。

MapMeasureRange アイテムのリストを設定することで、現在 MapMarker3D のズームレベルに応じての表示/非表示を調整できます。

の透明度を変更する場合は MapMarker3D opacity 、次の係数を指定できます。 係数はマーカーのテクスチャのアルファチャンネルに適用されます。 このrenderInternalsEnabledフラグを設定することで 、前面に面したポリゴンによって隠された内部ジオメトリをレンダリングするかどうかを指定できます。

フラットマップマーカーを追加します

既定 MapMarker では、アイテムは地図とともに回転せず、地図を傾けると傾いてしまいます。 これは、を使用し MapMarker3D て フラットにすることで変更できます。 実際、フラットマップマーカーは MapMarker3D 、 3D 空間の Z 軸に 0 の長さを含むアイテムの特殊なケースです。

MapImage パラメータを受け取る簡易コンストラクタを使用して、フラットMapMarker3Dオブジェクトを作成できます。 RenderSize.Unit スケーリング densityIndependentPixels を禁止するには、と併用します。 作成されたマーカーは、ズーム レベル とは独立した固定サイズで作成されます。 RenderSize.Unit スケーリング METERS を許可するには、とを使用します。

作成されたフラットマーカーは地図とともに傾き、地図を回転するときにも回転します。

MapImage mapImage = MapImageFactory.fromResource(context.getResources(), R.drawable.poi);

// The default scale factor of the map marker is 1.0. For a scale of 2, the map marker becomes 2x larger.
// For a scale of 0.5, the map marker shrinks to half of its original size.
double scaleFactor = 1.0;

// With DENSITY_INDEPENDENT_PIXELS the map marker will have a constant size on the screen regardless if the map is zoomed in or out.
MapMarker3D mapMarker3D = new MapMarker3D(geoCoordinates, mapImage, scaleFactor, RenderSize.Unit.DENSITY_INDEPENDENT_PIXELS);

mapView.getMapScene().addMapMarker(mapMarker3D);

この例では、リソースから PNG （ "ipo.png" ）を読み込み MapImage 、その中からを作成します。 これ MapImage を MapMarker インスタンスに設定できます。

イメージを表示する MapMarker には、をマップ シーン に追加する必要があります。 が MapImage 提供されたの中央に表示され geoCoordinatesます。

地図を使用してフラットな 3D マーカーを拡大縮小する場合は、どうすればよいですか ?

MapMarker3Dを使用してフラットなマップ マーカー を作成 し、RenderSize.UnitMETERSを使用して拡大 / 縮小時のスケーリングを可能にします。

2D モデルからフラット 2D マップ マーカー を作成する方法

次の段落では、手書きの obj ファイルから 2D モデルを作成する方法を示します。 その結果、前のセクションと同じフラットマップ マーカー を作成できます。

以下に、平面の 2D 例を示します。この例では、 x 軸と y 軸に 2 つの単位があります。 3D オブジェクトは簡単にスケーリングできるため、モデルのサイズは重要ではありません。 この例の座標系の原点は、平面の下部にあります。 このようにして、 POI マーカーアセットを、指定した地理座標をポイントするテクスチャとしてラップできます。

# A 2 x 2 square, centered upon origin.

v -1 2 0
v 1 2 0
v -1 0 0
v 1 0 0
# 4 vertices

vt 0 1
vt 1 1
vt 0 0
vt 1 0
# 4 texture vertices

vn 0 0 1
vn 0 0 1
vn 0 0 1
vn 0 0 1
# 4 vertex normals

f 1/1/1 3/3/3 2/2/2
f 3/3/3 4/4/4 2/2/2
# 2 faces

この例では、上記の平面のモデル定義を "plane.obj" という名前のテキストファイルに保存します。

平面は正方形であるため、画像が正方形になるように、左右の POI 画像のサイズを透明な領域で拡張します。 元の画像は正方形ではなく長方形であるため、平面にラップすると変形します。

obj 形式でモデルを定義し、モデルを囲むテクスチャを作成したら、両方のファイルをプロジェクトの assets ディレクトリに追加します。 例 : app/src/main/assets/...

次に、 1 つの obj ファイルと PNG テクスチャを追加しました。

• app/src/main/assets/plane.obj
• app/src/main/assets/poi_texture.png にアクセスします

地図にフラットマーカーを追加するには、次のコードを使用します。

String geometryFile = "plane.obj";
String textureFile = "poi_texture.png";
checkIfFileExistsInAssetsFolder(geometryFile);
checkIfFileExistsInAssetsFolder(textureFile);

MapMarker3DModel mapMarker3DModel = new MapMarker3DModel(geometryFile, textureFile);
MapMarker3D mapMarker3D = new MapMarker3D(geoCoordinates, mapMarker3DModel);
mapMarker3D.setScale(60);

mapView.getMapScene().addMapMarker3d(mapMarker3D);

checkIfFileExistsInAssetsFolder() メソッドのコードは、前のセクションで確認できます。

3D 空間で正規化された 2 単位の長さを使用したため、モデルを 60 倍大きいサイズに拡張します。 結果は以下のスクリーンショットに表示されます。

フラットマーカーが参照している場所を示す赤い円が追加されました。

地図と一緒に地図の平面マーカーが回転します。また、地図を傾けるとマップ マーカーも傾斜し、 2D モデルが平坦であっても 3D のような効果が得られます。 デフォルトでは、フラットマップマーカー の縮尺値は地図のズーム レベルと一緒に変更されません。 たとえば、マップをズームアウトしても、展開されていない場合と同じようにマップ マーカーが表示されます MapMarker。

地図でマーカーを拡大縮小する場合は、前のセクションで示したように、フラットなマップ マーカー を作成します。

位置情報インジケータを追加します

別の種類の 3D マップアイテムはです LocationIndicator。 通常、地図上のユーザーのデバイスの現在の位置を示すインスタンスが 1 つだけ追加されます ( 見出し方向を含む ) 。

他のマップアイテムとは異なり、LocationIndicatorはMapViewLifecycleListenerインターフェイスを実装します。インターフェイスのライフサイクルは、追加されるとMapViewによって管理されます。

HERE SDK では、さまざまなユースケースに合わせて事前定義された 3D アセットが提供されます 必要に MapMarker3DModel 応じて、定義済みの各スタイルに独自のカスタマイズを設定することで、これらのスタイルを置き換えることができます。

LocationIndicator マップ ビューのズーム レベルが変更されても、すべてのマップマーカーのスケールは変更されません。 ただし、地図が傾いている場合 LocationIndicator 、水平線に向かって移動するとが小さくなります。

LocationIndicator マップにを追加する方法の例を示します。

private void addLocationIndicator(GeoCoordinates geoCoordinates,
                                  LocationIndicator.IndicatorStyle indicatorStyle) {
    LocationIndicator locationIndicator = new LocationIndicator();
    locationIndicator.setLocationIndicatorStyle(indicatorStyle);

    // A LocationIndicator is intended to mark the user's current location,
    // including a bearing direction.
    // For testing purposes, we create a Location object. Usually, you may want to get this from
    // a GPS sensor instead.
    Location location = new Location(geoCoordinates);
    location.time = new Date();
    location.bearingInDegrees = getRandom(0, 360);

    locationIndicator.updateLocation(location);

    // A LocationIndicator listens to the lifecycle of the map view,
    // therefore, for example, it will get destroyed when the map view gets destroyed.
    mapView.addLifecycleListener(locationIndicator);
}

上記のように、アセットは必要ありません。 代わりに IndicatorStyle 、が設定されます。

• LocationIndicator.IndicatorStyle.NAVIGATION: ナビゲーションの使用例を想定して設計されたアセット。
• LocationIndicator.IndicatorStyle.PEDESTRIAN: 座っているときや歩いているときなど、ハンドヘルドで使用できるように設計されたアセット。

どちらのスタイルも、現在のベアリングを示し ます。このベアリングは、ユーザーの進行方向を表します。 この例では、 0 ° ～ 360 ° の範囲のランダムなベアリング値を設定します。 0 ° の方位が 上向きであることを示しているため、地図も 上向きになっているため、デフォルトでは矢印が上向きになっています。

ナビゲーション中に、ユーザーが運転している方向にマップを回転させるのが一般的な UX アプローチです。これにより、方位が変化しても、方向矢印が上向きのままになります。 通常、ナビゲーション中、矢印はユーザーが走行している道路の方向を指していることが想定されています。

徒歩によるユースケースの場合、ユーザーの現在の位置に焦点が当てられます。 そのため、方向はより小さい矢印で示されます。

ベアリング値の用途に応じて異なります。 Location オブジェクトから派生したベアリングの値は 移動の方向を示しますが、アプリケーションは真の北を基準にしてベアリングを設定することもできます（コンパスモード）。 矢印が真の北を指すようにする場合は、ベアリング値を 0 ° に変更します。 Location このような補正は、位置情報ソースから新しい更新を受け取るたびに行う必要があります ( 以下を参照 ) 。

通常 LocationIndicator 、の 1 つのインスタンスのみがマップに設定されます。 updateLocation() その場所に電話をかけると、場所を更新 setLocationIndicatorStyle() できます。また、そのスタイルを呼び出すことで、その場でスタイルを更新できます。

各スタイルには、 MarkerType GPS 信号が失われたときのグレーの状態など、さまざまな状態を定義する複数の関連値があります。 が LocationIndicator カスタマイズされている場合は、すべてのタイプを設定することが重要です。そうしないと、状態を変更しても効果はありません。

次のコード スニペットは、事前定義されたグレーのタイプ（ 非アクティブ な状態を示す）とデフォルトの状態を切り替える方法を示しています。

boolean isActive = locationIndicator.isActive();
// Toggle between active / inactive state.
locationIndicator.setActive(!isActive);

LocationIndicatorはMapViewLifecycleListenerインターフェイスを実装しているため、MapViewのライフサイクルと結合されます。

最も一般的なユースケースをサポートするメリットとして、LocationIndicatorをマップに一度追加すると、そのライフサイクルがMapViewによって自動的に管理されます。 ただし LocationIndicator 、自分でを削除する場合は、次の電話番号に連絡してください。

mapView.removeLifecycleListener(locationIndicator);

ほとんどの場合、 LocationIndicatorは頻繁なLocation更新に基づいて更新されます。 分離された使用例を MapItems サンプルアプリの一部として確認できます。

MapViewLifecycleListener の使用方法

は MapViewLifecycleListener 、のライフサイクルをリッスンする任意のクラスによって実装 MapViewできます。 たとえば、で LocationIndicatorは、このインターフェイスはすでに実装されています。 この実装では、次のイベントへの対応が処理されます。

• onAttach(MapViewBase mapView): インプリメントするオブジェクトをマップ ビューに追加するときに呼び出されます。
• onPause(): インプリメント元のオブジェクトが添付されているマップ ビューが一時停止されたときに呼び出されます ( 通常は、アプリがバックグラウンドに入ったとき ) 。
• onResume(): インプリメント元のオブジェクトが添付されているマップ ビューが再開されたときに呼び出されます ( 通常は、アプリがフォアグラウンドに入るとき ) 。
• onDetach(MapViewBase mapView): マップ ビューからインプリメントするオブジェクトを削除するときに呼び出されます。
• onDestroy(): インプリメント元のオブジェクトが添付されているマップ ビューが削除されたときに呼び出されます。

次のように、インプリメントするオブジェクトを添付および削除できます。

• MapView オブジェクトをライフサイクルに添付します。 mapView.addLifecycleListener(myObject);
• MapView ライフサイクルからオブジェクトを削除します。 mapView.removeLifecycleListener(myObject);

マップビュー から地図アイテムを選ぶ方法

次の表に、現在選択可能な地図アイテムを選択する方法を示します。

マップ ビューピンを追加します

地図のマーカーを使用 View すると、地図にアイテムをシームレスに配置できますが、地図のピンを使用して、地図にネイティブのものを固定できます。 情報のポップアップバブル ( またはアニメーション化された情報バブル ) 、注釈、またはカスタマイズされたコントロールを表示する場合に便利です。 たとえば、マップ マーカーをタップすると、マーカーの位置に関する追加情報を含むマップピンを表示できます。

マップピンは複数のViewsピンで構成でき、それぞれ他のViewピンと同様に使用できます。このピンを使用すると、ネストされたレイアウトの追加、クリックハンドラの添付、アニメーションの適用などを行うことができます。

カスタムの場合と同様に、 XML レイアウトファイルでビューを定義し、プログラムで展開するか、またはプログラムで目的のビューコンテンツを生成できます。 例 :

TextView textView = new TextView(context);
textView.setTextColor(Color.parseColor("#FFFFFF"));
textView.setText("Centered ViewPin");

LinearLayout linearLayout = new LinearLayout(context);
linearLayout.setBackgroundResource(R.color.colorAccent);
linearLayout.setPadding(10, 10, 10, 10);
linearLayout.addView(textView);

Viewこれにより、TextViewを保持するLinearLayout（派生元）が作成されます。 TextView中間レイアウトに追加せずに、を直接追加することもできます。 ビューまたは単一ビューの任意の組み合わせを追加できます。

ここで行う必要があるのは、小さなビューの構成要素をマップに追加することだけです。 ポリゴンやマーカーなどの他のマップアイテムとは異なり、ピンはマップに直接追加できます。

ViewPin viewPin = mapView.pinView(linearLayout, geoCoordinates);

このメソッドは、アンカーポイントの指定など、ピン接続の制御に使用できるプロキシオブジェクトを返します。

でタップジェスチャリスナーを設定し View て、ユーザーがマップ ビュー ピンをタップしたかどうかを確認することもできます。

linearLayout.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        Log.i(TAG, "Tapped on MapViewPin");
    }
});

アニメーションをビューに適用したり、他のインタラクションリスナーを添付したりすることもできます。 が View マップ ビューに添付されると、他の Android と同様に動作します View 。ただし、マップ上で固定されたままになり、パンまたはズーム時に移動する点が異なります。 ViewPin 地図を回転しても、地図のポリラインや地図のマーカーと同様に、は回転しません。

マップピンはいくつでも追加できますが、パフォーマンスを考慮する必要があります。 たとえば、地図上で複数の検索結果を指定する場合、地図のピンのパフォーマンスは地図のマーカーよりも低くなります。

地図から PIN を削除するには、次の番号に電話をかけるだけです。

mapView.unpinView(view);

複数 ViewPin のインスタンスを追加した場合は mapView 、次のコマンドを呼び出して、オブジェクトからすべてのピンにアクセスできます。

List<ViewPin> viewPins = mapView.getViewPins();

通常、地図の PIN は 、地図上の特定の場所の追加の動的コンテンツを表示するのに最適です。

アンカー付きマップ ビューピン

既定では、地図のピンは指定した場所の中央に配置されます。 ただし、下の領域を覆わずにピンを使用する場合は、どうすればよいですか。

この目的のために、アンカーポイントを指定できます。アンカーポイントは、上のマップマーカーですでに確認したのと同じ方法で、画面上のビューの位置に影響を与えます。

viewPin.setAnchorPoint(new Anchor2D(0.5F, 1));

これにより、ビューが位置の中央に水平に配置され、ビューの下部が指定した座標と一致します。 以下のスクリーンショットで表示されているように、マップピンは、マップピンの提供された中心位置を示すマップ円オブジェクトの上に配置されます。

アンカーポイントを使用すると、ビューをレンダリングする場所を簡単に指定できます。 左上隅は (0,0) のアンカーポイントに相当し、右下隅は (1,1) のアンカーポイントに相当します。 ビューの大きさに関係なく、幅または高さの半分のポイントは常に 0.5 になります。これは、正規化されたテクスチャ UV 座標の概念に似ています。 図については、上の地図のマーカーのセクションを参照してください。

デフォルトでは、アンカーポイントは (0.5 、 0.5) で、ビューがその位置を中心にレンダリングされます。 ビューの右下隅が設定 GeoCoordinates した位置を指すようにする場合は、アンカーポイントを (1,1) に設定する必要があります。

ビューのサイズは任意であるため、最大の幅と高さの値は 1 になります。 ビューの寸法は、完全に膨張した後で計算されます。 ビューの正確な寸法がわかっている場合は、ビュー内の特定の点を、最大値の 1 を基準にして簡単に計算できます。

注 : オフセット を使用すると、 x 軸および y 軸に沿った平行移動を指定できますが 、基準点は、ビューなどの長方形の左上隅の相対位置を定義します。 ビューの境界を基準 GeoCoordinates にして、ビューが指定した位置を中心とする点を定義します。