blob: 3fbf00ec8bcb57591240c33f24941878a2927efd [file] [log] [blame]
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -07001page.title=Location APIs
Joe Fernandez33baa5a2013-11-14 11:41:19 -08002page.tags=location,geofence,geofencing,gps
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -07003header.hide=1
4@jd:body
5
6
7 <div class="landing-banner">
8
9<div class="col-6">
10 <img src="{@docRoot}images/google/gps-location.png" alt="Location APIs Logo">
11</div>
12
13<div class="col-6">
14
15<h1 itemprop="name" style="margin-bottom:0;">Location APIs</h1>
16<p itemprop="description">
17 The location APIs make it easy for you to build location-aware applications, without needing to
18 focus on the details of the underlying location technology. They also let you minimize
19 power consumption by using all of the capabilities of the device hardware.
20</p>
21
22<p>
23 To get started, first <a href="{@docRoot}google/play-services/setup.html">set up</a>
24 the Google Play services SDK. You can learn how to use the APIs in the training
Dirk Doughertyd14295c2013-05-14 23:25:49 -070025 class <a href="{@docRoot}training/location/index.html">Making Your App Location Aware</a>,
26 and details are available in the <a href="{@docRoot}reference/com/google/android/gms/location/package-summary.html">Location API reference</a>. <!-- To look at a code example, <a href="">download the sample app</a>. -->
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070027</p>
28</div>
29</div>
30<div class="landing-docs">
31 <h3 style="clear:left">Key Developer Features</h3>
32 <div class="layout-content-row">
33 <div class="layout-content-col span-6">
34
35
36
37<h4 style="font-weight:bold">Fused location provider</h4>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070038
39<p>The Fused Location Provider intelligently manages the underlying location technology and gives you the best location according to your needs. </p>
40
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070041<ul>
42 <li>
43 <em>Simple APIs</em>: Lets you specify high-level needs like "high accuracy" or "low power", instead of
44 having to worry about location providers.
45 </li>
46 <li>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070047 <em>Immediately available</em>: Gives your apps immediate access to the best, most recent location.
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070048 </li>
49 <li>
50 <em>Power-efficiency</em>: Minimizes your app's use of power. Based on all incoming location requests and available sensors, fused location provider chooses the most efficient way to meet those needs.
51 </li>
52 <li>
53 <em>Versatility</em>: Meets a wide range of needs, from foreground uses that need highly accurate
54 location to background uses that need periodic location updates with negligible power impact.
55 </li>
56
57</ul>
58
59<h4 style="font-weight:bold">Geofencing APIs</h4>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070060
61<p>Lets your app setup geographic boundaries around specific locations and then receive notifications when the user enters or leaves those areas. </p>
62
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070063<ul>
64 <li>
65 <em>Simple but powerful APIs</em>: Allows batch addition and removal of geofences. Ability to manage
66 multiple geofences at the same time. Ability to filter alerts for both entry and exit or
67 entry only or exit only.
68 </li>
69 <li>
70 <em>Optimized for battery</em>: Adjusts location updates based on user’s proximity to the geofence
71 and user’s modality (still, walking, driving, and so on).
72 </li>
73</ul>
74</div>
75
76<div class="layout-content-col span-6">
77<h4 style="font-weight:bold">Activity recognition</h4>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070078
79<p>With apps becoming increasingly contextual, understanding what the user is doing is critical to surfacing the right content. The Activity recognition API makes it easy to check the user’s current activity&mdash;still, walking, cycling, and in-vehicle&mdash;with very efficient use of the battery.</p>
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070080<ul>
81 <li>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070082 <em>Optimized for battery</em>: Uses low-power sensors to recognize the user's current physical activity.
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070083 </li>
84 <li>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070085 <em>Enhances other services with context</em>: Great for adding movement awareness to location awareness. Apps can adjust the amount of
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070086 location awareness they provide, based on the current user movement. For example, a
87 navigation app can request more frequent updates when the user is driving.
88 </li>
89 <li>
Dirk Doughertyd14295c2013-05-14 23:25:49 -070090 <em>Features for advanced applications</em>: For advanced applications that want to do their own
Dirk Doughertyc3a7ea42013-05-03 13:11:51 -070091 post-processing, this API also makes available confidence values for each of the activities.
92 It also includes two activities that indicate unreliable measurements: unknown and tilt.
93 </li>
94</ul>
95</div>
Scott Main527b76232013-05-15 02:33:57 -070096</div>