here sdk examples

ここでSDK 4.x（Lite、Explore＆Navigate Edition） - Android、iOS、Flutterの例

このリポジトリでは、すぐに使用できるアプリケーションでここSDKの重要な機能を示す最新のアプリを見つけることができます。

ここのsdkについて

ここでは、SDKを使用すると、強力なロケーション認識アプリケーションを構築できます。迅速かつスムーズなマップと対話し、さまざまな解像度のマップビューをパン/ズームして、高度にカスタマイズ可能なマップビューでルートやPOIなどのさまざまな要素を表示できるようにします。

Here SDKは、ここでのプラットフォームからデータを消費し、マイクロサービスとモジュール化されたコンポーネントを組み込んだ最新の設計原則に従います。現在、ここでSDKはAndroid、iOS、Flutterの3つのプラットフォームをサポートしています。

既存の機能の概要については、選択したプラットフォームについては、開発者ガイドを確認してください。ここでは、多数のコードスニペット、詳細なチュートリアル、 APIリファレンス、最新リリースノートもあります。

• Android for the SDKのドキュメント（Lite Edition、Explore Edition、Navigate Edition）
• ここでiOSのSDKのドキュメント（Explore Edition、Navigate Edition）
• ここでSDK for Flutterのドキュメント（Explore Edition、Navigate Edition）

今のところ、 Navigate Editionはリクエストに応じてのみ利用できます。ここに連絡して、一連の評価資格情報を含むアクセスを受信して​​ください。

利用可能な例アプリのリスト（バージョン4.21.0.0）

• Hellomap ：古典的な「Hello World」を示しています。
• Hellomapkotlin ：Kotlin Language（Androidのみ）を使用して、古典的な「Hello World」を示しています。
• HellomapwithStoryboard ：ストーリーボード（iOSのみ）を使用して、クラシックな「Hello World」を表示します。
• Hellomapandroidauto ：Android AutoをHellomapアプリに統合して、車内ヘッドユニットディスプレイ（Androidのみ）にマップを表示する方法を示します。 Explore EditionとNavigate Editionでのみ利用できます。
• HellomapCarplay ：CarPlayをHellomapアプリに統合して、車内ヘッドユニットディスプレイ（iOSのみ）にマップを表示する方法を示しています。 Explore EditionとNavigate Editionでのみ利用できます。
• Hellomapsurface ：MapsSurfaceクラスを使用して、Mapの上にOpenGL ESを備えた低レベルのグラフィック要素をレンダリングする方法を示しています。 （Androidのみ）。 Explore EditionとNavigate Editionでのみ利用できます。
• カメラ：ターゲットとターゲットのアンカーポイントを変更する方法と、カスタムマップアニメーションを使用して別の場所に移動する方法を示しています。
• MapFeatures ：さまざまなマップビュー機能を有効にする方法を示します。 Navigate Edition （今のところAndroidのみ）でのみ利用できます。
• CamerakeyFrameTracks ：キーフレームトラックを使用してカスタムカメラアニメーションを行う方法を示しています。
• CustomMapStyles ：ここで作成されたカスタムマップスキームをロードする方法を示しています。 Explore EditionとNavigate Editionでのみ利用できます。
• CustomRasterLayers ：カスタムラスターレイヤーをロードする方法を示します。 Explore EditionとNavigate Editionでのみ利用できます。
• CustomRasterTilesource ：バックエンドからデータを取得する代わりに、実行時にカスタムラスターイメージをロード/作成する方法を示しているため、オフラインで動作するはずです。 Explore EditionとNavigate Editionでのみ利用できます。
• ジェスチャー：ジェスチャーを処理する方法を示します。
• OfflineMaps ：ここでSDKが完全にオフラインで動作する方法と、大陸や国のためにオフラインマップデータをダウンロードする方法を示しています。 Navigate Editionでのみ利用できます。
• MapItems ：サークル、ポリゴンとポリリン、ネイティブビュー、2Dおよび3Dマップマーカーを追加して、マップ上にPOIを見つける方法を示しています。 3Dマップマーカーは、Exploreおよびナビゲートエディションでのみ利用可能です。
• Multidisplays ：AndroidのMulti-Display APIを使用して、ここでSDKマップを2つの別々のディスプレイに表示する方法を示しています。 Explore EditionとNavigate Editionでのみ利用できます。
• OffScreenMap/OffScreenMapsSurface ：Map Viewを画面に配置することなく、ここでSDKを使用してマップの画像を生成する方法を示します。 Explore EditionおよびNavigate Edition （OffScreenMap：iOSのみ、OffScreenMapsSurface：Androidのみ）でのみ利用できます。
• Cartopoipicking ：拡張場所の詳細を備えた埋め込みマップマーカーを選択する方法を示します。デフォルトでは、すべてのマップで埋め込まれたマップマーカーがすでに表示されています。 Explore and Navigate Editionsでのみ利用できます。
• ルーティング：ルートを計算してマップに追加する方法を示します。
• RoutingHybrid ：ルートを計算してマップに追加する方法を示します。また、インターネット接続が利用できない場合、ルートをオフラインで計算する方法も示します。 Navigate Editionでのみ利用できます。
• EVROUTING ：電気自動車のルートを計算する方法と、アイソリンルーティングでリーチの面積を計算する方法を示しています。また、ルートに沿って検索する方法も示しています。
• 公共交通機関：地下鉄、列車、バスなどの公共交通機関のルートを計算する方法を示しています。
• 検索：POIを検索してマップに追加する方法を示します。また、ジオコーディングと逆ジオコーディングも示しています。
• SearchHybrid ：自動提案を含む場所、特定の地理的座標（リバースジオコーディング）に属するアドレス、およびアドレスに属する地理的座標（ジオコーディング）を検索する方法を示します。また、インターネット接続が利用できない場合、オフラインで検索する方法も示します。 Navigate Editionでのみ利用できます。
• NavigationQuickStart ：ターンバイターンナビゲーションの開始方法を示します。 Navigate Editionでのみ利用できます。
• ナビゲーション：利用可能なターンごとのナビゲーションと追跡機能の多くを実装する方法の概要を説明します。 Navigate Editionでのみ利用できます。
• NavigationCustom ：ガイダンスビューをカスタマイズする方法を示します。 Navigate Editionでのみ利用できます。
• SpatialAudionAvigation ：ガイダンス中にTTS声の空間オーディオ通知を使用する方法を示しています。 Navigate Editionでのみ利用できます。
• 再ルーティング：ここでのSDKを使用して、ガイダンス中に再ルーティングを処理する方法を示しています。 Navigate Edition （AndroidおよびiOSのみ）でのみ利用できます。
• ポジショニング：ここでのポジショニングを統合する方法を示しています。 Navigate Editionでのみ利用できます。
• Positioning withbackgroundUpdates ：フォアグラウンドサービスを使用してAndroidのバックグラウンドロケーションの更新をここに統合する方法を示します。 Navigate Editionでのみ利用できます。
• HikingDiary ：GPXトレースをここに配置する方法を示しています。 Navigate Editionでのみ利用できます。
• トラフィック：リアルタイムトラフィックの検索方法と、マップ上でそれを視覚化する方法を示しています。
• TruckGuidance ：ここのSDKを使用して、トラックに固有のルートを計算する方法を示します。さらに、より多くのトラック関連の機能を示しています。 Navigate Edition （AndroidおよびiOSのみ）でのみ利用できます。
• StandaloneEngine ：マップビューなしでエンジンの使用方法を示しています。
• Indoomap ：プライベート会場を統合する方法を示しています。 Navigate Editionでのみ利用できます。
• UNITTSTING ：ユニットテストを書くときにSDKクラスをock笑する方法を示します（ Explore EditionおよびNavigate Editionでアプリのサンプルは使用できます）。

ほとんどのアプリには、XYが機能を表す「Xy-Example」という名前のクラスが含まれています。これは、ほとんどの場合、アプリの名前に等しいものです。ここで特定のSDK機能を使用する方法を示すコードを探している場合は、最も興味深い部分が含まれているため、このクラスを探してください。

アプリ全体のアーキテクチャは、焦点を合わせて部品を隠さないように可能な限りシンプルに保たれていることに注意してください。

UI要素は、コードの重要な部分を隠さないように、ほとんどが除外または最小限に抑えられています。ここでのSDK自体は、UIなしでほとんどのAPIヘッドレスを提供していることに注意してください。

すべてのエディションやプラットフォームですべての例が利用できるわけではありません。

選択したエディションとプラットフォームの最新の例を見つけてください。

• AndroidのSDKの例（Lite Edition、Explore Edition、Navigate Edition）の例
• ここでiOSのSDKの例（Explore Edition、Navigate Edition）
• ここでSDK for Flutterの例（Explore Edition、Navigate Edition）

古いバージョンのアプリの例

上には、最新のSDKバージョンのサンプルアプリリンクを見つけることができます。古いバージョンを探している場合は、タグ付きの古いリリースをダウンロードできるリリースページを確認してください。

サンプルアプリを実行するために必要なもの

1. クレデンシャルのセットを取得する：ここのSDKエディションの開発者ガイドの手順に従ってください。
2. 開発者ガイドに示すように、希望するプラットフォーム用の最新のSDKパッケージをダウンロードしてください。
3. 開発者ガイドにリストされているように、最小要件とサポートされているデバイスを参照してください。

Androidを始めましょう

1. Android用のhere SDKのAARファイルを、例のアプリのapp/libsフォルダーにコピーします。
2. Android Studioを開き、プロジェクトを同期します。
3. アプリを実行するには、 MainActivity.javaファイルにここにある資格情報（ accessKeyIdおよびaccessKeySecret ）を挿入します。

iOSを始めましょう

1. iOSのhere sdkのheresdk.frameworkファイルを、アプリのルートフォルダーの例にコピーします。
2. アプリを実行するには、プロジェクトのAppDelegate.swiftファイルにここにある資格情報（ accessKeyIdおよびaccessKeySecret ）を追加する必要があります。

Flutterを始めましょう

1. FlutterパッケージのためにSDKをダウンロードすることを解凍します。このフォルダーには、ドキュメントアセットを含むさまざまなファイルが含まれています。
2. 内部には、Flutterプラグイン用のここのSDKを含むTarファイルもあります。 iOSおよびAndroidネイティブフレームワークが含まれています。
3. 次に、tarファイルを解凍し、フォルダーを「here_sdk」に変更し、アプリの例のディレクトリ内のpluginsフォルダーに配置します。フォルダー構造は次のようになります： hello_map/plugins/here_sdk 。
4. ここにSDK資格情報（AccessKeyIdおよびAccessKeyseCret）をプロジェクトのmain.dartファイルに設定します。
5. AndroidエミュレータまたはiOSシミュレーターを起動し、アプリのディレクトリからflutter runを実行するか、IDE内からアプリを実行します。

より多くのリソース

• ここでSDKが提供する機能のデモをご覧になりたい場合は、すべての機能を実行していることを確認したい場合は、ここでWegoアプリケーションを確認してください。このアプリは、ここのSDKに力を与えるのと同じテクノロジースタックを使用しています。
• または、GitHubでオープンソースプロジェクトとして見つけることができる参照アプリケーション（Flutterでのみ利用可能）を構築および実行できます。このアプリは、簡単に理解できるUXフローと再利用可能なUIアセットを備えたリリース対応アプリのExplore Editionの機能を含む、 Navigate Editionのほとんどの機能を示しています。

連絡してください

• このプロジェクトに貢献する方法に関する情報は、こちらをご覧ください。
• 請求、アカウントなどについて質問がある場合は、お問い合わせください。

ここでSDKを使用していただきありがとうございます。

ライセンス

Copyright（c）2019-2024 Here Europe bv

ライセンスの詳細については、このリポジトリのルートにあるライセンスファイルを参照してください。