Muestra un mapa básico
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.

En este ejemplo, se crea un mapa utilizando un SupportMapFragment
del SDK de Maps para Android.
Para obtener más información, consulta la documentación.
Comienza ahora mismo
Antes de probar el código de muestra, debes configurar tu entorno de desarrollo.
Para obtener más información, consulta Muestras de código del SDK de Maps SDK para Android.
Consulta el código
Kotlin
class BasicMapDemoActivity : AppCompatActivity(), OnMapReadyCallback {
val SYDNEY = LatLng(-33.862, 151.21)
val ZOOM_LEVEL = 13f
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_basic_map_demo)
val mapFragment : SupportMapFragment? =
supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
mapFragment?.getMapAsync(this)
}
/**
* This is where we can add markers or lines, add listeners or move the camera. In this case,
* we just move the camera to Sydney and add a marker in Sydney.
*/
override fun onMapReady(googleMap: GoogleMap) {
with(googleMap) {
moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL))
addMarker(MarkerOptions().position(SYDNEY))
}
}
}
Java
public class BasicMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.basic_demo);
SupportMapFragment mapFragment =
(SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
mapFragment.getMapAsync(this);
}
/**
* This is where we can add markers or lines, add listeners or move the camera. In this case,
* we
* just add a marker near Africa.
*/
@Override
public void onMapReady(GoogleMap map) {
map.addMarker(new MarkerOptions().position(new LatLng(0, 0)).title("Marker"));
}
}
Clona y ejecuta las muestras
Se requiere Git para ejecutar esta muestra a nivel local. Con el siguiente comando, se clona el repositorio de la aplicación de ejemplo.
git clone git@github.com:googlemaps-samples/android-samples.git
Importa el proyecto de muestra en Android Studio:
- En Android Studio, selecciona File > New > Import Project.
Ve a la ubicación en la que guardaste el repositorio y selecciona el directorio del proyecto para Kotlin o Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Selecciona Open. Android Studio creará tu proyecto con la herramienta de compilación Gradle.
- Crea un archivo
secrets.properties
en blanco en el mismo directorio en el que se encuentra el archivo local.properties
de tu proyecto. Para obtener más información, consulta Agrega tu clave de API al proyecto.
Agrega la siguiente cadena a secrets.properties
reemplazando YOUR_API_KEY con el valor de tu clave de API:
MAPS_API_KEY=YOUR_API_KEY
- Ejecuta la app.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-08-13 (UTC)
[null,null,["Última actualización: 2024-08-13 (UTC)"],[[["\u003cp\u003eThis guide demonstrates how to create a basic map in your Android application using the Maps SDK for Android and a \u003ccode\u003eSupportMapFragment\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eCode samples are provided in both Kotlin and Java, showing how to display a map with a marker.\u003c/p\u003e\n"],["\u003cp\u003eBefore running the sample code, you need to configure your development environment, including cloning the sample repository and importing the project into Android Studio.\u003c/p\u003e\n"],["\u003cp\u003eYou will also need to obtain an API key and add it to your project's configuration files to enable map functionality.\u003c/p\u003e\n"]]],[],null,["This example creates a map using a `SupportMapFragment` from the\nMaps SDK for Android.\n\nFor more information, see the [documentation.](/maps/documentation/android-sdk/map)\n\nGet started\n\nBefore you can try the sample code, you must configure your development environment.\nFor more information, see [Maps SDK for Android code samples](/maps/documentation/android-sdk/examples).\n\nView the code\n\n\nKotlin \n\n```kotlin\nclass BasicMapDemoActivity : SamplesBaseActivity(), OnMapReadyCallback {\n\n val SYDNEY = LatLng(-33.862, 151.21)\n val ZOOM_LEVEL = 13f\n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n setContentView(com.example.common_ui.R.layout.basic_demo)\n val mapFragment : SupportMapFragment? =\n supportFragmentManager.findFragmentById(com.example.common_ui.R.id.map) as? SupportMapFragment\n mapFragment?.getMapAsync(this)\n }\n\n /**\n * This is where we can add markers or lines, add listeners or move the camera. In this case,\n * we just move the camera to Sydney and add a marker in Sydney.\n */\n override fun onMapReady(googleMap: GoogleMap) {\n with(googleMap) {\n moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL))\n addMarker(MarkerOptions().position(SYDNEY))\n }\n }\n}https://github.com/googlemaps-samples/android-samples/blob/73ac16ffca01a2ca6fedd1988c713138ec000082/ApiDemos/project/kotlin-app/src/main/java/com/example/kotlindemos/BasicMapDemoActivity.kt#L32-L55\n\n \n```\n\nJava \n\n```java\npublic class BasicMapDemoActivity extends SamplesBaseActivity implements OnMapReadyCallback {\n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n setContentView(com.example.common_ui.R.layout.basic_demo);\n\n SupportMapFragment mapFragment =\n (SupportMapFragment) getSupportFragmentManager().findFragmentById(com.example.common_ui.R.id.map);\n mapFragment.getMapAsync(this);\n applyInsets(findViewById(com.example.common_ui.R.id.map_container));\n }\n\n /**\n * This is where we can add markers or lines, add listeners or move the camera. In this case,\n * we\n * just add a marker near Africa.\n */\n @Override\n public void onMapReady(GoogleMap map) {\n map.addMarker(new MarkerOptions().position(new LatLng(0, 0)).title(\"Marker\"));\n }\n}https://github.com/googlemaps-samples/android-samples/blob/73ac16ffca01a2ca6fedd1988c713138ec000082/ApiDemos/project/java-app/src/main/java/com/example/mapdemo/BasicMapDemoActivity.java#L31-L53\n\n \n```\n\n\u003cbr /\u003e\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."]]