Android Google Maps Example Tutorial

In today's digital age, geographical information is crucial for many mobile applications. Google Maps provides powerful mapping and location services that can be integrated into Android applications to enhance user experience. This tutorial will guide you through the process of integrating Google Maps into an Android application, from setting up the project to implementing basic functionality.

Table of Contents#

  1. Prerequisites
  2. Setting up the Project
  3. Enabling Google Maps API
  4. Adding the Google Maps SDK to Your Project
  5. Configuring the AndroidManifest.xml
  6. Designing the Layout
  7. Implementing the Map in the Activity
  8. Adding Markers to the Map
  9. Common Practices and Best Practices
  10. Conclusion
  11. References

Prerequisites#

  • Basic knowledge of Android development using Java or Kotlin.
  • Android Studio installed on your machine.
  • A Google account to access the Google Cloud Console.

Setting up the Project#

  1. Open Android Studio and create a new Android project.
  2. Select an appropriate project template, such as "Empty Activity".
  3. Choose the minimum SDK version based on your target audience. For Google Maps, Android 5.0 (API level 21) or higher is recommended.
  4. Configure the project name, package name, and save location.
  5. Click "Finish" to create the project.

Enabling Google Maps API#

  1. Go to the Google Cloud Console.
  2. Sign in with your Google account if you haven't already.
  3. Create a new project or select an existing one where you want to enable the Google Maps API.
  4. Navigate to the "APIs & Services" > "Library" section.
  5. Search for "Maps SDK for Android" and click on it.
  6. Click the "Enable" button to enable the API for your project.

Adding the Google Maps SDK to Your Project#

  1. Open the build.gradle (Module: app) file in your Android project.
  2. Add the following dependency under the dependencies section:
implementation 'com.google.android.gms:play-services-maps:17.0.0'
  1. Sync your project with Gradle by clicking the "Sync Now" button.

Configuring the AndroidManifest.xml#

  1. Open the AndroidManifest.xml file in your project.
  2. Add the following uses permissions outside the <application> tag:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  1. Inside the <application> tag, add the following meta-data element with your Google Maps API key. You can obtain the API key from the Google Cloud Console under "APIs & Services" > "Credentials".
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="YOUR_API_KEY"/>

Designing the Layout#

  1. Open the activity_main.xml layout file.
  2. Replace the default TextView with the following MapView or SupportMapFragment:
<fragment
    android:id="@+id/map_fragment"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

The SupportMapFragment is recommended for Android applications as it uses the Android Support Library, which provides better backward compatibility.

Implementing the Map in the Activity#

  1. Open the MainActivity.java or MainActivity.kt file.
  2. If you are using Java, make sure your activity extends AppCompatActivity and implements OnMapReadyCallback:
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
 
public class MainActivity extends AppCompatActivity implements OnMapReadyCallback {
 
    private GoogleMap mMap;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
               .findFragmentById(R.id.map_fragment);
        mapFragment.getMapAsync(this);
    }
 
    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;
 
        // You can now use the GoogleMap object to interact with the map.
    }
}
  1. If you are using Kotlin, the code will look like this:
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
 
class MainActivity : AppCompatActivity(), OnMapReadyCallback {
 
    private lateinit var mMap: GoogleMap
 
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
 
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        val mapFragment = supportFragmentManager
           .findFragmentById(R.id.map_fragment) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }
 
    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap
 
        // You can now use the GoogleMap object to interact with the map.
    }
}

Adding Markers to the Map#

To add a marker to the map, you can use the following code inside the onMapReady method:

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;
 
    // Add a marker in Sydney and move the camera
    LatLng sydney = new LatLng(-34, 151);
    mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
    mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
}

In Kotlin:

override fun onMapReady(googleMap: GoogleMap) {
    mMap = googleMap
 
    // Add a marker in Sydney and move the camera
    val sydney = LatLng(-34.0, 151.0)
    mMap.addMarker(MarkerOptions().position(sydney).title("Marker in Sydney"))
    mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney))
}

Common Practices and Best Practices#

  • Error Handling: Always handle errors that may occur during the map initialization process. For example, check if the Google Play services are available on the device.
  • Permissions: Request the necessary location permissions at runtime for Android 6.0 (API level 23) and higher.
  • Performance Optimization: Use the MapView instead of SupportMapFragment if you need more control over the map lifecycle and performance.
  • UI/UX Design: Customize the map markers, info windows, and other UI elements to match your application's design.

Conclusion#

In this tutorial, we have learned how to integrate Google Maps into an Android application. We covered the steps from setting up the project, enabling the API, adding the SDK, configuring the manifest, designing the layout, implementing the map in the activity, and adding markers. By following these steps and best practices, you can create powerful location-based Android applications.

References#

2026-06