コンポーネント

コンポーネントは、HERE SDK APIを支える内部のビルディングブロックに基づいて作られた機能単位です。各コンポーネントは、ルート検索や検索などの特定の機能分野に焦点を当てています。コンポーネントは可能な限り分離されるように設計されているため、オンライン検索のみが必要な場合は、オフライン検索コンポーネントを完全に含める必要はありません。

モジュール化により、これらのモジュールはパブリックコンポーネントとして利用できるようになり、特定のニーズに合わせて(建設用レンガのように)組み合わせることができます。同時に、すでに使い慣れたHERE SDKのバンドル版オールインワンバージョンも引き続き提供しています。

注

HERE SDK (Navigate)は完全にサポートされていますが、すべてのコンポーネントがHERE SDK (Explore)と互換性があるわけではありません。さらに、マップビューはHERE SDK for Android (Navigate)でのみ個別のコンポーネントとして使用できます。

モジュール化のメリット

**必要なものだけを使用する:**ユースケースに関連するコンポーネントのみを選択します。こうすることで、アプリケーションのサイズが小さくなる可能性があります。ただし、一部のコンポーネントには依存関係があるため、常にそうなるとは限りません。たとえば、HERE Positioningのみを使用するアプリでは、バンドルされたHERE SDKを使用した場合は約85 MBになるのに対し、モジュール化では約32 MBになる可能性があります。

その他のメリット:

  • **API使用の制御:**アプリのコンセプトが明確であれば、開発チームで使用するAPIを特定のセットに限定して、複雑さや誤用の可能性を減らすことができます。
  • **ビルド時間の短縮:**依存関係ツリーが小さいと、特に反復開発時にコンパイル時間が短くなる可能性があります。
  • **より明確な依存関係:**どの機能が使用されており、何に依存しているかがわかりやすくなり、開発者やプロジェクト関係者にとっての透明性が向上します。

モジュール化を使用_すべきでない_ケース

モジュール化は強力ですが、すべてのプロジェクトにとって必ずしも正しい選択とは限りません。次のような場合は、バンドルされているHERE SDKをお勧めします。

  • **よりシンプルな統合エクスペリエンスが欲しい:**バンドルされているAndroid Archiveでは、HERE SDKのすべての機能が1つのパッケージにまとめられているため、セットアップがより簡単になります。
  • **どの機能が必要かわからない:**まだ検討中である場合やプロトタイプの作成中である場合は、完全なHERE SDKから始めると、依存関係を管理しなくてもすべてにアクセスできるようになるため、時間を節約できます。
  • **ビルドと依存関係の構成は少なくしたい:**バンドルされているHERE SDKを使用すると、複数のモジュールを管理したり、相互依存関係が発生したりすることを回避できます。

仕組み

コンポーネントはhttps://repo.platform.here.com/artifactory/here-sdk-androidにあるHEREのArtifactory Mavenリポジトリでホストされています。このリポジトリを指すようにプロジェクトのbuild.gradleを設定し、アプリに実際に必要なコンポーネントのみを宣言します。Mavenの組み込み依存関係管理では、コンポーネントの推移的な依存関係が自動的に解決されます。自分でリストする必要はありません。

たとえば、アプリにhere-sdk-search-onlineが必要な場合、here-sdk-coreはhere-sdk-search-onlineの依存関係として宣言されているため、Gradleにも自動的に取り込まれます。同様に、here-sdk-routing-offlineまたはhere-sdk-routing-onlineを追加するとhere-sdk-routing-coreが自動的に取り込まれます。

利用できるコンポーネント

主要な機能はすべてサポートされており、モジュールコンポーネントにまとめられています。これらのコンポーネントは、APIリファレンスに記載されている既存のパッケージとほぼ一致しています。

  • here-sdk-core:異なるモジュール間で共有されるコア機能を含む必須モジュール。Coreパッケージの機能が含まれています。
  • here-sdk-map-advanced:OCMデータに基づく高度なマップレンダラー(「HERE Rendering Engine」)。MapViewパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-map-data:OCMマップデータへのオフラインアクセスを提供します。たとえば、セグメントIDに基づくセグメント属性や、SegementDataLoader経由での地理座標周辺のセグメント属性などです。MapDataパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-map-loader:永続的なマップストレージへのオフラインOCMマップのインストールと更新を行います。MapLoaderパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-map-matcher:GPSやその他のセンサー入力(車載カメラなど)に基づくSDおよびHDマップのマッチングを担います。MapMatcherパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-map-loader-remote-connection:gRPC経由でマップデータを配信します。ExternalMapDataSourceパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-navigation:道路沿いのあらゆる種類の情報を提供する広範な警告システムとともに、ルートに沿ったヘッドレスガイダンスを提供します。Navigatorクラスが含まれています。ジャンクションビューも用意されています。Navigationパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-navigation-core:here-sdk-mapmatcher、here-sdk-electronic-horizon、here-sdk-navigationの各コンポーネント間で共有される機能を提供します。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-positioning:包括的な位置情報ソリューションを実装し、GPSやその他の全地球衛星測位システム(GNSS)レシーバー、モバイルネットワーク信号、Wi-Fiネットワーク信号などの複数の位置情報ソースと連携して正確な位置を特定します。LocationEngine経由でSDおよびHDポジショニングをサポートします(ハードウェアとカスタマーライセンスによって異なります)。Positioningパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-routing-core:here-sdk-routing-onlineモジュールとhere-sdk-routing-offlineモジュールの間で共有される機能を提供します。Routingパッケージのコア機能が含まれています。
  • here-sdk-routing-dynamic:現在の交通状況に基づいて、より適切なルートを計算します。DynamicRoutingEngineに関連する機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-routing-isoline:IsolineRoutingEngineを介したHERE Routing Serviceを使用して、中心点から到達可能なエリアを計算します。オンライン接続が必要です。IsolineRoutingEngineに関連する機能が含まれています。
  • here-sdk-routing-offline:A地点からB地点までのオフラインルートを計算します。OfflineRoutingEngineを介してダウンロード済みOCMデータを使用する、複数の経由地設定やローカライズ可能な右左折ごとの運転指示などの機能が含まれています。OfflineRoutingEngineに関連する機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-routing-online:A地点からB地点までのオンラインルートを計算します。RoutingEngineを介してHERE Routing Serviceを使用する、複数の経由地設定やローカライズ可能な右左折ごとの運転指示などの機能が含まれています。Routingパッケージの機能が含まれています。
  • here-sdk-routing-transit:地下鉄、電車、バスといった公共交通機関の車両のルートをTransitRoutingEngineを介して計算します。TransitRoutingEngineに関連する機能が含まれています。
  • here-sdk-search-offline:ダウンロードしたOCMデータに基づいて、OfflineSearchEngineを介してオフライン検索とジオコーディングを可能にします。OfflineSearchEngineに関連する機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-search-online:HERE Search Serviceを使用して、SearchEngineを介してオンライン検索とジオコーディングを可能にします。Searchパッケージの機能が含まれています。
  • here-sdk-traffic-broadcast:RDS-TMC形式を想定しており、インターネット接続がない場合でも使用できるため、HERE SDKはラジオチャネル経由で受信する交通データを利用できます。専用のハードウェアサポートが必要です。TrafficBroadcastパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-traffic:TrafficEngineを介してオンライン交通事案と交通流データをヘッドレス方式で提供します。Trafficパッケージの機能が含まれています。
  • here-sdk-visual-navigation:ヘッドレスhere-sdk-navigationコンポーネントと同じ機能を提供しますが、こちらではさらにさまざまなオプションの視覚要素を組み合わせた、事前設定された3Dマップビューエクスペリエンスを提供します。VisualNavigatorパッケージに関連する機能が含まれています。HERE SDK (Navigate)でのみ使用できます。
  • here-sdk-electronic-horizon:車両前方の地図情報ツリーのモデルを構築し、このツリーの位置を追跡します。注:ADASプロトコル(ADASISやPSDなど)は実装されません。Electronic Horizonパッケージの機能が含まれています。HERE SDK (Navigate)でのみ使用できます。

HERE SDKコンポーネントの依存関係

here-sdk-coreなど、一部のコンポーネントは常に必要ですが、他のコンポーネントには依存しません。ただし、他のコンポーネントには1つ以上の依存関係がある場合があります。以下の表は、Mavenが管理するこれらの関係の概要を示しています。

コンポーネント依存関係
here-sdk-core-
here-sdk-electronic-horizonhere-sdk-core,here-sdk-map-data,here-sdk-routing-core,here-sdk-navigation-core,here-sdk-map-loader
here-sdk-map-advancedhere-sdk-core,here-sdk-map-loader
here-sdk-map-datahere-sdk-core,here-sdk-map-loader,here-sdk-navigation-core
here-sdk-map-loaderhere-sdk-core
here-sdk-map-loader-remote-connectionhere-sdk-core,here-sdk-map-loader
here-sdk-map-matcherhere-sdk-core,here-sdk-map-loader,here-sdk-navigation-core,here-sdk-map-data
here-sdk-navigationhere-sdk-core,here-sdk-electronic-horizon,here-sdk-map-data,here-sdk-map-loader,here-sdk-map-matcher,here-sdk-navigation-core,here-sdk-routing-core,here-sdk-warner
here-sdk-navigation-corehere-sdk-core,here-sdk-map-loader,here-sdk-routing-core
here-sdk-positioninghere-sdk-core
here-sdk-routing-corehere-sdk-core
here-sdk-routing-dynamichere-sdk-core,here-sdk-navigation,here-sdk-navigation-core,here-sdk-routing-core,here-sdk-routing-online
here-sdk-routing-isolinehere-sdk-core,here-sdk-routing-core
here-sdk-routing-offlinehere-sdk-core,here-sdk-map-loader,here-sdk-routing-core
here-sdk-routing-onlinehere-sdk-core,here-sdk-routing-core
here-sdk-routing-transithere-sdk-core,here-sdk-routing-core
here-sdk-search-offlinehere-sdk-core,here-sdk-map-loader
here-sdk-search-onlinehere-sdk-core
here-sdk-traffichere-sdk-core,here-sdk-navigation-core
here-sdk-traffic-broadcasthere-sdk-core,here-sdk-routing-core,here-sdk-search-offline,here-sdk-map-loader
here-sdk-visual-navigationhere-sdk-core,here-sdk-navigation,here-sdk-navigation-core,here-sdk-map-advanced,here-sdk-map-matcher,here-sdk-routing-core,here-sdk-warner
here-sdk-warnerhere-sdk-core,here-sdk-electronic-horizon,here-sdk-map-data,here-sdk-navigation-core,here-sdk-routing-core,here-sdk-map-loader

サンプルアプリを試す

GitHubのTrafficサンプルアプリでは、Artifactoryから直接取得した必要なコンポーネント(here-sdk-map-advanced、here-sdk-routing-online、here-sdk-traffic)のみでアプリを構築する方法を示しています。build.gradleファイルでは、ローカルAARとArtifactoryコンポーネントを1つのフラグで切り替える方法が示されています。デフォルトでは、ローカルAARバンドルを使用するようにアプリが設定されています。このアプリのモジュール化サポートはHERE SDK (Navigate)でのみ利用可能であることに注意してください。マップビューはNavigateライセンスでのみ使用可能で、here-sdk-map-advancedではOCMを使用するのに対し、HERE SDK (Explore)は個別のコンポーネントとして利用できない別のマップ形式を必要とするためです。

統合手順

以下の手順に従って、Artifactoryベースのコンポーネントサポートを独自のアプリケーションに追加します。

ステップ1:Artifactory Mavenリポジトリを追加する

root-level build.gradleファイルを開き、HERE Artifactory Mavenリポジトリをallprojectsリポジトリブロック内に追加します。プレースホルダーの資格情報をhttps://platform.here.com/access/access-tokensから取得した値に置き換えます。

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            name = 'HERE_SDK_Artifactory_Repository'
            url = "https://repo.platform.here.com/artifactory/here-sdk-android"
            credentials {
                username = project.findProperty('HERESDKArtifactoryUsername') ?: "YOUR_USER_NAME"
                password = project.findProperty('HERESDKArtifactoryPassword') ?: "YOUR_ACCESS_TOKEN"
            }
            content {
                includeGroup "com.here.here-sdk.java.components"
            }
        }
    }
}
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            name = "HERE_SDK_Artifactory_Repository"
            url = uri("https://repo.platform.here.com/artifactory/here-sdk-android")
            credentials {
                username = providers.gradleProperty("HERESDKArtifactoryUsername").orNull ?: "YOUR_USER_NAME"
                password = providers.gradleProperty("HERESDKArtifactoryPassword").orNull ?: "YOUR_ACCESS_TOKEN"
            }
            content {
                includeGroup("com.here.here-sdk.java.components")
            }
        }
    }
}

contentブロックは、このリポジトリをHERE SDKコンポーネントアーティファクトのみに制限し、Gradleが関係のない依存関係をArtifactoryに照会しないようにします。

ステップ2:資格情報を安全に保存する

資格情報をバージョン管理にコミットすることは避けてください。代わりに、~/.gradle/gradle.propertiesにあるグローバルGradleプロパティファイルに保存してください。

HERESDKArtifactoryUsername=your_username
HERESDKArtifactoryPassword=your_access_token

Gradleはビルド時にproject.findProperty()を介してこれらの値を自動的に取得します。

ステップ3:アプリに必要なコンポーネントのみを宣言する

app-level build.gradleを開き、fileTree依存関係(存在する場合)をアプリに必要な特定のHERE SDKコンポーネントに置き換えます。依存関係を安定させるためにバージョンをハードコーディングします。YOUR_SDK_VERSIONを必要なHERE SDKバージョン(例:4.27.1.0)に置き換えます。

dependencies {
    // Declare only the HERE SDK components your app requires.
    // Maven resolves transitive component dependencies automatically.
    // IMPORTANT: Do not mix components of different versions.
    def hereSDKVersion = "YOUR_SDK_VERSION"
    implementation "com.here.here-sdk.java.components:here-sdk-map-advanced:${hereSDKVersion}"
    implementation "com.here.here-sdk.java.components:here-sdk-search-offline:${hereSDKVersion}"
    implementation "com.here.here-sdk.java.components:here-sdk-search-online:${hereSDKVersion}"
}
dependencies {
    // Declare only the HERE SDK components your app requires.
    // Maven resolves transitive component dependencies automatically.
    // IMPORTANT: Do not mix components of different versions.
    val hereSDKVersion = "YOUR_SDK_VERSION"
    implementation("com.here.here-sdk.java.components:here-sdk-map-advanced:$hereSDKVersion")
    implementation("com.here.here-sdk.java.components:here-sdk-search-offline:$hereSDKVersion")
    implementation("com.here.here-sdk.java.components:here-sdk-search-online:$hereSDKVersion")
}

アプリで直接使用するコンポーネントのみを一覧表示すれば十分です。推移的な依存関係(たとえば、here-sdk-search-onlineで必要なhere-sdk-core)は、Artifactoryに公開されたコンポーネントPOMファイルに基づいて、Gradleによって自動的に解決およびダウンロードされます。

ステップ4:同期とビルド

Android Studioで[File](ファイル)->[Sync Project Files with Gradle Files](プロジェクトファイルとGradleファイルを同期)の順に選択して、通常どおりプロジェクトを同期およびビルドします。または、以下を実行します。

./gradlew build

Gradleは宣言されたコンポーネントとその推移的な依存関係のみをArtifactoryから取得します。app/libsにAARファイルを配置する必要はありません。


このページは役に立ちましたか?