102 lines
4.7 KiB
Plaintext
102 lines
4.7 KiB
Plaintext
page.title=Location and Maps
|
|
excludeFromSuggestions=true
|
|
@jd:body
|
|
|
|
<div id="qv-wrapper">
|
|
<div id="qv">
|
|
|
|
<h2>In this document</h2>
|
|
<ol>
|
|
<li><a href="#location">Location Services</a></li>
|
|
<li><a href="#maps">Google Maps Android API</a></li>
|
|
</ol>
|
|
|
|
</div>
|
|
</div>
|
|
<div class="note">
|
|
<p>
|
|
<strong>Note:</strong> This is a guide to the <i>Android framework</i> location APIs in the
|
|
package {@link android.location}. The Google Location Services API, part of Google Play
|
|
Services, provides a more powerful, high-level framework that automates tasks such as
|
|
location provider choice and power management. Location Services also provides new
|
|
features such as activity detection that aren't available in the framework API. Developers who
|
|
are using the framework API, as well as developers who are just now adding location-awareness
|
|
to their apps, should strongly consider using the Location Services API.
|
|
</p>
|
|
<p>
|
|
To learn more about the Location Services API, see
|
|
<a href="{@docRoot}google/play-services/location.html">Google Location Services for Android</a>.
|
|
</p>
|
|
</div>
|
|
<p>
|
|
Location and maps-based apps offer a compelling experience on mobile devices. You
|
|
can build these capabilities into your app using the classes of the {@link
|
|
android.location} package and the Google Maps Android API. The sections below provide
|
|
an introduction to how you can add the features.
|
|
</p>
|
|
|
|
<h2 id="location">Location Services</h2>
|
|
|
|
<p>Android gives your applications access to the location services supported by
|
|
the device through classes in the {@code android.location} package. The
|
|
central component of the location framework is the
|
|
{@link android.location.LocationManager} system service, which provides APIs to
|
|
determine location and bearing of the underlying device (if available). </p>
|
|
|
|
<p>As with other system services, you do not instantiate a {@link android.location.LocationManager}
|
|
directly. Rather, you request an instance from the system by calling
|
|
{@link android.content.Context#getSystemService(String)
|
|
getSystemService(Context.LOCATION_SERVICE)}. The method returns a handle to a new {@link
|
|
android.location.LocationManager} instance.</p>
|
|
|
|
<p>Once your application has a {@link android.location.LocationManager}, your application
|
|
is able to do three things:</p>
|
|
|
|
<ul>
|
|
<li>Query for the list of all {@link android.location.LocationProvider}s for the last known
|
|
user location.</li>
|
|
<li>Register/unregister for periodic updates of the user's current location from a
|
|
location provider (specified either by criteria or name).</li>
|
|
<li>Register/unregister for a given {@link android.content.Intent} to be fired if the device
|
|
comes within a given proximity (specified by radius in meters) of a given lat/long.</li>
|
|
</ul>
|
|
|
|
<p>For more information about acquiring the user location, read the <a
|
|
href="{@docRoot}guide/topics/location/strategies.html">Location Strategies</a> guide.</p>
|
|
|
|
|
|
|
|
<h2 id="maps">Google Maps Android API</h2>
|
|
|
|
<p>With the
|
|
<a href="http://developers.google.com/maps/documentation/android/">Google Maps Android API</a>,
|
|
you can add maps to your app that are based on Google
|
|
Maps data. The API automatically handles access to Google Maps servers, data downloading,
|
|
map display, and touch gestures on the map. You can also use API calls to add markers,
|
|
polygons and overlays, and to change the user's view of a particular map area.</p>
|
|
|
|
<p>The key class in the Google Maps Android API is
|
|
<a href="{@docRoot}reference/com/google/android/gms/maps/MapView.html">{@code MapView}</a>.
|
|
A <a href="{@docRoot}reference/com/google/android/gms/maps/MapView.html">{@code MapView}</a>
|
|
displays a map with data obtained
|
|
from the Google Maps service. When the
|
|
<a href="{@docRoot}reference/com/google/android/gms/maps/MapView.html">{@code MapView}</a>
|
|
has focus, it will capture
|
|
keypresses and touch gestures to pan and zoom the map automatically, including
|
|
handling network requests for additional maps tiles. It also provides all of the
|
|
UI elements necessary for users to control the map. Your application can also
|
|
use <a href="{@docRoot}reference/com/google/android/gms/maps/MapView.html">{@code MapView}</a>
|
|
class methods to control the map programmatically and draw a
|
|
number of overlays on top of the map. </p>
|
|
|
|
<p>The Google Maps Android APIs are not included in the Android platform,
|
|
but are available on any device
|
|
with the Google Play Store running Android 2.2 or higher, through
|
|
<a href="{@docRoot}google/play-services/index.html">Google Play services</a>.</p>
|
|
|
|
<p>To integrate Google Maps into your app, you need to install the Google Play services
|
|
libraries for your Android SDK. For more details, read about <a
|
|
href="{@docRoot}google/play-services/maps.html">Google Play services</a>.</p>
|
|
|
|
|