マップを使用

HERE SDK for Android の主要な機能の 1 つ がマッピングです。マッピングには、マップ ビューの追加、マップに表示される場所の変更、およびそのプロパティの変更が含まれます。 マッピング API の主なコンポーネントはマップ ビュー View です。このコンポーネントはサブクラスとして統合されています。 マップ ビューは 、 マップおよびさまざまなプロパティを表示するためのベクターベースのビューを表します。

HERE Map Data は 毎週更新 され、常に最新のマップ データを利用できるようになっています。 マップ ビューを統合することで、このメリットを自動的に享受できます。 マップがベクターベースのビューを表します。である間 、他のプロバイダのカスタム地図タイルを統合することもできます。

マップとそのプロパティを操作するには 、まず [ カメラ ] セクションを確認することをお勧めします。 その他の機能 :

• 一般的なマップジェスチャや、パニングや回転などのデフォルトのマップビヘイビアーを処理するためのマップジェスチャ。
• サテライトと通常のマップ レイヤーなどの既定のマップスタイルを瞬時に切り替えるマップスキーム。 利用可能なマップスキームの詳細については、以下を参照してください。
• マップ アイテムを使用してオブジェクトや図形をマップ上に配置し、それらを操作します。
• カスタムサーバーイメージを追加のマップ レイヤーとして表示する カスタムラスタータイル。
• 既存 のマップスキームの外観を完全にカスタマイズするカスタムマップスタイル。

パフォーマンスの最適化

デフォルトでは、MapView は 60 フレーム / 秒（ FPS ）でレンダリングされます。 mapView.get/setFrameRate() 最大フレームレートを使用して調整できます。たとえば、ローエンドデバイスでの CPU/GPU の使用量を削減できます。 FPS を 0 に設定することで、自動レンダリングサイクルを非アクティブ化することもできます。 負の値を設定しても効果はありません。 この値は、アプリに複数のMapViewが含まれている場合に、インスタンスごとのMapViewに個別に設定できます。

別 のオプションとして、レンダリングする要素が少ないカスタムマップスタイルを使用することもできます。

HERE SDK フレームワークのサイズを縮小するため に、未使用のフォントはアプリケーションを使用する前に削除できます。

マップ設定を読み込む

HERE SDK では、いくつかの事前設定済みのマップスキーム

• LITE_DAY: 簡易版の Lite Hybrid マップ スキーム。 NORMAL_DAYのマップ要素が少なく、カラーパレットが限定されています。
• LITE_NIGHT: 簡易版の Lite Hybrid マップ スキーム。 NORMAL_NIGHTのマップ要素が少なく、カラーパレットが限定されています。
• LITE_HYBRID_DAY: 簡易版の Lite Hybrid マップ スキーム。HYBRID_DAYのマップ要素が少なく、カラーパレットが限定されています。
• LITE_HYBRID_NIGHT: 簡易版の Lite Hybrid マップ スキーム。 HYBRID_NIGHTのマップ要素が少なく、カラーパレットが限定されています。
• NORMAL_DAY: 昼間の使用に適したロスレスのスケーラブルなベクターベースのビューを表します。 マップ。
• NORMAL_NIGHT: 夜間使用のためのロスレスでスケーラブルなベクターベースのビューを表します。 マップ。
• HYBRID_DAY: 衛星の画像と、ベクターストリートネットワーク、マップラベル、 POI 情報を組み合わせたハイブリッド方式の昼間バージョン。
• HYBRID_NIGHT: 衛星の画像と、ベクターストリートネットワーク、マップラベル、 POI 情報を組み合わせたハイブリッド方式の夜間バージョン。
• SATELLITE: さまざまなズームステージの衛星画像を表示するビットマップベースのマップ。
• LOGISTICS_DAY: 運行管理管理コンテンツに重点を置いた Day バージョンのマップ スキーム。

衛星画像を除き、独自のマップスタイルを完全にカスタマイズすることもできます。

マップ スキームをロードするには、次のコード スニペットを使用します。

MapScheme mapScheme = MapScheme.NORMAL_DAY;

mapView.getMapScene().loadScene(mapScheme, new MapScene.LoadSceneCallback(){
    @Override
    public void onLoadScene(@Nullable MapError mapError) {
        if (mapError == null) {
            // ...
        } else {
            Log.d(TAG, "Loading of map scheme failed: mapError: " + mapError.name());
        }
    }
});

周囲の光が明るい日中は、 dayのバリエーションを使用することをお勧めします。 night バリアントは、軽量化されている場合の使用に合わせて最適化されています。 たとえば、ドライバーがトンネルを通過するときに、アプリケーションが昼間から夜間のスキームに切り替わる場合があります。Navigate Edition 使用している場合は、変更された道路属性について通知を受け、トンネルを通過するときに通知を受け取ることができます。 これにより、アプリケーションがマップ スキームをその場で切り替えることができます。 この問題は自動的には発生しません。

HERE SDK は、昼間モードと夜間モードを切り替える現在の時刻を自動的に検出するわけではありません。 アプリケーションは、ユーザーの設定に基づいて、またはデバイスのクロックを確認することによって、この処理を行うことができます。

利用可能なマップスタイルが最適化され、視覚的な干渉なしにコンテンツやオーバーレイをベース マップに簡単に追加できます。 マップの配色はあまりカラフルではありません。また、色覚異常が発生した場合でも読みやすさを最大限に高めるために、クリーンで中立的な色調をサポートしています。

• 街路網はグレーのスケールで設計され、明るさ、コントラスト、幅を階層構造で提供します。
• 全体的に明るい色使いでまとめられている。
• キーの色は、グレー、ブルー、グリーン、ホワイトです。

さらに、 HERE SDK では 、 ラベルを含まない衛星スキームを提供しています。

マップフィーチャとしてマップレイヤを追加

HERE SDK では、マップスキームに加え て、特定の種類のレイヤを追加できます。これをマップフィーチャーと呼びます。このレイヤには、現在のトラフィックフローなどの追加情報が表示されます。 以下に、このようなレイヤーを有効にする方法を示します。

Map<String, String> mapFeatures = new HashMap<>();
mapFeatures.put(MapFeatures.TRAFFIC_FLOW, MapFeatureModes.TRAFFIC_FLOW_WITH_FREE_FLOW);
mapFeatures.put(MapFeatures.TRAFFIC_INCIDENTS, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.SAFETY_CAMERAS, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.VEHICLE_RESTRICTIONS, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.TERRAIN, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.LANDMARKS, MapFeatureModes.LANDMARKS_TEXTURED);
mapFeatures.put(MapFeatures.EXTRUDED_BUILDINGS, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.BUILDING_FOOTPRINTS, MapFeatureModes.DEFAULT);
mapFeatures.put(MapFeatures.ROAD_EXIT_LABELS, MapFeatureModes.ROAD_EXIT_LABELS_ALL);
mapView.getMapScene().enableFeatures(mapFeatures);

同様に、以下のようにレイヤーのリストを無効にすることもできます。

List<String> mapFeatures = new ArrayList<>();
mapFeatures.add(MapFeatures.TRAFFIC_FLOW);
mapFeatures.add(MapFeatures.TRAFFIC_INCIDENTS);
mapView.getMapScene().disableFeatures(mapFeatures);

すべてのエディションですべてのフィーチャーのレイヤーを利用できるわけではありません。 API リファレンス で サポートされているレイヤーを確認してください。 レイヤーを追加すると、ローエンドデバイスのパフォーマンスへの影響が最小限に抑えられることに注意してください。

以下に、サポートされているすべてのマップレイヤーのスクリーンショットを示します。

一部のレイヤーでは、MapContentSettingsを使用して表示されたコンテンツをフィルタリングできます

• MapFeatures.TRAFFIC_INCIDENTS: filterTrafficIncidents​(List<TrafficIncidentType> trafficIncidents) 表示されている交通障害をフィルタリングするために使用します。
• MapFeatures.VEHICLE_RESTRICTIONS: filterVehicleRestrictions​(TruckSpecifications truckSpecifications, List<HazardousMaterial> hazardousMaterials, TunnelCategory tunnelCategory) 表示されているトラック制限をフィルタリングするために使用します。

注 : マップレイヤー BUILDING_FOOTPRINTS & EXTRUDED_BUILDINGS は、MapViewでデフォルトで有効になっています。

埋め込み POI

当然のことながら、マップには、レストラン、公共交通機関、その他の一般的な名所を表すアイコンがデフォルトでいくつか表示されています。 これらの POI は Carto POI と呼ば れ、ユーザーが選択して詳細情報を取得できます。 これらの埋め込み POI の可視性を制御することもできます。

詳細については、マップアイテムのセクションを参照してください。

マップの準備ができ次第通知を受信

HERE Rendering Engine は 、onResume()が呼び出されるたびに添付されます。 この 状況が発生すると、OnReadyListener によって通知されます。

mapView.setOnReadyListener(new MapView.OnReadyListener() {
    @Override
    public void onMapViewReady() {
        // This will be called each time after this activity is resumed.
        // It will not be called before the first map scene was loaded.
        // Any code that requires map data may not work as expected until this event is received.
        Log.d(TAG, "HERE Rendering Engine attached.");
    }
});

ほとんどの場合、このイベントを待つ必要はありません。 たとえば、マップアイテムはいつでも追加できます。 HERE Rendering Engine が添付されると、マップが表示されます。 マップ ビューからのマップアイテムの選択など、マップ データがこのイベントを待機して期待どおりの結果を得る必要があるコードのみが含まれます。

未使用のフォントファイルを削除

HERE SDK には、サポートされているすべての言語のマップラベルをレンダリングするためのフォントファイルが複数含まれています。 アプリ 全体のサイズを最適化する場合は、選択したフォントを削除できます。

たとえば 、フォントDroidSansFallback では、共有の Unicode コードポイントに簡体字中国語の表意文字が使用されます。 HERE SDK AAR ファイルにパッケージ化されています ( ファイル名に「 .zip 」を追加することで開くことができます ) 。

• assets/geoviz/DroidSansFallback.ttf

別の例として、日本語文字の完全なセットをレンダリングする必要がない場合は、次を削除できます。

• assets/geoviz/NotoSansJP-Regular.otf

Navigate Edition には voice_package_ar-SA 、 TTS エンジンで使用するガイダンス付きのテキストの生成などの音声パッケージが含まれているなど、他のファイルを削除することもできます。

ファイルを削除するに build.gradle は、アプリのファイルを編集する必要があります。 android { ... } セクションでaaptOptionsを追加次の例は、上記の 3 つのファイル例でこの操作を行う方法を示しています。

android {
  ...
  aaptOptions {
    ignoreAssetsPattern "!voice_package_ar-SA*:!DroidSansFallback.ttf:!NotoSansJP-Regular.otf"
  }  
  ...
}

フォントファイルのサイズは、数百キロバイトから数メガバイトの範囲になることがあります。 選択したフォントを削除すると、アプリケーションがデバイスにインストールされたときに消費されるスペースが少なくなります。 これらの手順で節約できる最大容量は約 11 MB です。

マップの言語を設定

マップで使用する言語をカスタマイズして、道路、都市、その他のマップ データのラベルを表示できます。 既定では、リージョンのローカル言語が使用されます。

MapView.setPrimaryLanguage(languageCode)を呼び出して世界の言語を設定するか、nullを呼び出してデフォルトの動作に戻します。これ MapViewにより、のすべてのインスタンスの言語が設定されます。 言語が世界のどのリージョンでもサポートされていない場合は、そのリージョンのローカル言語が代わりに表示されます。

地政学的見解

HERE SDK では、複数の地理的な政治的見解および異議を申し立てた境界をサポートしており、国際ビュー（デフォルト）またはローカルの国ビューに基づいてマップの境界を表示します。 ローカルビューは、 2 つ以上の政治組織（通常は国）が国境および所有権または支配権を主張する場合に、マップ上の特定の領域にのみ影響を与えます。

SDKOptions経由でアクセスできる politicalView メンバーの 3 文字の言語コードを設定することで、デフォルトの地政学的ビューを変更できます。サポートされている国コードは、カバレッジページからアクセスできます。

設定すると、マップ ビューには設定されている国の地政学的見解に従ってすべての国の境界が表示され、MapView にはそれに応じて国境が表示されます。

このフィーチャはベータ版としてリリースされています。

実行時に地政学的ビューを変更する場合は、次のコード スニペット を使用します。

// Optionally, clear the cache, so that changing the options has an immediate effect.
SDKCache.fromEngine(SDKNativeEngine.getSharedInstance()).clearCache(error -> {
    if (error != null) {
      // ...
    }
});

SDKOptions options = SDKNativeEngine.getSharedInstance().getOptions();
options.politicalView = "ARG";
SDKNativeEngine.getSharedInstance().dispose();

// Now initialize the HERE SDK again using the new options.

新しいオプションを設定するには、新しい共有インスタンスを作成する必要もあるため、進行中の HERE SDK 操作ではこのオプションを呼び出さないでください。 理想 的には、アプリのライフサイクル中に HERE SDK を初めて初期化する前に、オプションとpoliticalViewを 1 回のみ設定します。

マップ データの可用性

デフォルトでは、日本、中国、韓国などの世界の一部のリージョンには、限定的なマップ データ が含まれています。 マップ データ の全てのフィーチャにアクセスするには、HERE の担当者に連絡してください。

マップ データ形式

HERE SDK では、すべての種類のデータがマップタイルに保存されます。 これには、マップ ビュー でのレンダリングの目的で必要なデータが含まれている場合がありますが、これに限定されるものではありません。 たとえば、マップタイルには、マップ ビュー には表示されないが、ターン・バイ・ターンナビ　（矢印ナビ） などの他の目的で必要な場所または道路の属性に関するデータも含まれています。

マップ タイル に保存されている情報は、交通情報やランドマークなどの個別のトピックの情報を保持する複数のレイヤーに分類されます。

• Navigate Edition では、フードの下で 最適化されたクライアントマップ (OCM) カタログ形式を使用して、コンパクトで高速かつ柔軟なマップを提供しています。 OCM カタログは、 HERE Map Content （ HMC ）からコンパイルされます。
• 内部的には、 Explore Edition は オフラインユースケースをサポートしていない若干異なるマップ形式（ビジュアル化に最適化したマップ）を使用します。

マップのキャッシュを調整

オンラインおよびオフラインのユースケースをより適切にサポートするために、 HERE SDK はダウンロードされたベクターマップ データのキャッシュをサポートしています。 これはバックグラウンドで発生します。 マップの操作中、データはローカルのデバイスに保存され、デバイスの接続が失われたり、オフライン モードで操作されたりした場合でもアクセスできます。

統合されたマップ キャッシュ メカニズムは、標準のベクターベースのマップ スキームをサポートしています。衛星画像やその他のラスター タイルもキャッシュされますが、構成できない別のキャッシュにあります。

キャッシュされたデータの量には制限があり、マップの使用中に新しいマップデータで上書きされることに注意してください。ほとんどの場合、アプリを以前と同じ場所で再起動したときに追加のデータをダウンロードする必要がないため、これでユーザーは起動時間が短縮されたように感じることができます。

キャッシュがいっぱいになる と、 LRU （ Least Recently Used ）方式が適用されます。

SDKOptionsを使用して HERE SDK を手動で初期化する場合、絶対キャッシュパスと最大サイズを指定できます。 キャッシュパスは AndroidManifest ファイルを介して設定することもできます。 詳細については、「エンジン」セクションを参照してください。

注 : 顧客のラスタレイヤには、別のキャッシュを定義できます。

マップキャッシュを消去するには、次の手順を実行します。

SDKCache.fromEngine(SDKNativeEngine.getSharedInstance()).clearCache(error -> {
    if (error != null) {
        // ...
    }
});

SDKNativeEngineの共有インスタンスを廃棄しても、キャッシュは消去されません。

空の文字列をキャッシュパスとして設定すると、デフォルトのキャッシュパスが保持されます。このパスには context.getCacheDir().getPath() 、または SDKNativeEngine.getSharedInstance().getOptions().cachePathを使用してアクセスすることもできます。

// Specify credentials programmatically and keep default cache path by setting an empty string.
SDKOptions sdkOptions = new SDKOptions("YOUR_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_SECRET", "");

AndroidManifest.xmlファイルからキャッシュパスを指定することもできます。 SDKNativeEngine 例については、 API リファレンス を参照してください。

マップキャッシュに関する質問と回答

• マップ タイル とは： マップタイルはマップキャッシュに保存されます。 マップ タイル には、検索とルーティングに関連するデータと、ビジュアルリプレゼンテーションのベクターデータが含まれています。 最適化されたクライアントマップ（ OCM ） 形式で保存されます。 マップのタイルは、さまざまなズームレベルで使用できます。 マップ タイル には、ズーム レベル によって異なるデータが含まれている場合があります。

• マップキャッシュ内のデータが失われた場合、どのような影響がありますか？ 通常、マップキャッシュが完了しているとは見なされず、周囲の領域にタイルが失われることがあります。 これは、マップタイルがレンダリングされている間にオンデマンドでのみロードされるためです。 マップキャッシュに不足しているタイルがある場合 、たとえば、OfflineSearchEngineが不足しているタイルの一部である POI や道路名を見つけられず、 HERE Rendering Engine はそのようなデータをレンダリングできません。また、 不足しているタイルの周りにルートが見つからない場合、 OfflineRoutingEngineが失敗することがあります。 OfflineSearchEngine および OfflineRoutingEngine は、すべてのエディションで使用できるわけではありません。

• マップキャッシュのサイズを指定してください。 マップキャッシュのサイズは、アプリケーションによって変更できます。 256 MB 以上を使用してください ( デフォルト ) 。 512 MB 以上または 1 GB を推奨します。 ターン・バイ・ターンナビ　（矢印ナビ） （などで利用可能 Navigate Edition）の場合、ズーム レベル 14 のマップタイルが必要です。このタイルは、約 2 km の円に相当します ただし、場所によって多少異なる場合があります。

• キャッシュの削除ポリシーは何ですか ? HERE SDK は LRU （ Least Recently Used タイル ）ロジックを使用して、マップキャッシュがいっぱいになったときにタイルを削除します。 たとえば、現在の場所から離れた場所にあるタイルなど、削除する高度なロジックはありません。ユーザーが次に訪問する可能性のある世界の領域は予測できないからです。 ただし、マップキャッシュは セッション固有のものではありません。このキャッシュのデータは、最後の電源サイクルから最後にデバイスが使用されたときのものであり、次回アプリ が使用されたときからまだ残っています。 キャッシュは、デバイスごとではなく、アプリ ごとに固有のものであることに注意してください。

• キャッシュ済みのマップ タイル はオフラインで検索できますか ? はい、OfflineSearchEngineでは常に検索できます。 ただし、すべてのマップ タイル にすべてのズーム レベル の同じ検索結果が含まれているわけではありません。 OfflineSearchEngine は 、すべてのエディションで使用できるわけではありません。

• 一度にキャッシュされるマップ タイル は 1 つだけですか ? はい。位置が 2 つのタイルの端にない限り、一度に追加できるタイル は 1 つだけです。 ズーム レベル によっては、マップ ビュー のレンダリングに複数のタイルが必要になります。この処理は、ズーム レベル が変更された場合にのみ自動的には行われません。

• 衛星画像はキャッシュされていますか？ はい。衛星マップ スキームが設定されている場合、対応する画像もキャッシュされますが、衛星画像は 1 日後 ( 契約上の理由により ) は使用できず、削除されます。 この場合、 HERE SDK は利用可能な新しい衛星マップタイルがあるかどうかを確認し、利用可能な場合はキャッシュ内のイメージが自動的に更新されます。 画像が変更されていない場合は、タイムスタンプのみが更新され、このチェック後に 1 日の別の期間にわたって画像を再利用できます。 ただし、 LRU 戦略は引き続き適用されます。 非衛星のマップタイルは 、キャッシュがいっぱいの場合にのみ削除されます。古いタイルの古さや、時間に基づいて古いタイルが自動的に削除されることはありません。

• 地球儀のような「ベース マップ 」はいつでも利用できますか？ HERE SDK は、自動的に世界のタイル、つまり世界で最も多いズーム レベル タイルをダウンロードします。 これは、レンダリングの目的で非常に限られた量の情報を使用して、世界中で利用できるマップが常に存在することを意味します。 国や大陸の形が表示され、大文字がテキストラベルで表示されます。

• キャッシュは自動的に消去されますか ? いいえ、フルキャッシュは LRU 戦略に基づいてのみ消去されます ( 上記を参照 ) 。 接続が中断されたためにタイルが完全にダウンロードされていない場合、これらのタイルは保持され、接続が再開されたときにダウンロードが続行されます。

• 接続が利用可能な場合、ルート全体が事前にキャッシュされますか。 いいえ、自動的には発生しません。 ただし、RoutePrefetcher を使用して、ルート経路沿いのキャッシュにマップ データ をダウンロードできます。 詳細については、ターン・バイ・ターンナビ　（矢印ナビ） セクションを参照してください。 RoutePrefetcherは、すべてのエディションで使用できるわけではありません。

HERE Logo Watermark

HERE SDK を使用する場合は、 HERE ロゴがマップ ビューに常に表示されていることが必要です。 既定では、 HERE ロゴはマップの右下隅にあります。 ただし 、マップ ビューインスタンスでsetWatermarkLocation()を呼び出すことで、アプリの設計に合わせてその場所を簡単にカスタマイズできます。 UI 要素が重複しているため、必要な場合にのみ既定の配置を変更することをお勧めします。 非常に小さいビューの場合の注意 : マップの両端の濃度が 250 の独立したピクセルサイズ未満の場合、透かしは自動的に非表示になります。

サーフェスビューまたはテクスチャビューを選択

MapViewは、アプリケーションのニーズに応じて、 2 つのネイティブレンダリングモードをサポートしています。

• デフォルトでは、MapRenderMode.SURFACE が使用されます。これは最高のパフォーマンスを提供しますが、 Android 12 以降で発生するグラフィックの問題に影響を与える可能性があります。
• 複雑で動的な UI を使用するアプリケーション、または複数のインスタンスMapView を使用するアプリケーションでは、グラフィカルなグリッチを避けるためにMapRenderMode.TEXTURE を使用することを検討してください。 このモードは、デフォルト SurfaceViewよりもパフォーマンスに大きな影響を与える可能性があります。

HereMapOptions.renderMode経由で MapRenderMode を選択すると、レンダリング用にネイティブ SurfaceViewまたは TextureViewを内部的に設定できます。

Android Auto のサポートを追加

HERE SDK は 、 Android Auto および Android Automotive とシームレスに統合できます。

たとえば、 HERE SDK のプレミアムオフラインおよびオンライン検索機能を使用して、車の中の場所を検索したり、本格的なナビゲーションソリューションを統合したりできます。 デスクトップヘッドユニットにマップ ビュー を表示する場合は、インスタンスMapSurfaceを使用してマップをレンダリングする必要があります。 「 HERE マップを Android Auto に統合する 」チュートリアルに従って、この方法を確認してください。