Mapbox Maps SDK for Androidは、Androidアプリケーション内に高度にカスタマイズされた地図を埋め込むためのライブラリです。
アプリケーションのスタイルを選択してください。 専門家が設計したMapbox Standard、Mapbox Standard Satellite、またはさまざまな使用例に最適化された他のMapboxデザインのスタイルから始めたり、Mapbox Studioで独自のカスタムスタイルをデザインしたりできます。実行時でも地図のスタイルを変更することができます。
独自のカスタムデータを地図に追加します。アプリに店舗検索機能を組み込むために地図にマーカーを追加する場合でも、説得力のあるデータビジュアライゼーションを作成する場合でも、Maps SDKは地図上にデータを表示する方法をコントロールします。データプロパティ、ユーザー操作、デバイス設定に基づいて実行時に地図の機能をスタイル化することができます。
要件
Mapbox Maps SDK for Androidの要件は次のとおりです：
- アプリはAndroid SDK 21以上でビルドする必要があります。
- NDKを使用するアプリはNDK 23を使用してビルドする必要があります。その他の主要バージョンのNDKは互換性が保証されません。
- OpenGL ES 3をサポートするデバイス。
- Kotlinで開発されるアプリは、バージョン1.6.0以上を使用する必要があります。
sourceCompatibilityとtargetCompatibilityにはJava 8以上を使用してください。
Javaの互換性
Mapbox Maps SDK for Androidは、Googleが推奨する公式言語であるKotlinで構築されています。KotlinはJavaと100％相互運用可能です。
Javaコードベースのアプリケーションは、Mapbox SDK for Androidが提供する公開APIと適切にやり取りできます。Mapbox Maps SDK for AndroidとJavaを使用する際に問題が発生した場合は、お問い合わせください。
他のMapboxツールとの使用
Mapbox Maps SDK for Androidを他のMapbox製品と共に使用できます。他のツールやプラグインを組み合わせて、特定の仕様に合わせて位置情報に対応したアプリケーションを作成しましょう。
静的地図
Mapbox Maps SDK for Androidには、アプリケーション内の既存の地図の静的なスナップショットを生成するためのメソッドが含まれています。MapSnapshotterクラスを使用して、別のAPIにリクエストを送信せずに地図の静的なラスタ画像を作成します。
Java SDKも、Mapbox Static Images APIに直接アクセスする必要があるアプリケーション向けに利用できます。
Mapbox Studio
Mapbox Maps SDKはMapbox Studioと互換性があります。ブランドやアプリケーションのデザインにシームレスにマッチする地図を設計し、Mapbox StudioのWebインターフェース内で独自のカスタムデータを強化します。
条件
帰属表示
Mapbox Maps SDK for Androidを使用する地図には、必ずMapboxのワードマークを含める必要があります。地図のデータがすべてMapbox由来でない場合を除き、地図に帰属表示を行う必要があります。
Mapboxワードマークと帰属表示を移動させることはできますが、地図上で視認可能な状態で維持する必要があります。帰属表示の背景色とテキスト色をデザインの美学に合わせて変更することもできますが、情報は読みやすいものでなければなりません。
それ以外の方法でMapboxのワードマークやテキスト帰属表示を変更することはできません。
Mapboxが要求する帰属表示の種類とその理由について詳しく学びましょう。
テレメトリのオプトアウト
Mapbox Telemetryは、このSDKに含まれる強力な位置情報解析プラットフォームです。デフォルトでは、ホストアプリがそれを収集すると、SDKは未識別の位置および使用データをMapboxに送信します。Mapboxの利用規約では、アプリがMapbox Telemetryから個別にオプトアウトする方法をユーザーに提供する必要があります。これは帰属表示コントロールの一部として自動的に提供されます。帰属コントロールを非表示にする場合は、ユーザーが使用できる別のオプトアウトオプションを提供する必要があります。
SDKの古いバージョン
Maps SDK
古いバージョンのMaps SDKをお探しですか？Maps SDK v10 APIリファレンスまたはMaps SDK v9ドキュメントを参照してください。