Maps SDK for Android のサンプルコード
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
GitHub の Maps SDK for Android リポジトリには、Android アプリでの Maps SDK for Android の使用方法を示すサンプルが含まれています。
このリポジトリにある ApiDemos は、単一の Android アプリから複数のサンプルをビルドして実行できるサンプルアプリです。このアプリをインポートしてビルドし、API キーを追加してデモを確認し、サンプルコードを使用してご自身のアプリの作成を始めることができます。
サンプルアプリを実行すると、ご自身のデバイスで実行できるサンプルのリストが表示されます。選択肢の中から 1 つ選びます。たとえば、[Basic Map] をクリックします。
トラブルシューティング: サンプルアプリは正常に実行されるものの地図が表示されない場合は、API キーを使用するで説明されているとおりに API キーがアプリのマニフェスト ファイルに追加されているかを確認してください。
Maps SDK for Android のサンプルアプリ リスト
以下は、Maps SDK for Android ApiDemos アプリに含まれる主なサンプル アクティビティです。簡単な参照として、各サンプル アクティビティがリンク先のページで再現されています。利用可能なサンプルの完全なリストについては、Kotlin または Java のフォルダを参照してください。
サンプルのクローンを作成して実行する
このサンプルをローカルで実行するには、Git が必要です。次のコマンドで、サンプルアプリ リポジトリのクローンを作成します。
git clone git@github.com:googlemaps-samples/android-samples.git
サンプル プロジェクトを Android Studio にインポートします。
- Android Studio で、[File] > [New] > [Import Project] を選択します。
リポジトリの保存先に移動し、Kotlin または Java のプロジェクト ディレクトリを選択します。
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- [Open] を選択します。Android Studio が Gradle ビルドツールを使用してプロジェクトをビルドします。
- プロジェクトの
local.properties ファイルと同じディレクトリに空の secrets.properties ファイルを作成します。詳しくは、API キーをプロジェクトに追加するをご覧ください。
次の文字列を secrets.properties に追加し、YOUR_API_KEY を実際の API キーの値に置き換えます。
MAPS_API_KEY=YOUR_API_KEY
- アプリを実行します。
Wear OS 向けの地図のサンプルアプリ
GitHub で入手できる Wear OS 向け Maps SDK for Android のサンプルアプリを使って、ウェアラブル アプリの構築を始めることができます。このサンプルでは、基本的な Google マップを Wear OS にセットアップする方法を示します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-12-03 UTC。
[null,null,["最終更新日 2024-12-03 UTC。"],[[["\u003cp\u003eThis page provides access to the Maps SDK for Android sample code and apps, including a comprehensive ApiDemos app containing various map feature examples.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can clone the sample repository from GitHub, import it into Android Studio, add their API key, and run the app to explore different map functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThe ApiDemos app showcases key features such as basic maps, markers, events, polylines, polygons, and My Location, with code samples readily available for use.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting guidance is provided if the map doesn't display, directing users to verify their API key configuration.\u003c/p\u003e\n"],["\u003cp\u003eA separate sample app specifically for Wear OS is available on GitHub, demonstrating how to integrate Google Maps into wearable applications.\u003c/p\u003e\n"]]],["The Maps SDK for Android samples are available on GitHub. To use them, clone the repository, import the ApiDemos project into Android Studio (either Kotlin or Java), and add your API key to the `secrets.properties` file. Run the app to view a list of samples like Basic Map, Markers, and Polylines. A separate Wear OS sample is also available on GitHub, showing basic map setup for wearable apps. Ensure your API key is correctly added to the app manifest if you encounter map display issues.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/examples \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/examples \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/examples \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nThe Maps SDK for Android repository on [GitHub](https://github.com/googlemaps-samples/android-samples)\nincludes samples illustrating the use of the Maps SDK for Android in\nyour Android app.\n\nThe repository contains the [ApiDemos](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos) app, a sample app that lets\nyou build and run the samples from a single Android app. Import and build the\napp, add your API key, view the demo, and use the sample code supplied as a\nstarting point for your app.\n\nWhen you run the sample app, it displays a list of available samples that you\ncan run on your own device. Select one of the options. For example, click\n**Basic Map**.\n\n**Troubleshooting:** If the sample app runs successfully but you don't see a\nmap, check that you've added your API key to the app's manifest file, as\ndescribed in [Using API Keys](/maps/documentation/android-sdk/get-api-key).\n\nMaps SDK for Android sample app list\n\nKey sample activities contained in the Maps SDK for Android\n[ApiDemos](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos) app are listed below and reproduced at the linked pages\nfor quick reference. See the [Kotlin](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos/kotlin/app/src/main/java/com/example/kotlindemos) or [Java](https://github.com/googlemaps-samples/android-samples/tree/main/ApiDemos/java/app/src/main/java/com/example/mapdemo)\nfolder for the full list of available samples.\n\n- [Basic map](/maps/documentation/android-sdk/examples/basic-map)\n- [Markers](/maps/documentation/android-sdk/examples/marker)\n- [Advanced markers](/maps/documentation/android-sdk/examples/advanced-marker)\n- [My Location](/maps/documentation/android-sdk/examples/my-location)\n- [Events](/maps/documentation/android-sdk/examples/events)\n- [Polylines](/maps/documentation/android-sdk/examples/polyline)\n- [Polygons](/maps/documentation/android-sdk/examples/polygon)\n\nClone and run the samples\n\nGit is required to run this sample locally. The following command clones the sample\napplication repository. \n\n```\ngit clone git@github.com:googlemaps-samples/android-samples.git\n```\n\nImport the sample project into Android Studio:\n\n1. In Android Studio, select **File \\\u003e New \\\u003e Import Project**.\n2. Go to the location where you saved the repository and select the project directory for\n Kotlin or Java:\n\n - **Kotlin** : \u003cvar translate=\"no\"\u003ePATH-REPO\u003c/var\u003e`/android-samples/ApiDemos/kotlin`\n - **Java** : \u003cvar translate=\"no\"\u003ePATH-REPO\u003c/var\u003e`/android-samples/ApiDemos/java`\n3. Select **Open**. Android Studio builds your project, using the Gradle build tool.\n4. Create a blank `secrets.properties` file in the same directory as your project's `local.properties` file. For more information about this file, see [Add your API key to the project](/maps/documentation/android-sdk/config#step_3_add_your_api_key_to_the_project).\n5. [Get an API key](/maps/documentation/android-sdk/get-api-key) from your project with the [Maps SDK for Android enabled](/maps/documentation/android-sdk/cloud-setup#enabling-apis).\n6. Add the following string to `secrets.properties`, replacing **YOUR_API_KEY** with the value of\n your API key:\n\n ```scdoc\n MAPS_API_KEY=YOUR_API_KEY\n ```\n7. Run the app.\n\nSample app for maps on Wear OS\n\nA sample app for Maps SDK for Android on Wear OS is\navailable on [GitHub](https://github.com/googlemaps-samples/android-samples/tree/main/WearOS), which you can use as a starting point when\nbuilding a wearable app. The sample shows you how to set up a basic Google Map\non Wear OS."]]
