事前定義されたマップスキームを追加する

事前定義されたマップスキームをロードする

マップスキームを使用すると、事前定義されたマップスタイルを読み込んで、マップビューの外観を即座に変更できます。

HERE SDKは、いくつかの事前設定済みのマップスキームをサポートしています。

NORMAL_DAY：昼間の使用に適したロスレススケーラブルベクターベースマップです。
NORMAL_NIGHT：夜間の使用に適したロスレススケーラブルベクターベースマップです。
HYBRID_DAY：衛星画像と、ベクターストリートネットワーク、マップラベル、POI 情報を組み合わせたハイブリッドマップスキームの昼間バージョンです。
HYBRID_NIGHT：衛星画像と、ベクターストリートネットワーク、マップラベル、POI 情報を組み合わせたハイブリッドマップスキームの夜間バージョンです。
LITE_DAY：Lite マップスキーム NORMAL_DAY の簡易版の昼間バージョンです。マップ要素が少なく、カラーパレットが限定されています。
LITE_NIGHT：Lite マップスキーム NORMAL_NIGHT の簡易版の夜間バージョンです。マップ要素が少なく、カラーパレットが限定されています。
LITE_HYBRID_DAY：Lite ハイブリッドマップスキーム HYBRID_DAY の簡易版の昼間バージョンです。マップ要素が少なく、カラーパレットが限定されています。
LITE_HYBRID_NIGHT：Lite ハイブリッドマップスキーム HYBRID_NIGHT の簡易版の夜間バージョンです。マップ要素が少なく、カラーパレットが限定されています。
LOGISTICS_DAY：フリートマネジメントのコンテンツに焦点を当てた、昼間バージョンのマップスキームです。特定の POI アイコンを使用して、トラック駐車場やトラック洗車などを表示することもできます。これらのアイコンは選択可能です。
LOGISTICS_NIGHT：夜間バージョンの LOGISTICS_DAY マップスキームです。
LOGISTICS_HYBRID_DAY：物流ユースケースに関連する地図要素を強調してフィーチャーする、ディスパッチャ、運行管理者、配送ドライバーのニーズに応えた昼間バージョンの物流ハイブリッドマップスキームです。
LOGISTICS_HYBRID_NIGHT：夜間バージョンの LOGISTICS_HYBRID_DAY マップスキームです。
SATELLITE：さまざまなズーム段階の衛星画像を表示するビットマップベースの地図です。
ROAD_NETWORK_DAY：ラベルや建物などの他のコンテンツを表示せずに道路を強調する、昼間バージョンのスキームです。これを使用すると、追加で小さい地図をズームイン表示させてナビゲーション中にドライバーを案内したり、このマップスキーム上に強調表示される運転操作矢印に注目させたりできます。
ROAD_NETWORK_NIGHT：夜間バージョンの ROAD_NETWORK_DAY マップスキームです。
TOPO_DAY：標高、地形、自然景観などの地理的特徴を強調表示し、地形を明確に表現する、昼間バージョンのマップスキームです (Navigateライセンスでのみ使用可能)。
TOPO_NIGHT：夜間バージョンのTOPO_DAYマップスキームです (Navigateライセンスでのみ使用可能)。

注

各MapSchemeの最新のスクリーンショットについては、HERE Style Editorドキュメントの「HERE default map styles」(HEREのデフォルトのマップスタイル) を参照してください。

衛星ベースのマップスキームは、HERE Raster Tile APIに基づいています。HERE Raster Tile APIに基づくトランザクションの例：衛星ベースのマップスキーム (SATELLITE、HYBRID_DAY、HYBRID_NIGHT、LITE_HYBRID_DAY、LITE_HYBRID_NIGHT) をマップビューにレンダリングします。

HERE SDK (Explore) の場合、MapViewとその他のすべてのマップスキームは、HERE Vector Tile APIとOMVベクタータイルの組み合わせに基づいています。

HERE SDK (Navigate) の場合、MapViewとその他のすべてのマップスキームは、Data IOとOCMベクタータイルの組み合わせに基づいています。これは、マップデータがキャッシュ、プリフェッチ、またはインストールされていない場合にオンラインで使用する場合に適用されます。データIOは、MapDownloaderまたはMapUpdaterを使用してオフラインマップをダウンロードまたは更新する際にもカウントされます。HERE SDK (Navigate) にのみ適用されます。

注

これらの機能の価格については、「HERE基本プランの価格表」を参照してください。Navigateライセンスを使用している場合、または価格についてご質問がある場合は、お問い合わせください。

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

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());
        }
    }
});

val mapScheme = MapScheme.NORMAL_DAY

mapView!!.mapScene.loadScene(mapScheme) { mapError ->
    if (mapError == null) {
        // ...
    } else {
        Log.d(TAG, "Loading of map scheme failed: mapError: " + mapError.name)
    }
}

周囲の光が明るい日中は、day のバリエーションを使用することをお勧めします。nightのバリエーションは、光が少ないときの使用に最適化されています。たとえば、ドライバーがトンネルを通過しているときにアプリケーションを昼間スキームから夜間スキームに切り替えることができます。HERE SDK (Navigate) を使用している場合、ドライバーは道路属性の変更について通知され、トンネルを通過していることを知ることができます。これにより、アプリケーションはマップスキームをその場で切り替えることができます。これは自動的には行われないことに注意してください。

また、HERE SDK は現在の時刻を自動的に検出して、昼間モードと夜間モードを切り替えることはありません。アプリケーションは、ユーザーの設定に基づいて、またはデバイスの時計をチェックすることによって、切り替えを実行します。