Google Maps Android API V2

12:20 PM Google Map v2 11 Comments

Introduction :

1. Select File > Import > Android > Existing Android Code Into Workspace and click Next.
2. Select Browse..., enter <android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib, and click Finish.

Getting Started :

Obtaining an API Key

1. In the left navigation bar, click API Access.
2. In the resulting page, click Create New Android Key....
3. In the resulting dialog, enter the SHA-1 fingerprint, then a semicolon, then your application's package name. For example:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75;com.example.android.mapexample

4. The Google APIs Console responds by displaying Key for Android apps (with certificates) followed by a forty-character API key, for example:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

5. Copy this key value. You will use it in the next step.

1.  The Google Maps Android API v2 uses a new system of managing keys. Existing keys from a Google Maps Android v1 application, commonly known as MapView, will not work with the v2 API.
2. To get SHA-1 fingerprint enter command in terminal: keytool -list -v -keystore debug.keystore

Adding the API Key to your application

1. In AndroidManifest.xml, add the following element as a child of the <application> element, by inserting it just before the closing tag</application>:

   <meta-data
       android:name="com.google.android.maps.v2.API_KEY"
       android:value="your_api_key"/>
   

   substituting your API key for your_api_key. This element sets the key com.google.android.maps.v2.API_KEY to the value your_api_key and makes the API key visible to any MapFragment in your application.
2. Add the following elements to your manifest. Replace com.example.mapdemo with the package name of your application.

           <permission
             android:name="com.example.mapdemo.permission.MAPS_RECEIVE"
             android:protectionLevel="signature"/>
           <uses-permission android:name="com.example.mapdemo.permission.MAPS_RECEIVE"/>
       

3. Save AndroidManifest.xml and re-build your application. 

• android.permission.INTERNET Used by the API to download map tiles from Google Maps servers.
• com.google.android.providers.gsf.permission.READ_GSERVICES Allows the API to access Google web-based services.
  
  

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

• android.permission.WRITE_EXTERNAL_STORAGE Allows the API to cache map tile data in the device's external storage area.

<uses-feature
  android:glEsVersion="0x00020000"
  android:required="true"/>

Sample Code:

1. In main.xml, add the following fragment.

   <?xml version="1.0" encoding="utf-8"?>
   <fragment xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/map"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     class="com.google.android.gms.maps.MapFragment"/>
   

2. In MainActivity.java, add the following code.

   package com.example.mapdemo;
   import android.app.Activity;
   import android.os.Bundle;
   public class MainActivity extends Activity {
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.main);
       }
   }
   

3. Build and run your application. You should see a map. If you don't see a map, confirm that you've completed all of the steps appearing earlier in this document.

Adding Map Code

private GoogleMap mMap;
...
mMap = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();

Change the Map Type

GoogleMap map;
...
// Sets the map type to be "hybrid"
map.setMapType(GoogleMap.MAP_TYPE_HYBRID);

Add a marker

private GoogleMap mMap;
mMap = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();
mMap.addMarker(new MarkerOptions()
        .position(new LatLng(0, 0))
        .title("Hello world"));

  private static final LatLng MELBOURNE = new LatLng(-37.81319, 144.96298);
  private Marker melbourne = mMap.addMarker(new MarkerOptions()
                            .position(MELBOURNE)
                            .title("Melbourne")
                            .snippet("Population: 4,137,400")
                            .icon(BitmapDescriptorFactory.fromResource(R.drawable.arrow)));

Info windows

private static final LatLng SYDNEY = new LatLng(-33.88,151.21);
private static final LatLng MOUNTAIN_VIEW = new LatLng(37.4, -122.1);
private GoogleMap map;
... // Obtain the map from a MapFragment or MapView.
// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, 15);
// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn());
// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10), null, 2000);
// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
CameraPosition cameraPosition = new CameraPosition.Builder()
    .target(MOUNTAIN_VIEW)      // Sets the center of the map to Mountain View
    .zoom(17)                   // Sets the zoom
    .bearing(90)                // Sets the orientation of the camera to east
    .tilt(30)                   // Sets the tilt of the camera to 30 degrees
    .build();                   // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));