開始方法
このドキュメントでは、Maps SDK の最新の安定バージョンをインストールし、Mapbox 依存関係をプロジェクトに追加して、Android アプリケーションで地図を素早く動作させる手順を説明します。
前提条件
- Mapbox アカウント: Mapbox で無料アカウントに登録するか、ログインしてください。
- Android 開発用 IDE: Android Studio のような Android アプリケーションを編集・ビルドするためのプログラム。
パート1: 認証情報の作成と設定
Maps SDK を使用してアプリケーションの開発を開始する前に、認証情報を作成して設定する必要があります。
SDK をインストールする前に、適切なクレデンシャルを集める必要があります。
この SDK は、Mapbox アカウントからの2つの重要な情報が必要です(またはサインアップしてアカウントを作成してください):
- パブリックアクセス トークン:アカウントのトークン ページから、デフォルトのパブリック トークン をコピーするか、 Create a token ボタンをクリックして新しいパブリック トークンを作成します。
Downloads:Read
スコープを持つシークレット アクセス トークン。- アカウントのトークン ページから、 Create a token ボタンをクリックします。
- トークン作成ページでトークンに名前を付け、
Downloads:Read
スコープの横のボックスがチェックされていることを確認します。 - ページの下部にある Create token ボタンをクリックしてトークンを作成します。
- 作成したトークンは シークレット トークン であるため、安全な場所にコピーする機会は一度だけです。
これらのアクセス トークンを、許可されていないユーザーが見つける可能性のある公開されたソースコードで公開しないでください。代わりに、コンピューター上の安全な場所に保存し、Gradle プロパティ を利用して、アプリがコンパイルされたときにのみそれらが追加されるようにします(次のセクションを参照)。
シークレット トークンの設定
シークレット トークンを公開しないように、環境変数として追加します:
- Gradle ユーザー ホームフォルダーに
gradle.properties
ファイルを見つけるか作成します。フォルダーは«USER_HOME»/.gradle
にあります。ファイルを見つけるか作成したら、そのパスは«USER_HOME»/.gradle/gradle.properties
でなければなりません。Gradle プロパティの詳細については、公式 Gradle ドキュメント を参照してください。 - シークレット トークンを
gradle.properties
ファイルに追加します:
MAPBOX_DOWNLOADS_TOKEN=YOUR_SECRET_MAPBOX_ACCESS_TOKEN