利用開始

このトピックでは、HERE SDKの利用を開始するための手順を紹介します。以下を行うには、指示に従ってください。

HERE SDKを使用するための資格情報を取得する。
HERE SDKパッケージをダウンロードする。
マシンのエミュレータで、基本的なHERE SDKを活用したサンプルアプリを実行する。

注

HERE SDK (Navigate) とHERE Navigationは別の製品です。HERE SDKは自動車業界や他の業種におけるさまざまなユースケースに対応し、カスタムアプリケーションの開発を可能にします。これに対して、HERE NavigationはHERE SDKを基盤として構築された自動車向けの既製ナビゲーションアプリケーションです。HERE Navigationをお求めの場合は、HERE営業担当にお問い合わせください。

資格情報を取得する (ExploreとNavigate)

HERE基本プランにサインアップすると、すぐにHERE SDK (Explore) を使用できます。Navigateライセンスでは、資格情報を有効にする前に追加のオンボーディング手順が必要になります。ニーズに合ったライセンスが不明な場合は、ライセンスの概要を確認し、HEREアカウントエグゼクティブにご相談のうえ、適切な料金プランを選択してください。

HERE SDKを使用するには、1つ以上のアプリを登録し、OAuth 2.0の資格情報 (Access key IDとAccess key secret) を取得する必要があります。

HERE基本プランにサインアップし、HEREプラットフォームポータルへのアクセス権を取得します。
HEREプラットフォームポータルにサインインします。
「OAuthによる認証」の手順に従って、OAuth2資格情報を取得します。注：必要なのは、OAuth 2.0資格情報のみです。OLP CLIをインストールしたりトークンを取得したりする必要はありません。
資格情報は常にアプリケーションIDに関連付けられています。HEREサポートチームに問い合わせる必要がある場合は、この情報を用意しておいてください。

HERE SDK (Explore) パッケージをダウンロードする

前の手順で作成した資格情報はExploreライセンスで有効なため、すぐに使用できます。

HERE SDK (Explore) パッケージをダウンロードして、アプリの構築を開始してください。

HERE SDK (Navigate) パッケージをダウンロードする

アクセス権を取得するにはお問い合わせください。NavigateパッケージはHERE Technologiesと契約を結んだお客様のみご利用いただけます。

注

アクセス権を待っている間に、同じAPIと機能のサブセットを提供するHERE SDK (Explore) を使用して構築を開始できます。

アクセス権を取得したら、次の手順に進みます。

アプリケーションIDを使用して、セールスポータルで見積もりを承認します。見積もりを承認するまで、資格情報はNavigateで使用できず、Navigateパッケージをダウンロードすることもできません。この手順に関してサポートが必要な場合は、HEREアカウントエグゼクティブにお問い合わせください。
前の手順を完了すると、HERE SDK (Navigate) パッケージをダウンロードできるようになります。

これで、Navigateライセンスを使用してアプリの構築を開始する準備ができました。

HERE SDKパッケージの内容

HERE SDK パッケージの内容は以下のとおりです。

Android Archive (AAR) (アプリに含める HERE SDK バイナリ)。
このガイド、API リファレンス、サンプルアプリ、JavaDoc バイナリ (HEREsdk-javadoc.jar) など、いくつかのドキュメントアセット。
HERE SDK を使用して作成されたすべてのアプリに含める必要がある HERE_NOTICE ファイル。詳細については、オープンソースに関する通知を参照してください。

バイナリはネイティブにコンパイルされたSDKです。ExploreバイナリはNavigateバイナリのサブセットであるため、NavigateバイナリはすべてのExploreサンプルアプリで動作しますが、その逆は当てはまらない場合があります。Navigate専用のAPIは、Exploreバイナリには含まれません。同様に、ChangelogとAPIリファレンスは各ライセンスに合わせて記載されており、対応するバイナリに一致しています。

資格情報は、HERE SDKパッケージおよびGitHubにある、該当ライセンス向けのすべてのサンプルアプリで使用できます。Navigateライセンスをお持ちの場合、資格情報はすべてのアプリと機能で使用できます。Exploreライセンスをお持ちの場合、資格情報はすべてのアプリで使用できますが、Navigateライセンスを必要とする一部の機能は使用できません。

Hello Mapサンプルアプリ (Java/Kotlin) を実行する

HERE SDKリリースパッケージに含まれる、GitHubで入手可能なサンプルアプリでは、HERE SDKの機能を包括的にプレビューすることができます。まずは、基本的なHelloMapのサンプルアプリをエミュレータで実行してください。次の手順を実行します。

Android Studioをインストールします。ダウンロードする場合はこちらのページにアクセスしてください。他の適切なIDEを使用することもできます。
HEREプラットフォームポータルからダウンロードしたHERE SDKリリースパッケージを解凍します。
サンプルアプリでアーカイブを解凍します。名前がexamples-VERSION_NUMBER.zipで終わるアーカイブです。
パッケージの一番上のディレクトリにある.aarファイルを/HelloMap/app/libsパスにコピーします。Kotlinアプリを使用する場合は、/HelloMapKotlin/app/libsパスにコピーします。
Android Studioを実行し、[Open project](プロジェクトを開く) オプションを使用して「HelloMap」サンプルアプリのフォルダーを開きます。
Android StudioでHelloMap/app/src/main/java/com/here/hellomap/MainActivity.javaファイルを開きます。Kotlinアプリを使用する場合は、HelloMapKotlin/app/src/main/kotlin/com/here/hellomap/MainActivity.ktファイルを開きます。
このファイル内で次のコードのプレースホルダーをお使いの資格情報に変更します。

// Set your credentials for the HERE SDK.
String accessKeyID = "YOUR_ACCESS_KEY_ID";
String accessKeySecret = "YOUR_ACCESS_KEY_SECRET";
AuthenticationMode authenticationMode = AuthenticationMode.withKeySecret(accessKeyID, accessKeySecret);
SDKOptions options = new SDKOptions(authenticationMode);

// Set your credentials for the HERE SDK.
val accessKeyID = "YOUR_ACCESS_KEY_ID"
val accessKeySecret = "YOUR_ACCESS_KEY_SECRET"
val authenticationMode = AuthenticationMode.withKeySecret(accessKeyID, accessKeySecret)
val options = SDKOptions(authenticationMode)

[Play](再生) ボタンを選択して、「HelloMap」アプリを構築し実行します。

Android Studioエミュレータで実行されているHEREマップを表示したアプリを確認できるようになります。または、お好みのAndroidデバイスでアプリを実行することもできます。

次にコードを試します。たとえば、MainActivityのloadMapScene()メソッドのMapScheme.NORMAL_DAYをMapScheme.SATELLITEに置き換えてみるなど、サンプルを修正してみます。また、他のマップスキームを試したり、利用可能なマップレイヤーを調べたりすることもできます。

SDKNativeEngineを初期化する方法、HERE SDKで作成したアプリの基本的なビルディングブロックについては、「HERE SDKを統合する」を参照してください。