Android-Rodies-Task: Showing current location in Google Maps using API V2 with SupportMapFragment

In this article, we will create an Android application which will display current location in Google Maps using Google Maps Android API V2.

Since the Google Map is displayed using SupportMapFragment, this application can run in Android API Level 8 or above.

In order to use MapFragment for Google Maps, we need Android device with API level 12 or above.

This application is developed in Eclipse 4.2.1 with ADT plugin ( 21.0.0 ) and Android SDK ( 21.0.0 ). This application is tested in a real Android Phone with Android ( 2.3.6 ).

An alternative method for this application is available at Showing current location using OnMyLocationChangeListener in Google Map Android API V2

1. Download and configure Google Play Services Library in Eclipse

Google Map for Android is now integrated with Google Play Services. So we need to set up Google Play Service Library for developing Google Map application in Android.

Please follow the given below link to setup Google Play Service library in Eclipse.

http://developer.android.com/google/play-services/setup.html

2. Create a new Android Application Project namely “LocationInGoogleMapV2″

3. Configure Android Application Project

4. Design Application Launcher Icon

5. Create a blank activity

6. Enter Main Activity Details

7. Link to Google Play Service Library

8. Get the API key for Google Maps Android API v2

We need to get an API key from Google to use Google Maps in Android application. Please follow the given below link to get the API key for Google Maps Android API v2.

https://developers.google.com/maps/documentation/android/start

9. Add Android Support library to this project

By default, Android support library (android-support-v4.jar ) is added to this project by Eclipse IDE to the directory libs. If it is not added, we can do it manually by doing the following steps :

Open Project Explorer by Clicking “Window -> Show View -> Project Explorer”
Right click this project
Then from popup window, Click “Android Tools -> Add Support Library “

10. Update the file res/values/strings.xml

<?xml version="1.0" encoding="utf-8"?>

<resources>

    <string name="app_name">CurrentLocation</string>

    <string name="hello_world">Hello world!</string>

    <string name="menu_settings">Settings</string>

</resources>

11. Update the file AndroidManfiest.xml

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    package="in.wptrafficanalyzer.locationingooglemapv2"

    android:versionCode="1"

    android:versionName="1.0" >

    <uses-sdk

        android:minSdkVersion="8"

        android:targetSdkVersion="16" />

    <permission

        android:name="in.wptrafficanalyzer.locationingooglemapv2.permission.MAPS_RECEIVE"

        android:protectionLevel="signature"/>

    <uses-permission android:name="in.wptrafficanalyzer.locationingooglemapv2.permission.MAPS_RECEIVE"/>

    <uses-permission android:name="android.permission.INTERNET"/>

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

    <uses-feature

        android:glEsVersion="0x00020000"

        android:required="true"/>

    <application

        android:allowBackup="true"

        android:icon="@drawable/ic_launcher"

        android:label="@string/app_name"

        android:theme="@style/AppTheme" >

        <activity

            android:name="in.wptrafficanalyzer.locationingooglemapv2.MainActivity"

            android:label="@string/app_name" >

            <intent-filter>

                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />

            </intent-filter>

        </activity>

        <meta-data

            android:name="com.google.android.maps.v2.API_KEY"

             android:value="YOUR_API_KEY"/>

    </application>

</manifest>

Note : In the above code, replace “YOUR_API_KEY” with the api key, you generated in step 8.

12. Update the layout file to display Google Map using SupportMapFragment

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:tools="http://schemas.android.com/tools"

    android:layout_width="match_parent"

    android:layout_height="match_parent"

    tools:context=".MainActivity" >

    <TextView

        android:id="@+id/tv_location"

        android:layout_width="wrap_content"

        android:layout_height="wrap_content" />

    <fragment xmlns:android="http://schemas.android.com/apk/res/android"

        android:id="@+id/map"

        android:layout_width="match_parent"

        android:layout_height="match_parent"

        android:layout_below="@id/tv_location"

        class="com.google.android.gms.maps.SupportMapFragment" />

</RelativeLayout>

13. Update the file src/in/wptrafficanalyzer/locationingooglemapv2/MainActivity.java

package in.wptrafficanalyzer.locationingooglemapv2;

import android.location.Criteria;

import android.location.Location;

import android.location.LocationListener;

import android.location.LocationManager;

import android.os.Bundle;

import android.support.v4.app.FragmentActivity;

import android.view.Menu;

import android.widget.TextView;

import com.google.android.gms.maps.CameraUpdateFactory;

import com.google.android.gms.maps.GoogleMap;

import com.google.android.gms.maps.SupportMapFragment;

import com.google.android.gms.maps.model.LatLng;

public class MainActivity extends FragmentActivity implements LocationListener {

    GoogleMap googleMap;

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

        // Getting Google Play availability status

        int status = GooglePlayServicesUtil.isGooglePlayServicesAvailable(getBaseContext());

        // Showing status

        if(status!=ConnectionResult.SUCCESS){ // Google Play Services are not available

            int requestCode = 10;

            Dialog dialog = GooglePlayServicesUtil.getErrorDialog(status, this, requestCode);

            dialog.show();

        }else { // Google Play Services are available

            // Getting reference to the SupportMapFragment of activity_main.xml

            SupportMapFragment fm = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);

            // Getting GoogleMap object from the fragment

            googleMap = fm.getMap();

            // Enabling MyLocation Layer of Google Map

            googleMap.setMyLocationEnabled(true);

            // Getting LocationManager object from System Service LOCATION_SERVICE

            LocationManager locationManager = (LocationManager) getSystemService(LOCATION_SERVICE);

            // Creating a criteria object to retrieve provider

            Criteria criteria = new Criteria();

            // Getting the name of the best provider

            String provider = locationManager.getBestProvider(criteria, true);

            // Getting Current Location

            Location location = locationManager.getLastKnownLocation(provider);

            if(location!=null){

                onLocationChanged(location);

            }

            locationManager.requestLocationUpdates(provider, 20000, 0, this);

        }

    }

    @Override

    public void onLocationChanged(Location location) {

        TextView tvLocation = (TextView) findViewById(R.id.tv_location);

        // Getting latitude of the current location

        double latitude = location.getLatitude();

        // Getting longitude of the current location

        double longitude = location.getLongitude();

        // Creating a LatLng object for the current location

        LatLng latLng = new LatLng(latitude, longitude);

        // Showing the current location in Google Map

        googleMap.moveCamera(CameraUpdateFactory.newLatLng(latLng));

        // Zoom in the Google Map

        googleMap.animateCamera(CameraUpdateFactory.zoomTo(15));

        // Setting latitude and longitude in the TextView tv_location

        tvLocation.setText("Latitude:" +  latitude  + ", Longitude:"+ longitude );

    }

    @Override

    public void onProviderDisabled(String provider) {

        // TODO Auto-generated method stub

    }

    @Override

    public void onProviderEnabled(String provider) {

        // TODO Auto-generated method stub

    }

    @Override

    public void onStatusChanged(String provider, int status, Bundle extras) {

        // TODO Auto-generated method stub

    }

    @Override

    public boolean onCreateOptionsMenu(Menu menu) {

        // Inflate the menu; this adds items to the action bar if it is present.

        getMenuInflater().inflate(R.menu.activity_main, menu);

        return true;

    }

}