利用開始

このガイドでは、 HERE SDK を使用してアプリを構築するための最初のステップについて説明します。 HERE SDK は、 HERE platform からモバイルアプリケーションに最適な最新のアセットを提供できるようにカスタマイズされています。

作業を開始する前に、以下の内容を確認してください。

• このエディションについて
• 最小要件
• サポートされているデバイス

HERE SDK パッケージの入手

• HERE Platform Portalで登録またはサインインし、HERE SDK パッケージをダウンロードします。 任意のエディションを参照し、 [ 今すぐ取得 ] ボタンをクリックします。 パッケージはバックグラウンドでダウンロードされます。 しばらくお待ちください。

ご利用のプランに応じ て、 HERE SDK は、 1 か月あたりのトランザクション数および月間アクティブユーザー (MAU) などのその他のパラメータに基づいて請求されます。

資格情報の取得

HERE SDK でアプリ を認証するには、次の 2 つの文字列が必要です。

• アクセスキー ID (AccessKeyId):アカウントの一意の ID 。
• アクセスキーシークレット (AccessKeySecret): 秘密キー。作成時に 1 回だけ表示されます。 ページから移動する前に、メモしておいてください。

HERE SDK を使用するために、他の資格情報 またはトークンは必要ありません。

資格情報は、 GitHub にあるすべてのサンプルアプリで動作します。 Navigate Edition の 場合、 HERE の担当者に連絡して、一連の評価資格情報 を生成する必要があります。

資格情報 を取得すると、 HERE .client.id または アプリ ID も 表示されます。 これらの ID は、 HERE SDK の公開 API では必要ありませんが、 HERE サポートチームに連絡する場合に役立ちます。

アプリの資格情報の設定方法の詳細については、以下の「アプリケーションの認証」セクションも参照してください。

アプリ 資格情報 およびプロジェクトの範囲

複数のアプリに同じ資格情報を使用する予定の場合は 、システム内のアプリを差別化する範囲を設定する必要があります。 資格情報を単一のアプリにのみ使用する場合は、この操作は不要です。

サンプルアプリの試用

利用開始をする最も簡単 な方法は、 HERE SDK で利用できる多くのサンプルプロジェクトのいずれかを試すことです。

好みの例を選択してから、次の操作を行います。

1. HERE SDK フレームワークの追加 アプリのルートフォルダーにフォルダーheresdk.xcframeworkをコピーします。 このフォルダには、 1 つのファイルInfo.plistと 2 つのフォルダ (ios-arm64,ios-arm64_x86_64-simulator) を含む、より多くのファイルが含まれていることに注意してください。
2. HERE Credentials (AccessKeyId および AccessKeySecret) を プロジェクトのファイル AppDelegate.swiftに追加します。

これで、 Xcode プロジェクトを開く準備 ができました。また、お使いのデバイスまたはシミュレータでアプリを即座に実行できます。

サンプルのコードを自由に試用以下のガイドを参照して、 HERE SDK でアプリを開発する方法についてより詳細に説明することもできます。

新しい iOS プロジェクトの作成

最初のステップバイステップの例として、 -yes を表示する "Hello Map" iOS アプリケーションを開発します。 - 地図。 SDK を既存のアプリケーションに統合する場合は、この手順を省略できます。 特定の SDK コードはここには含まれていません。 Xcode を IDE として使用することをお勧めします。 iOS の開発に慣れていない場合 は、 developer.apple.com のガイドに従って、最初のステップを実行してください。

Xcodeを起動し(このガイドではバージョン14.2を使用しています)、 新しいXcodeプロジェクトを作成します。

• テンプレートで は、 iOS => Application => Single View アプリを選択するだけで十分です。
• [ 次へ ] をクリックし
• プロジェクト名を入力します ( 例 : ) 「 HelloMap 」と入力し 、言語として Swift を選択します。
• 「次へ」をクリックして、プロジェクトを保存する適切なディレクトリを選択します。

新しく作成したプロジェクトで 、アプリケーションの実行先としてシミュレータまたは実際の機器 ( 推奨 ) を選択します。

以下の例では、デフォルトの方向設定を保持しています。 既存のサンプルアプリを実行する場合 は、展開ターゲットがインストール済みのバージョンに設定されていることを確認してください。 iOS 12.4 が使用されています。

ここで 、現在のスキームをビルドして実行 し、プレーンプロジェクトが期待どおりに実行されることを確認します。 すべて問題が解決した場合は、内容のない空白のビューが表示されます。

Hello Map!の表示

iOS アプリが動作するようになったら、 HERE SDK を追加して、シミュレータまたはデバイスにマップを表示します。 次のステップの概要を示します。

1. HERE SDKの統合
2. 必要な資格情報の設定
3. マップ ビューをコードで追加するか、ストーリーボードに追加
4. 最初のマップ シーンをロードするコードの追加

まず、最初のステップで、 HERE SDK をプロジェクトに追加する方法を確認しましょう。

HERE SDK の統合

On here-tech.skawa.fun you can find the latest release artifacts including the HERE SDK framework to include in your application (named xx.yy.zz.release_date).

heresdk.xcframework アプリのルートフォルダーにフォルダーをコピーします。 このフォルダには、 1 つのファイルInfo.plistと 2 つのフォルダ (ios-arm64,ios-arm64_x86_64-simulator) を含む、より多くのファイルが含まれていることに注意してください。

Xcode でApp targetのGeneral設定を開き、「Frameworks、Libraries、およびembedded content」セクションに heresdk.xcframework を追加します（「+」をクリックしてから、「Add other...」をクリックします）。-> 「Add files ... 」）。

HERE 資格情報の設定

HERE SDK を使用する場合は、一連の資格情報 でアプリケーションを認証する必要があります。

資格情報を手元に用意したら、HERE SDK を初期化する際に、プログラムで資格情報セットを追加します (次のステップを参照) 。

HERE SDK の初期化

HERE SDK は自動的には初期化されません。 代わりに、 HERE SDK を初期化する時点を自由に決定できます。 初期化はメインスレッドで同期的に行われ、約 100 ミリ秒かかります。

HERE SDK の機能を使用する前に、次のメソッドを実行して HERE SDK を初期化します。

private func initializeHERESDK() {
    // Set your credentials for the HERE SDK.
    let accessKeyID = "YOUR_ACCESS_KEY_ID"
    let accessKeySecret = "YOUR_ACCESS_KEY_SECRET"
    let options = SDKOptions(accessKeyId: accessKeyID, accessKeySecret: accessKeySecret)
    do {
        try SDKNativeEngine.makeSharedInstance(options: options)
    } catch let engineInstantiationError {
        fatalError("Failed to initialize the HERE SDK. Cause: \(engineInstantiationError)")
    }
}

キーとシークレットの正しい資格情報を入力してください。 を呼び出すことで、 makeSharedInstance() HERE SDK を使用するために必要なものをすべて初期化できます。 HERE SDK のコアクラスが呼び出され SDKNativeEngineます。 ボンネットの下では、このインスタンスは HERE SDK によって提供される他のエンジンによって使用されます。

メインスレッドでこのコードを呼び出してください。

以下に、レイアウトから MapView にアクセスする前に、 AppDelegateの application(_ application:launchOptions:)メソッドで initializeHERESDK() を呼び出す方法の例を示します。

initializeHERESDK()と同様に、 HERE SDK を廃棄してリソースを解放することもできます。

private func disposeHERESDK() {
    // Free HERE SDK resources before the application shuts down.
    // Usually, this should be called only on application termination.
    // Afterwards, the HERE SDK is no longer usable unless it is initialized again.
    SDKNativeEngine.sharedInstance = nil
}

以下に 、AppDelegateの applicationWillTerminate(application:) メソッドでdisposeHERESDK()を呼び出す方法の例を示します。

マップ ビューの追加

SDK がプロジェクトに統合され、必要な資格情報が追加されたので 、新しいインスタンスMapViewを追加できます。

これを行うには、 2 つの方法があります。 まず 、プログラムで MapViewを追加する方法を示します 。次に、 Storyboard を使用してMapViewを追加する方法を示します。

いずれの方法を選択した場合も 、次のモジュールのインポート行をファイルに追加する必要があります。ViewController.swift

import heresdk

マップ ビューをプログラムで追加

次の変数宣言をクラスViewControllerに追加して、マップ ビュー変数を追加します。

var mapView: MapView!

メソッドviewDidLoad()で、次のコードを追加してマップ ビューを初期化します。

override func viewDidLoad() {
    super.viewDidLoad()

    // Initialize MapView without a storyboard.
    mapView = MapView(frame: view.bounds)
    view.addSubview(mapView)
}

これにより、親ビューと同じサイズのMapViewになり、サブビューとして追加されます。

ストーリーボードにマップ ビューを追加

上記のようにプログラムによってMapViewを初期化するのでは なく、ストーリーボードを使用して Xcode の Interface Builder から UI を構築することをお勧めします。 この場合、上記の行を View Controller に追加する必要はありません。

代わりに、 Main.storyboard を開き、メインビュー (ViewController の下にネストされています ) を選択します。 Identity Inspectorの Custom Classで、MapViewと入力 します。 Moduleにheresdkと入力 します。

次に、アシスタントエディターを開き、 Ctrl キーを押しながらマップ ビューをクリックして、アウトレット を作成するために。ViewController にドラッグします。 アウトレットウィンドウがポップアップ表示されます。名前として、 mapView と入力し、 connect をクリックします。 これにより、 View Controller に次の行が追加されます。

@IBOutlet var mapView: MapView!

View Controller からIBOutletにアクセスできるようになり、使用できるようになりました。 この手順には、 SDK 固有のアクションは含まれていません。 MapView は、他の UIView アクションとまったく同じように動作します。

Swift UI を使用してマップ ビュー の追加

または、マップ ビュー と Swift UI を併用してください。

マップ ビューはサブクラス UIView です。このチュートリアルで示すように、 プロトコルUIViewRepresentableに準拠した SwiftUI ビューでビューをラップできます。

以下に、このプロトコルUIViewRepresentableに準拠した構造体を作成する方法を示します。

struct HelloMapSwiftUIView: UIViewRepresentable {

    // Conform to UIViewRepresentable protocol.
    func makeUIView(context: Context) -> MapView {
        let mapView = MapView()        
        return mapView
    }

    // Conform to UIViewRepresentable protocol.
    func updateUIView(_ mapView: MapView, context: Context) {
        // Do something with the map view.
    }

マップ シーンのロード

HERE SDK を使用するこの最初のアプリでは、 SDK に付属しているデフォルトのマップスタイルのいずれかをロードします。

ViewController の viewDidLoad()メソッドでは、次のコードを追加して、 マップ レンダリングスタイルnormalDayを表すマップ スキームを含むシーンを読み込みます

mapView.mapScene.loadScene(mapScheme: MapScheme.normalDay, completion: onLoadScene)

完了ハンドラとして、必要に応じて、シーンの読み込みが成功したことを通知するメソッドを実装できます。

// Completion handler when loading a map scene.
private func onLoadScene(mapError: MapError?) {
    guard mapError == nil else {
        print("Error: Map scene not loaded, \(String(describing: mapError))")
        return
    }

    // Configure the map.
    let camera = mapView.camera
    let distanceInMeters = MapMeasure(kind: .distance, value: 1000 * 10)
    camera.lookAt(point: GeoCoordinates(latitude: 52.518043, longitude: 13.405991),
                  zoom: distanceInMeters)
}

シーンの読み込みが完了すると、メインスレッドで完了ハンドラが呼び出されます。 nil 以外の MapError 値は、問題の内容を示します。

MapViewから Cameraにアクセスして 、マップを中央に配置する場所などのカスタムマップパラメータ、およびカメラから地球までの距離で指定されたズーム レベルを設定できます。

let camera = mapView.camera
let distanceInMeters = MapMeasure(kind: .distance, value: 1000 * 10)
camera.lookAt(point: GeoCoordinates(latitude: 52.518043, longitude: 13.405991),
              zoom: distanceInMeters)

演習として、上記のマップ スキームを次のよう に置き換えることができます。.satellite何を手に入れますか？ 通常の夜間 の設定など、他のマップの設定も試してみてください。

または、利用可能な地図レイヤーのいずれかを試してください。 たとえば、目立つランドマークのテクスチャ付き 3D モデルを有効にするには、次のコード行をアプリ に追加します。

mapView.mapScene.enableFeatures([MapFeatures.landmarks : MapFeatureModes.landmarksTextured])

また、クラスAppDelegateに次のものを追加することをお勧めします。

func applicationWillTerminate(_ application: UIApplication) {
    // Deinitializes map renderer and releases all of its resources.
    // All existing MapView instances will become invalid after this call.
    MapView.deinitialize()
    disposeHERESDK()
}

MapView.deinitialize()を呼び出す と 、アプリケーションの終了時に HERE Rendering Engine のリソースが解放されます。 の共有インスタンスを SDKNativeEngine に設定することも推奨されます nil。そのため、このインスタンスは保持されなくなり disposeHERESDK() ます。前述のように、 HERE メソッドを使用できます。

アプリが何らかの方法でシャットダウンしている場合 、 を廃棄する SDKNativeEngineことは必須ではありませんが、これを行っても害はありません。また、進行中の要求をキャンセルして HERE SDK サービスをシャットダウンすることをお勧めします。 一方、画面の 1 つのみが破壊され、アプリの他の部分がまだ HERE SDK を必要とする場合は、 HERE SDK を早期に廃棄しないように注意してください。 一般に、各画面の HERE SDK を個別に初期化 / 廃棄することもできます。

オプションで、MapView.pause()と MapView.resume() は、アクティブなアプリ内の非表示のマップ ビューのエネルギー消費を節約するためにアプリが GPU 呼び出しを停止するユースケースに使用できます。たとえば、タブ付きマップ ビューのインスタンスを切り替えるときや、スクロール可能なビューに複数のマップが保持されている場合などです。 インスタンスを表示します。このような場合にMapView.pause() と MapView.resume()が呼び出されると、次 のイベントハンドラ関数でアプリ がフォアグラウンドとバックグラウンドを切り替えるときにpause()とresume() も呼び出す必要があります。

func applicationWillResignActive(_ application: UIApplication) {
    MapView.pause()
}

func applicationDidBecomeActive(_ application: UIApplication) {
    MapView.resume()
}

最後 に、 View Controller の didReceiveMemoryWarning()を処理することをお勧めします。 HERE SDK で は、未使用のリソースが OS から要求されたときに安全にクリーンアップする方法handleLowMemory()を提供します。

override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
    mapView.handleLowMemory()
}

次に、アプリを構築して実行します。 問題が解決した場合は、画面の全領域をカバーする HERE マップが表示されます。 おめでとうございます。 HERE SDK for iOS の使用に関する最初のステップを習得しました。

配布用にアプリを準備

HERE SDK フレームワーク (hersdk.xcframework) はファットバイナリではありませんが、デバイス (arm64) および シミュレータ (x86_64) 用に構築された複数のアーキテクチャのフレームワークのセットが含まれています。 そのため、複数のアーキテクチャが含まれています。 これにより、シミュレータ および 実際のデバイスに簡単に展開できます。 また、Xcode のクラッシュを表すデバッグシンボル (dSYM) も含まれています。 dSYM ファイルを使用してクラッシュ HERE をシンボル化する方法については、その他の詳細情報を参照してください。

HERE SDK フレームワークは Apple の XCFramework バンドルタイプ(XCFW) に準拠しているため、アプリの配布に使用できます。Xcode で IPA （ iOS アプリ ストアパッケージ）ファイルを作成するには、次の手順を実行します。

1. IPA を作成する前に、アプリに適した配布証明書とプロビジョニングプロファイルがあることを確認してください。これらの情報は、 Apple Developer ポータルから入手できます。 配布証明書をキーチェーンにインストールし、コンピュータにプロビジョニングプロファイルをダウンロードします。
2. Xcode でプロジェクトを開きます。 Xcode でアプリの .xcodeproj ファイルまたは .xcworkspace ファイルを開きます。
3. Xcode ウィンドウの左上隅で、アクティブなスキームのドロップダウンメニュー ( PlayボタンとStopボタンの横 ) を選択します。 IPA を構築するターゲットデバイスまたはシミュレータを選択します。
4. プロジェクトナビゲータ ( 左側のサイドバー ) でプロジェクトを選択し、「Signing & Capabilities」タブに移動します。 [ signing ] セクションで開発チームを選択し、 [ Automatically manage signing ] チェックボックスがオンになっていることを確認します。 Xcode が適切なプロビジョニングプロファイルを選択します。
5. Project Navigatorでプロジェクトをクリックし、上部のメニューの [ Edit Scheme ] をクリックします。 Schema Editorで、「Run」アクションを選択し、「Build Configuration」ドロップダウンを「Release」に設定します。 [ Close ] をクリックして変更内容を保存します。
6. IPA を作成するには、プロジェクトをアーカイブする必要があります。 Xcode のトップメニューで、「 Product 」をクリックし、「 Clean Build Folder 」を選択してプロジェクトを消去します。 次に、「Product」をもう一度クリックし、「Archive」を選択してプロジェクトのアーカイブを作成します。
7. アーカイブ処理が完了すると、「Organizer」ウィンドウが表示されます。 左側の列でアーカイブを選択し、右側の [Distribute App ( アプリの配布 )] ボタンをクリックします。 配布方法として「App Store　Connect」を選択し、「Next」をクリックします。 IPA を直接アプリストア接続にアップロードするか、コンピューターに保存するかに応じて、 [ Upload ] または [ Export ] を選択します。

Xcode で は、アプリに署名する開発チームを選択し、 汎用 iOS デバイス を選択 して、 [ Product ] -> [Archive] を選択する必要があります。

ターゲットデバイス用にエクスポートされたアプリ(つまり、結果のIPA)のバイナリサイズは、占有するスペースが少なくなります。 不要なファイルを手動で削除することもできます。 ただし、アーカイブ時に明示的に除外しない限り、IPAにはすべてのアーキテクチャが含まれていることに注意してください。 デバイス上の実際のサイズははるかに少ないスペースを占有し、Appleは必要なアーキテクチャのみを含めることを保証します。 したがって、App Storeからの実際のダウンロードサイズも はるかに小さくなります。 このXcodeガイドも参照してください。 そのため、App Storeを介してアプリをデプロイする場合は、HERE SDKフレームワークをそのまま使用することをお勧めします。デプロイプロセスの一部としてすべてのサイズの最適化が自動的に行われるためです。

トラブルシューティング

問題が発生した場合 は、まず最小要件とサポートされているデバイスを確認してください。

• 空白の白いマップのみが表示されます。 ご利用の HERE Credentials が有効で、 上記の「利用開始 」セクションの説明に従って設定されていることを確認してください。 また、ご利用のデバイスがインターネットに接続できることを確認してください。 インターネット接続が遅い場合、最初にロードされたマップのタイルが表示されるまでにしばらくかかることがあります。 また、デバイスの時刻が正しく設定されていることを確認してください。 まれに、デバイスの時間が正しく設定されていないと、一部のバックエンドサービスで認証の問題が発生する可能性があります。
• ログに「No map content will be displayed until valid config is provided.」と表示されます。 コードが実際に loadScene()を呼び出していることを確認
• Xcode から MapView 不明なエラーが発生しました : 上記の「利用開始」の項で説明されているように、 HERE SDK フレームワークを統合してください。
• Xcode では、heresdkのモジュール定義はロードしません。 これは、rdar://42087654として知られている Xcode SourceKit エラーです。 上記の「利用開始」の項で説明されているように、 HERE SDK フレームワークを統合してください。 また、プロジェクトおよびフレームワークへのパスにスペース記号が含まれていないことを確認してください。
• Xcode はシミュレータのプロジェクトをコンパイルしていません。 M1 チップを搭載したコンピューターを使用しています。 4.9.2.0 よりも前の HERE SDK バージョンを使用しています。 新しい HERE SDK バージョンを使用するか、Xcode 内の Build Settings/Architectures/Excluded Architectures/Debug設定で「Any iOS Simulator SDK」の arm64 アーキテクチャを除外して Rosetta モードで実行してみてください。「TARGETS」設定でこのオプションを選択します。 シミュレータを実行すると、パフォーマンスがわずかに低下することがあります。
• マップが表示されないか、 HERE SDK は何もコールしません。 「 These credentials do not authorize access 」というログメッセージが表示された場合は、資格情報 が有効ではありません。 資格情報 のワーキングセットを使用していることを確認してください。 3.x エディションの資格情報 には互換性がありません。 Explore Edition の資格情報は Navigate Edition と互換性がありません 。
• iOSリリース用にビルドすると、ビルドは失敗します。 実行されるログに-embed-bitcodeが表示された場合は 、bitcode optimizationを明示的に無効にしてください。 Appleはbitcodeを非推奨にし、HERE SDKはそれをサポートしなくなりました。 debug/release のXcodeビルド設定にENABLE_BITCODE = NO; を追加します。
• Xcode でアーカイブオプションがグレー表示になっているか、または無効になっています : 「Archive」オプションが無効になっている最も一般的な理由は、アクティブなスキームとしてシミュレータが選択されていることです。 物理デバイスがあるか、またはアクティブなスキームのドロップダウンメニューで [Generic iOS Deviceス（汎用デバイス） ] オプションが選択されていることを確認してください。 ワークスペースの設定に誤りがある可能性があります。 プロジェクトナビゲータでワークスペースをクリックし、「Edit Schema」をクリックします。 [ Build] タブで、ターゲットの [ Archive ] チェックボックスがオンになっていることを確認します。

サポートが必要な場合

この HERE 製品またはその他の 製品についてサポートが必要な場合は、次のいずれかのオプションを選択します。

• HERE の担当者がいる場合、質問や問題がある際には弊社担当者に問い合わせてください。
• If you manage your applications and accounts through here-tech.skawa.fun, log into your account and check the pages on the SLA report.
• Slack ワークスペースに参加してください。
• さらに質問がある場合は 、 stackoverflow.com/questions/tagged/here-api で回答を探すこともできます。
• 請求、アカウント、その他の情報についてご質問 がある場合は、こちらからお問い合わせください。
• HERE の販売店からプラン / 製品を購入した場合は、弊社販売店にお問い合わせください。