Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Google Maps Android API v2

Allow your users explore the world with rich maps provided by Google. Identify locations with custom markers , augment the map data with image overlays , embed one or more maps as fragments, and much more.

Explore the Google Maps Android API v2 reference or visit developers.google.com/maps for more information about adding maps to your app.

Key Developer Features

Add maps to your app

With Google Maps Android API v2, you can embed maps into an activity as a fragment with a simple XML snippet. The new Maps offer exciting features such as 3D maps; indoor, satellite, terrain, and hybrid maps; vector-based tiles for efficient caching and drawing; animated transitions; and much more. Add a map object .

Customize the map

Add markers onto the map to indicate special points of interest for your users. You can define custom colors or icons for your map markers to match your app's look and feel. To further enhance the app, draw polylines and polygons to indicate paths or regions, or provide complete image overlays. Draw markers .

Control the user's view

Give your users a different view of the world with the ability to control the rotation, tilt, zoom, and pan properties of the "camera" perspective of the map. Change the view .

Add Street View to your app

Embed Street View into an activity and let your users explore the world through panoramic 360-degree views. Programmatically control the zoom and orientation (tilt and bearing) of the Street View camera, and animate the camera movements over a given duration. Add Street View .

Getting Started

1. Get the Google Play services SDK

Google Maps Android API v2 is part of the Google Play services platform.

To use Google Maps, set up the Google Play services SDK . Then see the Getting Started guide to get your API key for Maps and set up your app.

2. Run the sample

Once you've installed the Google Play services package, the Google Maps sample is located in <android-sdk>/extras/google-play-services/samples/maps and shows you how to use the major components of Google Maps Android API v2.

3. Read the documentation

Read the Google Maps API Terms of Service .

For quick access while developing your Android apps, the Google Maps Android API v2 reference is available here on developer.android.com.

Detailed documentation for Google Maps Android API v2 is available with the rest of the Google Maps developer documents at developers.google.com/maps .