Codice campione di Maps SDK for Android
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Seleziona la piattaforma:
Android
iOS
JavaScript
Il repository Maps SDK for Android su GitHub
include esempi che illustrano l'utilizzo di Maps SDK for Android
nella tua app per Android.
Il repository contiene l'app ApiDemos, un'app di esempio che ti consente di creare ed eseguire gli esempi da una singola app per Android. Importa e crea l'app, aggiungi la tua chiave API, visualizza la demo e utilizza il codice di esempio fornito come punto di partenza per la tua app.
Quando esegui l'app di esempio, viene visualizzato un elenco di esempi disponibili che puoi
eseguire sul tuo dispositivo. Seleziona una delle opzioni. Ad esempio, fai clic su
Mappa base.
Risoluzione dei problemi:se l'app di esempio viene eseguita correttamente, ma non vedi una mappa, controlla di aver aggiunto la chiave API al file manifest dell'app, come descritto in Utilizzo delle chiavi API.
Elenco delle app di esempio di Maps SDK for Android
Le principali attività di esempio contenute nell'app ApiDemos di Maps SDK per Android sono elencate di seguito e riprodotte nelle pagine collegate per una consultazione rapida. Consulta la cartella Kotlin o Java
per l'elenco completo degli esempi disponibili.
Clona ed esegui gli esempi
Per eseguire questo esempio in locale è necessario Git. Il comando seguente clona il repository dell'applicazione di esempio.
git clone git@github.com:googlemaps-samples/android-samples.git
Importa il progetto di esempio in Android Studio:
- In Android Studio, seleziona File > Nuovo > Importa progetto.
Vai alla posizione in cui hai salvato il repository e seleziona la directory del progetto per
Kotlin o Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Seleziona Apri. Android Studio crea il progetto utilizzando lo strumento di build Gradle.
- Crea un file
secrets.properties vuoto nella stessa directory del file local.properties del progetto. Per saperne di più su questo file, consulta Aggiungere la chiave API al progetto.
- Ottieni una chiave API dal tuo progetto con l'SDK Maps per Android attivato.
Aggiungi la seguente stringa a secrets.properties, sostituendo YOUR_API_KEY con il valore della tua chiave API:
MAPS_API_KEY=YOUR_API_KEY
- Esegui l'app.
App di esempio per le mappe su Wear OS
Un'app di esempio per Maps SDK for Android su Wear OS è
disponibile su GitHub, che puoi utilizzare come punto di partenza per
creare un'app indossabile. L'esempio mostra come configurare una mappa di Google di base
su Wear OS.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 2025-07-27 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."]]
