利用開始

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

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

資格情報を取得する (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 パッケージの内容は以下のとおりです。

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

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

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

Hello Mapサンプルアプリを実行する

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

Xcodeをインストールします。ダウンロードするには、こちらのページにアクセスしてください。
HEREプラットフォームポータルからダウンロードしたHERE SDKリリースパッケージを解凍します。
サンプルアプリでアーカイブを解凍します。名前がexamples-VERSION_NUMBER.zipで終わるアーカイブです。
アプリのルートフォルダーにheresdk.xcframeworkフォルダーをコピーします。
プロジェクトファイルHelloMap/HelloMap.xcodeprojをダブルクリックしてXcodeを実行します。
XcodeでファイルHelloMap/HelloMap/HelloMapApp.swiftを開きます。
このファイル内で次のコードのプレースホルダーをお使いの資格情報に変更します。

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

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

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

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