diff options
Diffstat (limited to 'docs/html/guide/tutorials/views/hello-mapview.jd')
| -rw-r--r-- | docs/html/guide/tutorials/views/hello-mapview.jd | 34 |
1 files changed, 15 insertions, 19 deletions
diff --git a/docs/html/guide/tutorials/views/hello-mapview.jd b/docs/html/guide/tutorials/views/hello-mapview.jd index 976b8ab42e50..b0f59de175e2 100644 --- a/docs/html/guide/tutorials/views/hello-mapview.jd +++ b/docs/html/guide/tutorials/views/hello-mapview.jd @@ -16,13 +16,8 @@ First, we'll create a simple Activity that can view and navigate a map. Then we <pre><uses-library android:name="com.google.android.maps" /></pre> </li> - <li>We also need access to the internet in order to retrieve the Google Maps tiles, - so the application must request the {@link android.Manifest.permission#INTERNET INTERNET} permissions. - In the manifest file, add the following as a child of the <code><manifest></code> element: - <pre><uses-permission android:name="android.permission.INTERNET" /></pre> - </li> - <li>Now open the main layout file for your project. Define a layout with a com.google.android.maps.MapView - inside a android.widget.RelativeLayout: + + <li>Open the layout file. Define the layout with a MapView inside a RelativeLayout: <pre> <?xml version="1.0" encoding="utf-8"?> @@ -37,21 +32,22 @@ First, we'll create a simple Activity that can view and navigate a map. Then we android:layout_width="fill_parent" android:layout_height="fill_parent" android:clickable="true" - android:apiKey="<em>Your Maps API Key</em>" + android:apiKey="INSERT YOUR KEY HERE" /> -</RelativeLayout> +<RelativeLayout> </pre> - <p>The <code>clickable</code> attribute defines whether you want to allow user-interaction with the map. - In this case, we set it "true" so that the user can navigate.</p> - - <p>The <code>apiKey</code> attribute holds the Google Maps API Key that proves your application and signer - certificate has been registered with the Google Maps service. Because MapView uses Google Maps data, this key is required - in order to receive the map data, even while you are developing. Registration is free and it only takes a couple - minutes to register your certificate and receive a Maps API Key. For instructions on getting a key, read - <a href="{@docRoot}guide/topics/location/geo/mapkey.html">Obtaining a Maps API Key</a>. - (For the purpose of this tutorial, you should register with the fingerprint of the SDK debug certificate.) - Once you've acquired the Maps API Key, insert it for the <code>apiKey</code> value.</p></li> + <p>Setting <code>clickable</code> is important. Otherwise, the map does not allow any user interaction.</p> + + <p>The <code>android:apiKey</code> must contain an authentic Android Maps API key. + The API key is generated using the MD5 fingerprint of your application certificate. For the purposes of + this exercise, you should use the fingerprint of your debug certificate (which cannot be used to release + your application for Android devices, but will work while developing). See how to + <a href="{@docRoot}guide/topics/location/geo/mapkey.html#getdebugfingerprint">generate a fingerprint from your + debug certificate</a>, then <a href="http://code.google.com/android/maps-api-signup.html">register the + certificate</a> to retieve an API key. + Insert the API key as the value of the <code>apiKey</code> attribute. If you do not insert a valid + Maps API key, the application will still run, but no map tiles will load.</p></li> <li>Now open the HelloMapView.java file. For this Activity, we're going to extend the special sub-class of Activity called MapActivity, so change the class declaration to extend |