docs/html/reference/com/google/android/gms/location/LocationRequest.html

   1 <!DOCTYPE html>
   2
   3
   4
   5
   6
   7
   8
   9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76 <html>
  77 <head>
  78
  79
  80
  81 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  82
  83 <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
  84 <title>LocationRequest | Android Developers</title>
  85
  86 <!-- STYLESHEETS -->
  87 <link rel="stylesheet"
  88 href="//fonts.googleapis.com/css?family=Roboto:regular,medium,thin,italic,mediumitalic,bold" title="roboto">
  89 <link href="/assets/css/default.css" rel="stylesheet" type="text/css">
  90
  91
  92
  93 <!-- JAVASCRIPT -->
  94 <script src="//www.google.com/jsapi" type="text/javascript"></script>
  95 <script src="/assets/js/android_3p-bundle.js" type="text/javascript"></script>
  96 <script type="text/javascript">
  97   var toRoot = "/";
  98   var devsite = false;
  99 </script>
 100 <script src="/assets/js/docs.js" type="text/javascript"></script>
 101
 102 <script type="text/javascript">
 103   var _gaq = _gaq || [];
 104   _gaq.push(['_setAccount', 'UA-5831155-1']);
 105   _gaq.push(['_trackPageview']);
 106
 107   (function() {
 108     var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
 109     ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
 110     var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
 111   })();
 112 </script>
 113 </head>
 114 <body class="gc-documentation google
 115   develop" itemscope itemtype="http://schema.org/Article">
 116   <div id="doc-api-level" class="" style="display:none"></div>
 117   <a name="top"></a>
 118
 119 <a name="top"></a>
 120
 121     <!-- Header -->
 122     <div id="header">
 123         <div class="wrap" id="header-wrap">
 124           <div class="col-3 logo">
 125           <a href="/index.html">
 126             <img src="/assets/images/dac_logo.png" width="123" height="25" alt="Android Developers" />
 127           </a>
 128           <div class="btn-quicknav" id="btn-quicknav">
 129                 <a href="#" class="arrow-inactive">Quicknav</a>
 130                               <a href="#" class="arrow-active">Quicknav</a>
 131           </div>
 132           </div>
 133             <ul class="nav-x col-9">
 134                 <li class="design">
 135                   <a href="/design/index.html"
 136                   zh-tw-lang="設計"
 137                   zh-cn-lang="设计"
 138                   ru-lang="Проектирование"
 139                   ko-lang="디자인"
 140                   ja-lang="設計"
 141                   es-lang="Diseñar"
 142                   >Design</a></li>
 143                 <li class="develop"><a href="/develop/index.html"
 144                   zh-tw-lang="開發"
 145                   zh-cn-lang="开发"
 146                   ru-lang="Разработка"
 147                   ko-lang="개발"
 148                   ja-lang="開発"
 149                   es-lang="Desarrollar"
 150                   >Develop</a></li>
 151                 <li class="distribute last"><a href="/distribute/index.html"
 152                   zh-tw-lang="發佈"
 153                   zh-cn-lang="分发"
 154                   ru-lang="Распространение"
 155                   ko-lang="배포"
 156                   ja-lang="配布"
 157                   es-lang="Distribuir"
 158                   >Distribute</a></li>
 159             </ul>
 160
 161             <!-- New Search -->
 162             <div class="menu-container">
 163             <div class="moremenu">
 164     <div id="more-btn"></div>
 165   </div>
 166   <div class="morehover" id="moremenu">
 167     <div class="top"></div>
 168     <div class="mid">
 169       <div class="header">Links</div>
 170       <ul>
 171         <li><a href="https://play.google.com/apps/publish/">Google Play Developer Console</a></li>
 172         <li><a href="http://android-developers.blogspot.com/">Android Developers Blog</a></li>
 173         <li><a href="/about/index.html">About Android</a></li>
 174       </ul>
 175       <div class="header">Android Sites</div>
 176       <ul>
 177         <li><a href="http://www.android.com">Android.com</a></li>
 178         <li class="active"><a>Android Developers</a></li>
 179         <li><a href="http://source.android.com">Android Open Source Project</a></li>
 180       </ul>
 181
 182
 183
 184         <div class="header">Language</div>
 185           <div id="language" class="locales">
 186             <select name="language" onChange="changeLangPref(this.value, true)">
 187                 <option value="en">English</option>
 188                 <option value="es">Español</option>
 189                 <option value="ja">日本語</option>
 190                 <option value="ko">한국어</option>
 191                 <option value="ru">Русский</option>
 192                 <option value="zh-cn">中文 (中国)</option>
 193                 <option value="zh-tw">中文 (台灣)</option>
 194             </select>
 195           </div>
 196         <script type="text/javascript">
 197           <!--
 198           loadLangPref();
 199             //-->
 200         </script>
 201
 202
 203
 204
 205       <br class="clearfix" />
 206     </div>
 207     <div class="bottom"></div>
 208   </div>
 209   <div class="search" id="search-container">
 210     <div class="search-inner">
 211       <div id="search-btn"></div>
 212       <div class="left"></div>
 213       <form onsubmit="return submit_search()">
 214         <input id="search_autocomplete" type="text" value="" autocomplete="off" name="q"
 215 onfocus="search_focus_changed(this, true)" onblur="search_focus_changed(this, false)"
 216 onkeydown="return search_changed(event, true, '/')"
 217 onkeyup="return search_changed(event, false, '/')" />
 218       </form>
 219       <div class="right"></div>
 220         <a class="close hide">close</a>
 221         <div class="left"></div>
 222         <div class="right"></div>
 223     </div>
 224   </div>
 225
 226   <div class="search_filtered_wrapper reference">
 227     <div class="suggest-card reference no-display">
 228       <ul class="search_filtered">
 229       </ul>
 230     </div>
 231   </div>
 232
 233   <div class="search_filtered_wrapper docs">
 234     <div class="suggest-card dummy no-display">&nbsp;</div>
 235     <div class="suggest-card develop no-display">
 236       <ul class="search_filtered">
 237       </ul>
 238       <div class="child-card guides no-display">
 239       </div>
 240       <div class="child-card training no-display">
 241       </div>
 242     </div>
 243     <div class="suggest-card design no-display">
 244       <ul class="search_filtered">
 245       </ul>
 246     </div>
 247     <div class="suggest-card distribute no-display">
 248       <ul class="search_filtered">
 249       </ul>
 250     </div>
 251   </div>
 252
 253   </div>
 254   <!-- /New Search>
 255
 256
 257           <!-- Expanded quicknav -->
 258            <div id="quicknav" class="col-9">
 259                 <ul>
 260                     <li class="design">
 261                       <ul>
 262                         <li><a href="/design/index.html">Get Started</a></li>
 263                         <li><a href="/design/style/index.html">Style</a></li>
 264                         <li><a href="/design/patterns/index.html">Patterns</a></li>
 265                         <li><a href="/design/building-blocks/index.html">Building Blocks</a></li>
 266                         <li><a href="/design/downloads/index.html">Downloads</a></li>
 267                         <li><a href="/design/videos/index.html">Videos</a></li>
 268                       </ul>
 269                     </li>
 270                     <li class="develop">
 271                       <ul>
 272                         <li><a href="/training/index.html"
 273                           zh-tw-lang="訓練課程"
 274                           zh-cn-lang="培训"
 275                           ru-lang="Курсы"
 276                           ko-lang="교육"
 277                           ja-lang="トレーニング"
 278                           es-lang="Capacitación"
 279                           >Training</a></li>
 280                         <li><a href="/guide/components/index.html"
 281                           zh-tw-lang="API 指南"
 282                           zh-cn-lang="API 指南"
 283                           ru-lang="Руководства по API"
 284                           ko-lang="API 가이드"
 285                           ja-lang="API ガイド"
 286                           es-lang="Guías de la API"
 287                           >API Guides</a></li>
 288                         <li><a href="/reference/packages.html"
 289                           zh-tw-lang="參考資源"
 290                           zh-cn-lang="参考"
 291                           ru-lang="Справочник"
 292                           ko-lang="참조문서"
 293                           ja-lang="リファレンス"
 294                           es-lang="Referencia"
 295                           >Reference</a></li>
 296                         <li><a href="/tools/index.html"
 297                           zh-tw-lang="相關工具"
 298                           zh-cn-lang="工具"
 299                           ru-lang="Инструменты"
 300                           ko-lang="도구"
 301                           ja-lang="ツール"
 302                           es-lang="Herramientas"
 303                           >Tools</a>
 304                           <ul><li><a href="/sdk/index.html">Get the SDK</a></li></ul>
 305                         </li>
 306                         <li><a href="/google/index.html">Google Services</a>
 307                         </li>
 308                       </ul>
 309                     </li>
 310                     <li class="distribute last">
 311                       <ul>
 312                         <li><a href="/distribute/index.html">Google Play</a></li>
 313                         <li><a href="/distribute/googleplay/publish/index.html">Publishing</a></li>
 314                         <li><a href="/distribute/googleplay/promote/index.html">Promoting</a></li>
 315                         <li><a href="/distribute/googleplay/quality/index.html">App Quality</a></li>
 316                         <li><a href="/distribute/googleplay/spotlight/index.html">Spotlight</a></li>
 317                         <li><a href="/distribute/open.html">Open Distribution</a></li>
 318                       </ul>
 319                     </li>
 320                 </ul>
 321           </div>
 322           <!-- /Expanded quicknav -->
 323         </div>
 324     </div>
 325     <!-- /Header -->
 326
 327
 328   <div id="searchResults" class="wrap" style="display:none;">
 329           <h2 id="searchTitle">Results</h2>
 330           <div id="leftSearchControl" class="search-control">Loading...</div>
 331   </div>
 332
 333
 334
 335     <!-- Secondary x-nav -->
 336     <div id="nav-x">
 337         <div class="wrap">
 338             <ul class="nav-x col-9 develop" style="width:100%">
 339                 <li class="training"><a href="/training/index.html"
 340                   zh-tw-lang="訓練課程"
 341                   zh-cn-lang="培训"
 342                   ru-lang="Курсы"
 343                   ko-lang="교육"
 344                   ja-lang="トレーニング"
 345                   es-lang="Capacitación"
 346                   >Training</a></li>
 347                 <li class="guide"><a href="/guide/components/index.html"
 348                   zh-tw-lang="API 指南"
 349                   zh-cn-lang="API 指南"
 350                   ru-lang="Руководства по API"
 351                   ko-lang="API 가이드"
 352                   ja-lang="API ガイド"
 353                   es-lang="Guías de la API"
 354                   >API Guides</a></li>
 355                 <li class="reference"><a href="/reference/packages.html"
 356                   zh-tw-lang="參考資源"
 357                   zh-cn-lang="参考"
 358                   ru-lang="Справочник"
 359                   ko-lang="참조문서"
 360                   ja-lang="リファレンス"
 361                   es-lang="Referencia"
 362                   >Reference</a></li>
 363                 <li class="tools"><a href="/tools/index.html"
 364                   zh-tw-lang="相關工具"
 365                   zh-cn-lang="工具"
 366                   ru-lang="Инструменты"
 367                   ko-lang="도구"
 368                   ja-lang="ツール"
 369                   es-lang="Herramientas"
 370                   >Tools</a></li>
 371                 <li class="google"><a href="/google/index.html"
 372                   >Google Services</a>
 373                 </li>
 374             </ul>
 375         </div>
 376
 377     </div>
 378     <!-- /Sendondary x-nav -->
 379
 380
 381
 382
 383
 384
 385
 386
 387
 388   <div class="wrap clearfix" id="body-content">
 389     <div class="col-4" id="side-nav" itemscope itemtype="http://schema.org/SiteNavigationElement">
 390       <div id="devdoc-nav" class="scroll-pane">
 391 <a class="totop" href="#top" data-g-event="left-nav-top">to top</a>
 392
 393
 394
 395 <ul id="nav">
 396
 397   <li class="nav-section">
 398     <div class="nav-section-header empty"><a href="/google/index.html">
 399           <span class="en">Overview</span>
 400       </a></div>
 401   </li>
 402
 403   <li class="nav-section">
 404     <div class="nav-section-header empty"><a href="/google/play-services/games.html">
 405           <span class="en">Games</span>
 406       </a></div>
 407   </li>
 408   <li class="nav-section">
 409     <div class="nav-section-header empty"><a href="/google/play-services/location.html">
 410           <span class="en">Location</span>
 411       </a></div>
 412   </li>
 413   <li class="nav-section">
 414     <div class="nav-section-header empty"><a href="/google/play-services/plus.html">
 415           <span class="en">Google+</span>
 416                 </a></div>
 417   </li>
 418   <li class="nav-section">
 419     <div class="nav-section-header empty"><a href="/google/play-services/maps.html">
 420           <span class="en">Google Maps</span>
 421       </a></div>
 422   </li>
 423   <li class="nav-section">
 424     <div class="nav-section-header empty"><a href="/google/play-services/auth.html">
 425           <span class="en">Authorization</span>
 426       </a></div>
 427   </li>
 428
 429
 430
 431   <li class="nav-section">
 432     <div class="nav-section-header"><a href="/google/play-services/index.html">
 433       <span class="en">Google Play Services</span></a>
 434     </div>
 435     <ul>
 436       <li><a href="/google/play-services/setup.html">
 437           <span class="en">Setup</span></a>
 438       </li>
 439       <li id="gms-tree-list" class="nav-section">
 440         <div class="nav-section-header">
 441           <a href="/reference/gms-packages.html">
 442             <span class="en">Reference</span>
 443           </a>
 444         <div>
 445       </li>
 446     </ul>
 447   </li>
 448
 449
 450   <li class="nav-section">
 451     <div class="nav-section-header"><a href="/google/play/billing/index.html">
 452       <span class="en">Google Play In-app Billing</span></a>
 453     </div>
 454     <ul>
 455       <li><a href="/google/play/billing/billing_overview.html">
 456               <span class="en">Overview</span></a>
 457       </li>
 458       <li class="nav-section"><div class="nav-section-header"><a href="/google/play/billing/api.html">
 459               <span class="en">Version 3 API</span></a></div>
 460               <ul>
 461               <li><a href="/google/play/billing/billing_integrate.html">
 462               <span class="en">Implementing the API</span></a></li>
 463               <li><a href="/google/play/billing/billing_reference.html">
 464               <span class="en">Reference</span></a></li>
 465               </ul>
 466       </li>
 467       <li class="nav-section"><div class="nav-section-header"><a href="/google/play/billing/v2/api.html">
 468               <span class="en">Version 2 API</span></a></div>
 469               <ul>
 470               <li><a href="/google/play/billing/v2/billing_integrate.html">
 471               <span class="en">Implementing the API</span></a></li>
 472               <li><a href="/google/play/billing/v2/billing_subscriptions.html">
 473               <span class="en">Subscriptions</span></a></li>
 474               <li><a href="/google/play/billing/v2/billing_reference.html">
 475               <span class="en">Reference</span></a></li>
 476               </ul>
 477       </li>
 478       <li><a href="/google/play/billing/billing_subscriptions.html">
 479               <span class="en">Subscriptions</span></a>
 480       </li>
 481       <li><a href="/google/play/billing/billing_best_practices.html">
 482               <span class="en">Security and Design</span></a>
 483       </li>
 484       <li><a href="/google/play/billing/billing_testing.html">
 485               <span class="en">Testing In-app Billing</span></a>
 486       </li>
 487       <li><a href="/google/play/billing/billing_admin.html">
 488               <span class="en">Administering In-app Billing</span></a>
 489       </li>
 490       <li><a href="/google/play/billing/gp-purchase-status-api.html">
 491               <span class="en">Purchase Status API</span></a>
 492       </li>
 493       <li><a href="/google/play/billing/versions.html">
 494               <span class="en">Version Notes</span></a>
 495       </li>
 496     </ul>
 497   </li>
 498
 499
 500
 501   <li class="nav-section">
 502       <div class="nav-section-header"><a href="/google/gcm/index.html">
 503         <span class="en">Google Cloud Messaging</span></a>
 504       </div>
 505       <ul>
 506         <li><a href="/google/gcm/gs.html">
 507             <span class="en">Getting Started</span></a>
 508         </li>
 509         <li><a href="/google/gcm/gcm.html">
 510             <span class="en">Architectural Overview</span></a>
 511         </li>
 512          <li><a href="/google/gcm/ccs.html">
 513               <span class="en">Cloud Connection Server</span></a>
 514         </li>
 515         <li><a href="/google/gcm/notifications.html">
 516               <span class="en">User Notifications</span></a>
 517         </li>
 518         <li><a href="/google/gcm/client.html">
 519             <span class="en">GCM Client</span></a>
 520         </li>
 521         <li><a href="/google/gcm/server.html">
 522             <span class="en">GCM Server</span></a>
 523         </li>
 524         <li><a href="/google/gcm/adv.html">
 525             <span class="en">Advanced Topics</span></a>
 526         </li>
 527         <li><a href="/google/gcm/c2dm.html">
 528             <span class="en">Migration</span></a>
 529         </li>
 530         <li id="gcm-tree-list" class="nav-section">
 531           <div class="nav-section-header">
 532             <a href="/reference/gcm-packages.html">
 533               <span class="en">Reference</span>
 534             </a>
 535           <div>
 536         </li>
 537       </ul>
 538   </li>
 539
 540   <li class="nav-section">
 541     <div class="nav-section-header"><a href="/google/play/dist.html">
 542       <span class="en">Google Play Distribution</span></a>
 543     </div>
 544     <ul>
 545       <li><a href="/google/play/filters.html">
 546           <span class="en">Filters on Google Play</span></a>
 547       </li>
 548
 549       <li><a href="/google/play/publishing/multiple-apks.html">
 550           <span class="en">Multiple APK Support</span></a>
 551       </li>
 552       <li><a href="/google/play/expansion-files.html">
 553           <span class="en">APK Expansion Files</span></a>
 554       </li>
 555       <li class="nav-section">
 556         <div class="nav-section-header"><a href="/google/play/licensing/index.html">
 557           <span class="en">Application Licensing</span></a>
 558         </div>
 559         <ul>
 560           <li><a href="/google/play/licensing/overview.html">
 561               <span class="en">Licensing Overview</span></a>
 562           </li>
 563           <li><a href="/google/play/licensing/setting-up.html">
 564               <span class="en">Setting Up for Licensing</span></a>
 565           </li>
 566           <li><a href="/google/play/licensing/adding-licensing.html">
 567               <span class="en">Adding Licensing to Your App</span></a>
 568           </li>
 569           <li><a href="/google/play/licensing/licensing-reference.html">
 570               <span class="en">Licensing Reference</span></a>
 571           </li>
 572         </ul>
 573       </li>
 574
 575   <li class="nav-section">
 576     <div class="nav-section-header"><a href="/google/backup/index.html">
 577       Android Backup Service</a>
 578     </div>
 579     <ul>
 580       <li><a href="/google/backup/signup.html">
 581           Register</a>
 582       </li>
 583     </ul>
 584   </li>
 585
 586   </ul>
 587
 588 </li>
 589
 590
 591
 592 </ul>
 593
 594 <script type="text/javascript">
 595 <!--
 596     buildToggleLists();
 597     changeNavLang(getLangPref());
 598 //-->
 599 </script>
 600
 601
 602
 603
 604       </div>
 605       <script type="text/javascript">
 606        showGoogleRefTree();
 607
 608       </script>
 609     </div> <!-- end side-nav -->
 610     <script>
 611       $(document).ready(function() {
 612         scrollIntoView("devdoc-nav");
 613         });
 614     </script>
 615
 616
 617
 618
 619
 620
 621 <div class="col-12"  id="doc-col">
 622
 623 <div id="api-info-block">
 624
 625
 626
 627
 628
 629
 630
 631
 632
 633
 634
 635
 636
 637
 638
 639
 640
 641
 642
 643
 644 <div class="sum-details-links">
 645
 646 Summary:
 647
 648
 649
 650
 651
 652   <a href="#constants">Constants</a>
 653
 654
 655
 656   &#124; <a href="#inhconstants">Inherited Constants</a>
 657
 658
 659
 660   &#124; <a href="#lfields">Fields</a>
 661
 662
 663
 664
 665
 666
 667   &#124; <a href="#pubmethods">Methods</a>
 668
 669
 670
 671
 672   &#124; <a href="#inhmethods">Inherited Methods</a>
 673
 674 &#124; <a href="#" onclick="return toggleAllClassInherited()" id="toggleAllClassInherited">[Expand All]</a>
 675
 676 </div><!-- end sum-details-links -->
 677 <div class="api-level">
 678
 679
 680
 681
 682 </div>
 683 </div><!-- end api-info-block -->
 684
 685
 686 <!-- ======== START OF CLASS DATA ======== -->
 687
 688 <div id="jd-header">
 689     public
 690
 691     final
 692
 693     class
 694 <h1 itemprop="name">LocationRequest</h1>
 695
 696
 697
 698
 699     extends Object<br/>
 700
 701
 702
 703
 704
 705
 706       implements
 707
 708         Parcelable
 709
 710
 711
 712
 713
 714 </div><!-- end header -->
 715
 716 <div id="naMessage"></div>
 717
 718 <div id="jd-content" class="api apilevel-">
 719 <table class="jd-inheritance-table">
 720
 721
 722     <tr>
 723
 724         <td colspan="2" class="jd-inheritance-class-cell">java.lang.Object</td>
 725     </tr>
 726
 727
 728     <tr>
 729
 730             <td class="jd-inheritance-space">&nbsp;&nbsp;&nbsp;&#x21b3;</td>
 731
 732         <td colspan="1" class="jd-inheritance-class-cell">com.google.android.gms.location.LocationRequest</td>
 733     </tr>
 734
 735
 736 </table>
 737
 738
 739
 740
 741
 742
 743
 744 <div class="jd-descr">
 745
 746
 747 <h2>Class Overview</h2>
 748 <p itemprop="articleBody">A data object that contains quality of service parameters for requests to
 749  the <code><a href="/reference/com/google/android/gms/location/LocationClient.html">LocationClient</a></code>.
 750
 751  <p>LocationRequest objects are used to request a quality of service for location updates from
 752  the <code><a href="/reference/com/google/android/gms/location/LocationClient.html">LocationClient</a></code>.
 753
 754  <p>For example, if your application wants high accuracy location it should create a location
 755  request with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> set to <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_HIGH_ACCURACY">PRIORITY_HIGH_ACCURACY</a></code> and
 756  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code> to 5 seconds. This would be appropriate for mapping applications that are
 757  showing your location in real-time.
 758
 759  <p>At the other extreme, if you want negligible power impact, but to still receive location
 760  updates when available, then create a location request with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> set to
 761  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_NO_POWER">PRIORITY_NO_POWER</a></code>. With this request your application will not trigger (and therefore
 762  will not receive any power blame) any location updates, but will receive locations triggered by
 763  other applications. This would be appropriate for  applications that have no firm requirement
 764  for location, but can take advantage when available.
 765
 766  <p>In between these two extremes is a very common use-case, where applications definitely want
 767  to receive updates at a specified interval, and can receive them faster when available, but
 768  still want a low power impact. These applications should consider
 769  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_BALANCED_POWER_ACCURACY">PRIORITY_BALANCED_POWER_ACCURACY</a></code> combined with a faster
 770  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval(long)</a></code> (such as 1 minute) and a slower <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>
 771  (such as 60 minutes). They will only be assigned power blame for the interval set by
 772  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>, but can still receive locations triggered by other applications at a rate
 773  up to <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval(long)</a></code>. This style of request is appropriate for many location aware
 774  applications, including background usage. Do be careful to also throttle
 775  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval(long)</a></code> if you perform heavy-weight work after receiving an update - such
 776  as using the network.
 777
 778  <p>Activities should strongly consider removing all location request when entering
 779  the background (for example at <code><a href="/reference/android/app/Activity.html#onPause()">onPause()</a></code>), or at least swap the
 780  request to a larger interval and lower quality.
 781
 782  <p>Applications cannot specify the exact location sources, such as GPS, that are used by the
 783  LocationClient. In fact, the system may have multiple location sources (providers) running and
 784  may fuse the results from several sources into a single Location object.
 785
 786  <p>Location requests from applications with
 787  <code><a href="/reference/android/Manifest.permission.html#ACCESS_COARSE_LOCATION">ACCESS_COARSE_LOCATION</a></code> and not
 788  <code><a href="/reference/android/Manifest.permission.html#ACCESS_FINE_LOCATION">ACCESS_FINE_LOCATION</a></code> will be automatically throttled to a
 789  slower interval, and the location object will be obfuscated to only show a coarse level of
 790  accuracy.
 791
 792  <p>All location requests are considered hints, and you may receive locations that are
 793  more/less accurate, and faster/slower than requested.
 794 </p>
 795
 796
 797
 798
 799
 800 </div><!-- jd-descr -->
 801
 802
 803
 804
 805
 806
 807
 808
 809
 810
 811
 812
 813
 814
 815
 816
 817 <div class="jd-descr">
 818
 819
 820 <h2>Summary</h2>
 821
 822
 823
 824
 825
 826
 827
 828
 829
 830
 831
 832
 833
 834 <!-- =========== ENUM CONSTANT SUMMARY =========== -->
 835 <table id="constants" class="jd-sumtable"><tr><th colspan="12">Constants</th></tr>
 836
 837
 838
 839     <tr class="alt-color api apilevel-" >
 840         <td class="jd-typecol">String</td>
 841         <td class="jd-linkcol"><a href="/reference/com/google/android/gms/location/LocationRequest.html#NULL">NULL</a></td>
 842         <td class="jd-descrcol" width="100%"></td>
 843     </tr>
 844
 845
 846     <tr class=" api apilevel-" >
 847         <td class="jd-typecol">int</td>
 848         <td class="jd-linkcol"><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_BALANCED_POWER_ACCURACY">PRIORITY_BALANCED_POWER_ACCURACY</a></td>
 849         <td class="jd-descrcol" width="100%">Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request "block" level accuracy.</td>
 850     </tr>
 851
 852
 853     <tr class="alt-color api apilevel-" >
 854         <td class="jd-typecol">int</td>
 855         <td class="jd-linkcol"><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_HIGH_ACCURACY">PRIORITY_HIGH_ACCURACY</a></td>
 856         <td class="jd-descrcol" width="100%">Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request the most accurate locations available.</td>
 857     </tr>
 858
 859
 860     <tr class=" api apilevel-" >
 861         <td class="jd-typecol">int</td>
 862         <td class="jd-linkcol"><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_NO_POWER">PRIORITY_NO_POWER</a></td>
 863         <td class="jd-descrcol" width="100%">Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request the best accuracy possible with zero additional
 864  power consumption.</td>
 865     </tr>
 866
 867
 868
 869 </table>
 870
 871
 872
 873
 874
 875 <!-- =========== ENUM CONSTANT SUMMARY =========== -->
 876 <table id="inhconstants" class="jd-sumtable"><tr><th>
 877   <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
 878   <div style="clear:left;">Inherited Constants</div></th></tr>
 879
 880
 881
 882
 883 <tr class="api apilevel-" >
 884 <td colspan="12">
 885
 886   <a href="#" onclick="return toggleInherited(this, null)" id="inherited-constants-android.os.Parcelable" class="jd-expando-trigger closed"
 887           ><img id="inherited-constants-android.os.Parcelable-trigger"
 888           src="/assets/images/triangle-closed.png"
 889           class="jd-expando-trigger-img" /></a>From interface
 890 android.os.Parcelable
 891 <div id="inherited-constants-android.os.Parcelable">
 892   <div id="inherited-constants-android.os.Parcelable-list"
 893         class="jd-inheritedlinks">
 894   </div>
 895   <div id="inherited-constants-android.os.Parcelable-summary" style="display: none;">
 896     <table class="jd-sumtable-expando">
 897
 898
 899
 900     <tr class="alt-color api apilevel-" >
 901         <td class="jd-typecol">int</td>
 902         <td class="jd-linkcol">CONTENTS_FILE_DESCRIPTOR</td>
 903         <td class="jd-descrcol" width="100%"></td>
 904     </tr>
 905
 906
 907     <tr class=" api apilevel-" >
 908         <td class="jd-typecol">int</td>
 909         <td class="jd-linkcol">PARCELABLE_WRITE_RETURN_VALUE</td>
 910         <td class="jd-descrcol" width="100%"></td>
 911     </tr>
 912
 913
 914 </table>
 915   </div>
 916 </div>
 917 </td></tr>
 918
 919
 920 </table>
 921
 922
 923
 924
 925 <!-- =========== FIELD SUMMARY =========== -->
 926 <table id="lfields" class="jd-sumtable"><tr><th colspan="12">Fields</th></tr>
 927
 928
 929
 930       <tr class="alt-color api apilevel-" >
 931           <td class="jd-typecol"><nobr>
 932           public
 933           static
 934           final
 935           <a href="/reference/com/google/android/gms/location/LocationRequestCreator.html">LocationRequestCreator</a></nobr></td>
 936           <td class="jd-linkcol"><a href="/reference/com/google/android/gms/location/LocationRequest.html#CREATOR">CREATOR</a></td>
 937           <td class="jd-descrcol" width="100%"></td>
 938       </tr>
 939
 940
 941
 942 </table>
 943
 944
 945
 946
 947
 948
 949
 950
 951
 952
 953
 954 <!-- ========== METHOD SUMMARY =========== -->
 955 <table id="pubmethods" class="jd-sumtable"><tr><th colspan="12">Public Methods</th></tr>
 956
 957
 958
 959
 960     <tr class="alt-color api apilevel-" >
 961         <td class="jd-typecol"><nobr>
 962
 963
 964
 965             static
 966
 967             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
 968         </td>
 969         <td class="jd-linkcol" width="100%"><nobr>
 970         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#create()">create</a></span>()</nobr>
 971
 972         <div class="jd-descrdiv">Create a location request with default parameters.</div>
 973
 974   </td></tr>
 975
 976
 977
 978     <tr class=" api apilevel-" >
 979         <td class="jd-typecol"><nobr>
 980
 981
 982
 983
 984
 985             int</nobr>
 986         </td>
 987         <td class="jd-linkcol" width="100%"><nobr>
 988         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#describeContents()">describeContents</a></span>()</nobr>
 989
 990   </td></tr>
 991
 992
 993
 994     <tr class="alt-color api apilevel-" >
 995         <td class="jd-typecol"><nobr>
 996
 997
 998
 999
1000
1001             boolean</nobr>
1002         </td>
1003         <td class="jd-linkcol" width="100%"><nobr>
1004         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#equals(java.lang.Object)">equals</a></span>(Object object)</nobr>
1005
1006   </td></tr>
1007
1008
1009
1010     <tr class=" api apilevel-" >
1011         <td class="jd-typecol"><nobr>
1012
1013
1014
1015
1016
1017             long</nobr>
1018         </td>
1019         <td class="jd-linkcol" width="100%"><nobr>
1020         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getExpirationTime()">getExpirationTime</a></span>()</nobr>
1021
1022         <div class="jd-descrdiv">Get the request expiration time, in milliseconds since boot.</div>
1023
1024   </td></tr>
1025
1026
1027
1028     <tr class="alt-color api apilevel-" >
1029         <td class="jd-typecol"><nobr>
1030
1031
1032
1033
1034
1035             long</nobr>
1036         </td>
1037         <td class="jd-linkcol" width="100%"><nobr>
1038         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getFastestInterval()">getFastestInterval</a></span>()</nobr>
1039
1040         <div class="jd-descrdiv">Get the fastest interval of this request, in milliseconds.</div>
1041
1042   </td></tr>
1043
1044
1045
1046     <tr class=" api apilevel-" >
1047         <td class="jd-typecol"><nobr>
1048
1049
1050
1051
1052
1053             long</nobr>
1054         </td>
1055         <td class="jd-linkcol" width="100%"><nobr>
1056         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getInterval()">getInterval</a></span>()</nobr>
1057
1058         <div class="jd-descrdiv">Get the desired interval of this request, in milliseconds.</div>
1059
1060   </td></tr>
1061
1062
1063
1064     <tr class="alt-color api apilevel-" >
1065         <td class="jd-typecol"><nobr>
1066
1067
1068
1069
1070
1071             int</nobr>
1072         </td>
1073         <td class="jd-linkcol" width="100%"><nobr>
1074         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getNumUpdates()">getNumUpdates</a></span>()</nobr>
1075
1076         <div class="jd-descrdiv">Get the number of updates requested.</div>
1077
1078   </td></tr>
1079
1080
1081
1082     <tr class=" api apilevel-" >
1083         <td class="jd-typecol"><nobr>
1084
1085
1086
1087
1088
1089             int</nobr>
1090         </td>
1091         <td class="jd-linkcol" width="100%"><nobr>
1092         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getPriority()">getPriority</a></span>()</nobr>
1093
1094         <div class="jd-descrdiv">Get the quality of the request.</div>
1095
1096   </td></tr>
1097
1098
1099
1100     <tr class="alt-color api apilevel-" >
1101         <td class="jd-typecol"><nobr>
1102
1103
1104
1105
1106
1107             float</nobr>
1108         </td>
1109         <td class="jd-linkcol" width="100%"><nobr>
1110         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#getSmallestDisplacement()">getSmallestDisplacement</a></span>()</nobr>
1111
1112         <div class="jd-descrdiv">Get the minimum displacement between location updates in meters
1113
1114  <p>By default this is 0.</div>
1115
1116   </td></tr>
1117
1118
1119
1120     <tr class=" api apilevel-" >
1121         <td class="jd-typecol"><nobr>
1122
1123
1124
1125
1126
1127             int</nobr>
1128         </td>
1129         <td class="jd-linkcol" width="100%"><nobr>
1130         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#hashCode()">hashCode</a></span>()</nobr>
1131
1132   </td></tr>
1133
1134
1135
1136     <tr class="alt-color api apilevel-" >
1137         <td class="jd-typecol"><nobr>
1138
1139
1140
1141
1142
1143             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1144         </td>
1145         <td class="jd-linkcol" width="100%"><nobr>
1146         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setExpirationDuration(long)">setExpirationDuration</a></span>(long millis)</nobr>
1147
1148         <div class="jd-descrdiv">Set the duration of this request, in milliseconds.</div>
1149
1150   </td></tr>
1151
1152
1153
1154     <tr class=" api apilevel-" >
1155         <td class="jd-typecol"><nobr>
1156
1157
1158
1159
1160
1161             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1162         </td>
1163         <td class="jd-linkcol" width="100%"><nobr>
1164         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setExpirationTime(long)">setExpirationTime</a></span>(long millis)</nobr>
1165
1166         <div class="jd-descrdiv">Set the request expiration time, in millisecond since boot.</div>
1167
1168   </td></tr>
1169
1170
1171
1172     <tr class="alt-color api apilevel-" >
1173         <td class="jd-typecol"><nobr>
1174
1175
1176
1177
1178
1179             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1180         </td>
1181         <td class="jd-linkcol" width="100%"><nobr>
1182         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval</a></span>(long millis)</nobr>
1183
1184         <div class="jd-descrdiv">Explicitly set the fastest interval for location updates, in milliseconds.</div>
1185
1186   </td></tr>
1187
1188
1189
1190     <tr class=" api apilevel-" >
1191         <td class="jd-typecol"><nobr>
1192
1193
1194
1195
1196
1197             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1198         </td>
1199         <td class="jd-linkcol" width="100%"><nobr>
1200         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval</a></span>(long millis)</nobr>
1201
1202         <div class="jd-descrdiv">Set the desired interval for active location updates, in milliseconds.</div>
1203
1204   </td></tr>
1205
1206
1207
1208     <tr class="alt-color api apilevel-" >
1209         <td class="jd-typecol"><nobr>
1210
1211
1212
1213
1214
1215             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1216         </td>
1217         <td class="jd-linkcol" width="100%"><nobr>
1218         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setNumUpdates(int)">setNumUpdates</a></span>(int numUpdates)</nobr>
1219
1220         <div class="jd-descrdiv">Set the number of location updates.</div>
1221
1222   </td></tr>
1223
1224
1225
1226     <tr class=" api apilevel-" >
1227         <td class="jd-typecol"><nobr>
1228
1229
1230
1231
1232
1233             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1234         </td>
1235         <td class="jd-linkcol" width="100%"><nobr>
1236         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority</a></span>(int priority)</nobr>
1237
1238         <div class="jd-descrdiv">Set the priority of the request.</div>
1239
1240   </td></tr>
1241
1242
1243
1244     <tr class="alt-color api apilevel-" >
1245         <td class="jd-typecol"><nobr>
1246
1247
1248
1249
1250
1251             <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a></nobr>
1252         </td>
1253         <td class="jd-linkcol" width="100%"><nobr>
1254         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#setSmallestDisplacement(float)">setSmallestDisplacement</a></span>(float smallestDisplacementMeters)</nobr>
1255
1256         <div class="jd-descrdiv">Set the minimum displacement between location updates in meters
1257
1258  <p>By default this is 0.</div>
1259
1260   </td></tr>
1261
1262
1263
1264     <tr class=" api apilevel-" >
1265         <td class="jd-typecol"><nobr>
1266
1267
1268
1269
1270
1271             String</nobr>
1272         </td>
1273         <td class="jd-linkcol" width="100%"><nobr>
1274         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#toString()">toString</a></span>()</nobr>
1275
1276   </td></tr>
1277
1278
1279
1280     <tr class="alt-color api apilevel-" >
1281         <td class="jd-typecol"><nobr>
1282
1283
1284
1285
1286
1287             void</nobr>
1288         </td>
1289         <td class="jd-linkcol" width="100%"><nobr>
1290         <span class="sympad"><a href="/reference/com/google/android/gms/location/LocationRequest.html#writeToParcel(android.os.Parcel, int)">writeToParcel</a></span>(Parcel parcel, int flags)</nobr>
1291
1292   </td></tr>
1293
1294
1295
1296 </table>
1297
1298
1299
1300
1301
1302
1303
1304 <!-- ========== METHOD SUMMARY =========== -->
1305 <table id="inhmethods" class="jd-sumtable"><tr><th>
1306   <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
1307   <div style="clear:left;">Inherited Methods</div></th></tr>
1308
1309
1310 <tr class="api apilevel-" >
1311 <td colspan="12">
1312   <a href="#" onclick="return toggleInherited(this, null)" id="inherited-methods-java.lang.Object" class="jd-expando-trigger closed"
1313           ><img id="inherited-methods-java.lang.Object-trigger"
1314           src="/assets/images/triangle-closed.png"
1315           class="jd-expando-trigger-img" /></a>
1316 From class
1317
1318   java.lang.Object
1319
1320 <div id="inherited-methods-java.lang.Object">
1321   <div id="inherited-methods-java.lang.Object-list"
1322         class="jd-inheritedlinks">
1323   </div>
1324   <div id="inherited-methods-java.lang.Object-summary" style="display: none;">
1325     <table class="jd-sumtable-expando">
1326
1327
1328
1329
1330     <tr class="alt-color api apilevel-" >
1331         <td class="jd-typecol"><nobr>
1332
1333
1334
1335
1336
1337             Object</nobr>
1338         </td>
1339         <td class="jd-linkcol" width="100%"><nobr>
1340         <span class="sympad">clone</span>()</nobr>
1341
1342   </td></tr>
1343
1344
1345
1346     <tr class=" api apilevel-" >
1347         <td class="jd-typecol"><nobr>
1348
1349
1350
1351
1352
1353             boolean</nobr>
1354         </td>
1355         <td class="jd-linkcol" width="100%"><nobr>
1356         <span class="sympad">equals</span>(Object arg0)</nobr>
1357
1358   </td></tr>
1359
1360
1361
1362     <tr class="alt-color api apilevel-" >
1363         <td class="jd-typecol"><nobr>
1364
1365
1366
1367
1368
1369             void</nobr>
1370         </td>
1371         <td class="jd-linkcol" width="100%"><nobr>
1372         <span class="sympad">finalize</span>()</nobr>
1373
1374   </td></tr>
1375
1376
1377
1378     <tr class=" api apilevel-" >
1379         <td class="jd-typecol"><nobr>
1380
1381
1382             final
1383
1384
1385             Class&lt;?&gt;</nobr>
1386         </td>
1387         <td class="jd-linkcol" width="100%"><nobr>
1388         <span class="sympad">getClass</span>()</nobr>
1389
1390   </td></tr>
1391
1392
1393
1394     <tr class="alt-color api apilevel-" >
1395         <td class="jd-typecol"><nobr>
1396
1397
1398
1399
1400
1401             int</nobr>
1402         </td>
1403         <td class="jd-linkcol" width="100%"><nobr>
1404         <span class="sympad">hashCode</span>()</nobr>
1405
1406   </td></tr>
1407
1408
1409
1410     <tr class=" api apilevel-" >
1411         <td class="jd-typecol"><nobr>
1412
1413
1414             final
1415
1416
1417             void</nobr>
1418         </td>
1419         <td class="jd-linkcol" width="100%"><nobr>
1420         <span class="sympad">notify</span>()</nobr>
1421
1422   </td></tr>
1423
1424
1425
1426     <tr class="alt-color api apilevel-" >
1427         <td class="jd-typecol"><nobr>
1428
1429
1430             final
1431
1432
1433             void</nobr>
1434         </td>
1435         <td class="jd-linkcol" width="100%"><nobr>
1436         <span class="sympad">notifyAll</span>()</nobr>
1437
1438   </td></tr>
1439
1440
1441
1442     <tr class=" api apilevel-" >
1443         <td class="jd-typecol"><nobr>
1444
1445
1446
1447
1448
1449             String</nobr>
1450         </td>
1451         <td class="jd-linkcol" width="100%"><nobr>
1452         <span class="sympad">toString</span>()</nobr>
1453
1454   </td></tr>
1455
1456
1457
1458     <tr class="alt-color api apilevel-" >
1459         <td class="jd-typecol"><nobr>
1460
1461
1462             final
1463
1464
1465             void</nobr>
1466         </td>
1467         <td class="jd-linkcol" width="100%"><nobr>
1468         <span class="sympad">wait</span>()</nobr>
1469
1470   </td></tr>
1471
1472
1473
1474     <tr class=" api apilevel-" >
1475         <td class="jd-typecol"><nobr>
1476
1477
1478             final
1479
1480
1481             void</nobr>
1482         </td>
1483         <td class="jd-linkcol" width="100%"><nobr>
1484         <span class="sympad">wait</span>(long arg0, int arg1)</nobr>
1485
1486   </td></tr>
1487
1488
1489
1490     <tr class="alt-color api apilevel-" >
1491         <td class="jd-typecol"><nobr>
1492
1493
1494             final
1495
1496
1497             void</nobr>
1498         </td>
1499         <td class="jd-linkcol" width="100%"><nobr>
1500         <span class="sympad">wait</span>(long arg0)</nobr>
1501
1502   </td></tr>
1503
1504
1505 </table>
1506   </div>
1507 </div>
1508 </td></tr>
1509
1510
1511
1512 <tr class="api apilevel-" >
1513 <td colspan="12">
1514   <a href="#" onclick="return toggleInherited(this, null)" id="inherited-methods-android.os.Parcelable" class="jd-expando-trigger closed"
1515           ><img id="inherited-methods-android.os.Parcelable-trigger"
1516           src="/assets/images/triangle-closed.png"
1517           class="jd-expando-trigger-img" /></a>
1518 From interface
1519
1520   android.os.Parcelable
1521
1522 <div id="inherited-methods-android.os.Parcelable">
1523   <div id="inherited-methods-android.os.Parcelable-list"
1524         class="jd-inheritedlinks">
1525   </div>
1526   <div id="inherited-methods-android.os.Parcelable-summary" style="display: none;">
1527     <table class="jd-sumtable-expando">
1528
1529
1530
1531
1532     <tr class="alt-color api apilevel-" >
1533         <td class="jd-typecol"><nobr>
1534             abstract
1535
1536
1537
1538
1539             int</nobr>
1540         </td>
1541         <td class="jd-linkcol" width="100%"><nobr>
1542         <span class="sympad">describeContents</span>()</nobr>
1543
1544   </td></tr>
1545
1546
1547
1548     <tr class=" api apilevel-" >
1549         <td class="jd-typecol"><nobr>
1550             abstract
1551
1552
1553
1554
1555             void</nobr>
1556         </td>
1557         <td class="jd-linkcol" width="100%"><nobr>
1558         <span class="sympad">writeToParcel</span>(Parcel arg0, int arg1)</nobr>
1559
1560   </td></tr>
1561
1562
1563 </table>
1564   </div>
1565 </div>
1566 </td></tr>
1567
1568
1569 </table>
1570
1571
1572 </div><!-- jd-descr (summary) -->
1573
1574 <!-- Details -->
1575
1576
1577
1578
1579
1580
1581
1582
1583 <!-- XML Attributes -->
1584
1585
1586 <!-- Enum Values -->
1587
1588
1589 <!-- Constants -->
1590
1591
1592 <!-- ========= ENUM CONSTANTS DETAIL ======== -->
1593 <h2>Constants</h2>
1594
1595
1596
1597
1598 <A NAME="NULL"></A>
1599
1600 <div class="jd-details api apilevel-">
1601     <h4 class="jd-details-title">
1602       <span class="normal">
1603         public
1604         static
1605         final
1606         String
1607       </span>
1608         NULL
1609     </h4>
1610       <div class="api-level">
1611
1612
1613
1614
1615       </div>
1616     <div class="jd-details-descr">
1617
1618   <div class="jd-tagdata jd-tagdescr"><p></p></div>
1619
1620
1621         <div class="jd-tagdata">
1622         <span class="jd-tagtitle">Constant Value: </span>
1623         <span>
1624
1625                 "SAFE_PARCELABLE_NULL_STRING"
1626
1627         </span>
1628         </div>
1629
1630     </div>
1631 </div>
1632
1633
1634
1635 <A NAME="PRIORITY_BALANCED_POWER_ACCURACY"></A>
1636
1637 <div class="jd-details api apilevel-">
1638     <h4 class="jd-details-title">
1639       <span class="normal">
1640         public
1641         static
1642         final
1643         int
1644       </span>
1645         PRIORITY_BALANCED_POWER_ACCURACY
1646     </h4>
1647       <div class="api-level">
1648
1649
1650
1651
1652       </div>
1653     <div class="jd-details-descr">
1654
1655   <div class="jd-tagdata jd-tagdescr"><p>Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request "block" level accuracy.
1656
1657  <p>Block level accuracy is considered to be about 100 meter accuracy. Using a coarse
1658  accuracy such as this often consumes less power.
1659 </p></div>
1660
1661
1662         <div class="jd-tagdata">
1663         <span class="jd-tagtitle">Constant Value: </span>
1664         <span>
1665
1666                 102
1667                 (0x00000066)
1668
1669         </span>
1670         </div>
1671
1672     </div>
1673 </div>
1674
1675
1676
1677 <A NAME="PRIORITY_HIGH_ACCURACY"></A>
1678
1679 <div class="jd-details api apilevel-">
1680     <h4 class="jd-details-title">
1681       <span class="normal">
1682         public
1683         static
1684         final
1685         int
1686       </span>
1687         PRIORITY_HIGH_ACCURACY
1688     </h4>
1689       <div class="api-level">
1690
1691
1692
1693
1694       </div>
1695     <div class="jd-details-descr">
1696
1697   <div class="jd-tagdata jd-tagdescr"><p>Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request the most accurate locations available.
1698
1699  <p>This will return the finest location available.
1700 </p></div>
1701
1702
1703         <div class="jd-tagdata">
1704         <span class="jd-tagtitle">Constant Value: </span>
1705         <span>
1706
1707                 100
1708                 (0x00000064)
1709
1710         </span>
1711         </div>
1712
1713     </div>
1714 </div>
1715
1716
1717
1718 <A NAME="PRIORITY_NO_POWER"></A>
1719
1720 <div class="jd-details api apilevel-">
1721     <h4 class="jd-details-title">
1722       <span class="normal">
1723         public
1724         static
1725         final
1726         int
1727       </span>
1728         PRIORITY_NO_POWER
1729     </h4>
1730       <div class="api-level">
1731
1732
1733
1734
1735       </div>
1736     <div class="jd-details-descr">
1737
1738   <div class="jd-tagdata jd-tagdescr"><p>Used with <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> to request the best accuracy possible with zero additional
1739  power consumption.
1740
1741  <p>No locations will be returned unless a different client has requested location updates
1742  in which case this request will act as a passive listener to those locations.
1743 </p></div>
1744
1745
1746         <div class="jd-tagdata">
1747         <span class="jd-tagtitle">Constant Value: </span>
1748         <span>
1749
1750                 105
1751                 (0x00000069)
1752
1753         </span>
1754         </div>
1755
1756     </div>
1757 </div>
1758
1759
1760
1761
1762 <!-- Fields -->
1763
1764
1765 <!-- ========= FIELD DETAIL ======== -->
1766 <h2>Fields</h2>
1767
1768
1769
1770
1771 <A NAME="CREATOR"></A>
1772
1773 <div class="jd-details api apilevel-">
1774     <h4 class="jd-details-title">
1775       <span class="normal">
1776         public
1777         static
1778         final
1779         <a href="/reference/com/google/android/gms/location/LocationRequestCreator.html">LocationRequestCreator</a>
1780       </span>
1781         CREATOR
1782     </h4>
1783       <div class="api-level">
1784
1785
1786
1787
1788       </div>
1789     <div class="jd-details-descr">
1790
1791   <div class="jd-tagdata jd-tagdescr"><p></p></div>
1792
1793
1794     </div>
1795 </div>
1796
1797
1798
1799
1800 <!-- Public ctors -->
1801
1802
1803
1804 <!-- ========= CONSTRUCTOR DETAIL ======== -->
1805 <!-- Protected ctors -->
1806
1807
1808
1809 <!-- ========= METHOD DETAIL ======== -->
1810 <!-- Public methdos -->
1811
1812 <h2>Public Methods</h2>
1813
1814
1815
1816 <A NAME="create()"></A>
1817
1818 <div class="jd-details api apilevel-">
1819     <h4 class="jd-details-title">
1820       <span class="normal">
1821         public
1822         static
1823
1824
1825
1826         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
1827       </span>
1828       <span class="sympad">create</span>
1829       <span class="normal">()</span>
1830     </h4>
1831       <div class="api-level">
1832         <div></div>
1833
1834
1835
1836       </div>
1837     <div class="jd-details-descr">
1838
1839   <div class="jd-tagdata jd-tagdescr"><p>Create a location request with default parameters.
1840
1841  <p>Default parameters are for a block accuracy, slowly updated location. It can then be
1842  adjusted as required by the applications before passing to the <code><a href="/reference/com/google/android/gms/location/LocationClient.html">LocationClient</a></code>.</p></div>
1843   <div class="jd-tagdata">
1844       <h5 class="jd-tagtitle">Returns</h5>
1845       <ul class="nolist"><li>a new location request
1846 </li></ul>
1847   </div>
1848
1849     </div>
1850 </div>
1851
1852
1853 <A NAME="describeContents()"></A>
1854
1855 <div class="jd-details api apilevel-">
1856     <h4 class="jd-details-title">
1857       <span class="normal">
1858         public
1859
1860
1861
1862
1863         int
1864       </span>
1865       <span class="sympad">describeContents</span>
1866       <span class="normal">()</span>
1867     </h4>
1868       <div class="api-level">
1869         <div></div>
1870
1871
1872
1873       </div>
1874     <div class="jd-details-descr">
1875
1876   <div class="jd-tagdata jd-tagdescr"><p></p></div>
1877
1878     </div>
1879 </div>
1880
1881
1882 <A NAME="equals(java.lang.Object)"></A>
1883
1884 <div class="jd-details api apilevel-">
1885     <h4 class="jd-details-title">
1886       <span class="normal">
1887         public
1888
1889
1890
1891
1892         boolean
1893       </span>
1894       <span class="sympad">equals</span>
1895       <span class="normal">(Object object)</span>
1896     </h4>
1897       <div class="api-level">
1898         <div></div>
1899
1900
1901
1902       </div>
1903     <div class="jd-details-descr">
1904
1905   <div class="jd-tagdata jd-tagdescr"><p></p></div>
1906
1907     </div>
1908 </div>
1909
1910
1911 <A NAME="getExpirationTime()"></A>
1912
1913 <div class="jd-details api apilevel-">
1914     <h4 class="jd-details-title">
1915       <span class="normal">
1916         public
1917
1918
1919
1920
1921         long
1922       </span>
1923       <span class="sympad">getExpirationTime</span>
1924       <span class="normal">()</span>
1925     </h4>
1926       <div class="api-level">
1927         <div></div>
1928
1929
1930
1931       </div>
1932     <div class="jd-details-descr">
1933
1934   <div class="jd-tagdata jd-tagdescr"><p>Get the request expiration time, in milliseconds since boot.
1935
1936  <p>This value can be compared to <code><a href="/reference/android/os/SystemClock.html#elapsedRealtime()">elapsedRealtime()</a></code> to determine the time
1937  until expiration.</p></div>
1938   <div class="jd-tagdata">
1939       <h5 class="jd-tagtitle">Returns</h5>
1940       <ul class="nolist"><li>expiration time of request, in milliseconds since boot including suspend
1941 </li></ul>
1942   </div>
1943
1944     </div>
1945 </div>
1946
1947
1948 <A NAME="getFastestInterval()"></A>
1949
1950 <div class="jd-details api apilevel-">
1951     <h4 class="jd-details-title">
1952       <span class="normal">
1953         public
1954
1955
1956
1957
1958         long
1959       </span>
1960       <span class="sympad">getFastestInterval</span>
1961       <span class="normal">()</span>
1962     </h4>
1963       <div class="api-level">
1964         <div></div>
1965
1966
1967
1968       </div>
1969     <div class="jd-details-descr">
1970
1971   <div class="jd-tagdata jd-tagdescr"><p>Get the fastest interval of this request, in milliseconds.
1972
1973  <p>The system will never provide location updates faster than the minimum of
1974  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#getFastestInterval()">getFastestInterval()</a></code> and <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#getInterval()">getInterval()</a></code>.</p></div>
1975   <div class="jd-tagdata">
1976       <h5 class="jd-tagtitle">Returns</h5>
1977       <ul class="nolist"><li>fastest interval in milliseconds, exact
1978 </li></ul>
1979   </div>
1980
1981     </div>
1982 </div>
1983
1984
1985 <A NAME="getInterval()"></A>
1986
1987 <div class="jd-details api apilevel-">
1988     <h4 class="jd-details-title">
1989       <span class="normal">
1990         public
1991
1992
1993
1994
1995         long
1996       </span>
1997       <span class="sympad">getInterval</span>
1998       <span class="normal">()</span>
1999     </h4>
2000       <div class="api-level">
2001         <div></div>
2002
2003
2004
2005       </div>
2006     <div class="jd-details-descr">
2007
2008   <div class="jd-tagdata jd-tagdescr"><p>Get the desired interval of this request, in milliseconds.</p></div>
2009   <div class="jd-tagdata">
2010       <h5 class="jd-tagtitle">Returns</h5>
2011       <ul class="nolist"><li>desired interval in milliseconds, inexact
2012 </li></ul>
2013   </div>
2014
2015     </div>
2016 </div>
2017
2018
2019 <A NAME="getNumUpdates()"></A>
2020
2021 <div class="jd-details api apilevel-">
2022     <h4 class="jd-details-title">
2023       <span class="normal">
2024         public
2025
2026
2027
2028
2029         int
2030       </span>
2031       <span class="sympad">getNumUpdates</span>
2032       <span class="normal">()</span>
2033     </h4>
2034       <div class="api-level">
2035         <div></div>
2036
2037
2038
2039       </div>
2040     <div class="jd-details-descr">
2041
2042   <div class="jd-tagdata jd-tagdescr"><p>Get the number of updates requested.
2043
2044  <p>By default this is <code><a href="/reference/java/lang/Integer.html#MAX_VALUE">MAX_VALUE</a></code>, which indicates that locations are updated
2045  until the request is explicitly removed.</p></div>
2046   <div class="jd-tagdata">
2047       <h5 class="jd-tagtitle">Returns</h5>
2048       <ul class="nolist"><li>number of updates
2049 </li></ul>
2050   </div>
2051
2052     </div>
2053 </div>
2054
2055
2056 <A NAME="getPriority()"></A>
2057
2058 <div class="jd-details api apilevel-">
2059     <h4 class="jd-details-title">
2060       <span class="normal">
2061         public
2062
2063
2064
2065
2066         int
2067       </span>
2068       <span class="sympad">getPriority</span>
2069       <span class="normal">()</span>
2070     </h4>
2071       <div class="api-level">
2072         <div></div>
2073
2074
2075
2076       </div>
2077     <div class="jd-details-descr">
2078
2079   <div class="jd-tagdata jd-tagdescr"><p>Get the quality of the request.</p></div>
2080   <div class="jd-tagdata">
2081       <h5 class="jd-tagtitle">Returns</h5>
2082       <ul class="nolist"><li>an accuracy constant
2083 </li></ul>
2084   </div>
2085
2086     </div>
2087 </div>
2088
2089
2090 <A NAME="getSmallestDisplacement()"></A>
2091
2092 <div class="jd-details api apilevel-">
2093     <h4 class="jd-details-title">
2094       <span class="normal">
2095         public
2096
2097
2098
2099
2100         float
2101       </span>
2102       <span class="sympad">getSmallestDisplacement</span>
2103       <span class="normal">()</span>
2104     </h4>
2105       <div class="api-level">
2106         <div></div>
2107
2108
2109
2110       </div>
2111     <div class="jd-details-descr">
2112
2113   <div class="jd-tagdata jd-tagdescr"><p>Get the minimum displacement between location updates in meters
2114
2115  <p>By default this is 0.</p></div>
2116   <div class="jd-tagdata">
2117       <h5 class="jd-tagtitle">Returns</h5>
2118       <ul class="nolist"><li>minimum displacement between location updates in meters
2119 </li></ul>
2120   </div>
2121
2122     </div>
2123 </div>
2124
2125
2126 <A NAME="hashCode()"></A>
2127
2128 <div class="jd-details api apilevel-">
2129     <h4 class="jd-details-title">
2130       <span class="normal">
2131         public
2132
2133
2134
2135
2136         int
2137       </span>
2138       <span class="sympad">hashCode</span>
2139       <span class="normal">()</span>
2140     </h4>
2141       <div class="api-level">
2142         <div></div>
2143
2144
2145
2146       </div>
2147     <div class="jd-details-descr">
2148
2149   <div class="jd-tagdata jd-tagdescr"><p></p></div>
2150
2151     </div>
2152 </div>
2153
2154
2155 <A NAME="setExpirationDuration(long)"></A>
2156
2157 <div class="jd-details api apilevel-">
2158     <h4 class="jd-details-title">
2159       <span class="normal">
2160         public
2161
2162
2163
2164
2165         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2166       </span>
2167       <span class="sympad">setExpirationDuration</span>
2168       <span class="normal">(long millis)</span>
2169     </h4>
2170       <div class="api-level">
2171         <div></div>
2172
2173
2174
2175       </div>
2176     <div class="jd-details-descr">
2177
2178   <div class="jd-tagdata jd-tagdescr"><p>Set the duration of this request, in milliseconds.
2179
2180  <p>The duration begins immediately (and not when the request is passed to the location
2181  client), so call this method again if the request is re-used at a later time.
2182
2183  <p>The location client will automatically stop updates after the request expires.
2184
2185  <p>The duration includes suspend time. Values less than 0 are allowed, but indicate that
2186  the request has already expired.</p></div>
2187   <div class="jd-tagdata">
2188       <h5 class="jd-tagtitle">Parameters</h5>
2189       <table class="jd-tagtable">
2190         <tr>
2191           <th>millis</td>
2192           <td>duration of request in milliseconds</td>
2193         </tr>
2194       </table>
2195   </div>
2196   <div class="jd-tagdata">
2197       <h5 class="jd-tagtitle">Returns</h5>
2198       <ul class="nolist"><li>the same object, so that setters can be chained
2199 </li></ul>
2200   </div>
2201
2202     </div>
2203 </div>
2204
2205
2206 <A NAME="setExpirationTime(long)"></A>
2207
2208 <div class="jd-details api apilevel-">
2209     <h4 class="jd-details-title">
2210       <span class="normal">
2211         public
2212
2213
2214
2215
2216         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2217       </span>
2218       <span class="sympad">setExpirationTime</span>
2219       <span class="normal">(long millis)</span>
2220     </h4>
2221       <div class="api-level">
2222         <div></div>
2223
2224
2225
2226       </div>
2227     <div class="jd-details-descr">
2228
2229   <div class="jd-tagdata jd-tagdescr"><p>Set the request expiration time, in millisecond since boot.
2230
2231  <p>This expiration time uses the same time base as <code><a href="/reference/android/os/SystemClock.html#elapsedRealtime()">elapsedRealtime()</a></code>.
2232
2233  <p>The location client will automatically stop updates after the request expires.
2234
2235  <p>The duration includes suspend time. Values before <code><a href="/reference/android/os/SystemClock.html#elapsedRealtime()">elapsedRealtime()</a></code>
2236  are allowed, but indicate that the request has already expired.</p></div>
2237   <div class="jd-tagdata">
2238       <h5 class="jd-tagtitle">Parameters</h5>
2239       <table class="jd-tagtable">
2240         <tr>
2241           <th>millis</td>
2242           <td>expiration time of request, in milliseconds since boot including suspend</td>
2243         </tr>
2244       </table>
2245   </div>
2246   <div class="jd-tagdata">
2247       <h5 class="jd-tagtitle">Returns</h5>
2248       <ul class="nolist"><li>the same object, so that setters can be chained
2249 </li></ul>
2250   </div>
2251
2252     </div>
2253 </div>
2254
2255
2256 <A NAME="setFastestInterval(long)"></A>
2257
2258 <div class="jd-details api apilevel-">
2259     <h4 class="jd-details-title">
2260       <span class="normal">
2261         public
2262
2263
2264
2265
2266         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2267       </span>
2268       <span class="sympad">setFastestInterval</span>
2269       <span class="normal">(long millis)</span>
2270     </h4>
2271       <div class="api-level">
2272         <div></div>
2273
2274
2275
2276       </div>
2277     <div class="jd-details-descr">
2278
2279   <div class="jd-tagdata jd-tagdescr"><p>Explicitly set the fastest interval for location updates, in milliseconds.
2280
2281  <p>This controls the fastest rate at which your application will receive location updates,
2282  which might be faster than <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code> in some situations (for example, if other
2283  applications are triggering location updates).
2284
2285  <p>This allows your application to passively acquire locations at a rate faster than it
2286  actively acquires locations, saving power.
2287
2288  <p>Unlike <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>, this parameter is exact. Your application will never
2289  receive updates faster than this value.
2290
2291  <p>If you don't call this method, a fastest interval will be selected for you. It will be
2292  a value faster than your active interval (<code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>).
2293
2294  <p>An interval of 0 is allowed, but not recommended, since location updates may be
2295  extremely fast on future implementations.
2296
2297  <p>If <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval(long)</a></code> is set slower than <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>, then your
2298  effective fastest interval is <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code>.</p></div>
2299   <div class="jd-tagdata">
2300       <h5 class="jd-tagtitle">Parameters</h5>
2301       <table class="jd-tagtable">
2302         <tr>
2303           <th>millis</td>
2304           <td>fastest interval for updates in milliseconds, exact</td>
2305         </tr>
2306       </table>
2307   </div>
2308   <div class="jd-tagdata">
2309       <h5 class="jd-tagtitle">Returns</h5>
2310       <ul class="nolist"><li>the same object, so that setters can be chained
2311 </li></ul>
2312   </div>
2313   <div class="jd-tagdata">
2314       <h5 class="jd-tagtitle">Throws</h5>
2315       <table class="jd-tagtable">
2316         <tr>
2317             <th>IllegalArgumentException</td>
2318             <td>if the interval is less than zero</td>
2319         </tr>
2320       </table>
2321   </div>
2322
2323     </div>
2324 </div>
2325
2326
2327 <A NAME="setInterval(long)"></A>
2328
2329 <div class="jd-details api apilevel-">
2330     <h4 class="jd-details-title">
2331       <span class="normal">
2332         public
2333
2334
2335
2336
2337         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2338       </span>
2339       <span class="sympad">setInterval</span>
2340       <span class="normal">(long millis)</span>
2341     </h4>
2342       <div class="api-level">
2343         <div></div>
2344
2345
2346
2347       </div>
2348     <div class="jd-details-descr">
2349
2350   <div class="jd-tagdata jd-tagdescr"><p>Set the desired interval for active location updates, in milliseconds.
2351
2352  <p>The location client will actively try to obtain location updates for your application
2353  at this interval, so it has a direct influence on the amount of power used by your
2354  application. Choose your interval wisely.
2355
2356  <p>This interval is inexact. You may not receive updates at all (if no location sources
2357  are available), or you may receive them slower than requested. You may also receive them
2358  faster than requested (if other applications are requesting location at a faster interval).
2359  The fastest rate that that you will receive updates can be controlled with
2360  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)">setFastestInterval(long)</a></code>.  By default this fastest rate is 6x the interval frequency.
2361
2362  <p>Applications with only the coarse location permission may have their interval silently
2363  throttled.
2364
2365  <p>An interval of 0 is allowed, but not recommended, since location updates may be extremely
2366  fast on future implementations.
2367
2368  <p><code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> and <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code> are the most important parameters
2369  on a location request.</p></div>
2370   <div class="jd-tagdata">
2371       <h5 class="jd-tagtitle">Parameters</h5>
2372       <table class="jd-tagtable">
2373         <tr>
2374           <th>millis</td>
2375           <td>desired interval in millisecond, inexact</td>
2376         </tr>
2377       </table>
2378   </div>
2379   <div class="jd-tagdata">
2380       <h5 class="jd-tagtitle">Returns</h5>
2381       <ul class="nolist"><li>the same object, so that setters can be chained
2382 </li></ul>
2383   </div>
2384   <div class="jd-tagdata">
2385       <h5 class="jd-tagtitle">Throws</h5>
2386       <table class="jd-tagtable">
2387         <tr>
2388             <th>IllegalArgumentException</td>
2389             <td>if the interval is less than zero</td>
2390         </tr>
2391       </table>
2392   </div>
2393
2394     </div>
2395 </div>
2396
2397
2398 <A NAME="setNumUpdates(int)"></A>
2399
2400 <div class="jd-details api apilevel-">
2401     <h4 class="jd-details-title">
2402       <span class="normal">
2403         public
2404
2405
2406
2407
2408         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2409       </span>
2410       <span class="sympad">setNumUpdates</span>
2411       <span class="normal">(int numUpdates)</span>
2412     </h4>
2413       <div class="api-level">
2414         <div></div>
2415
2416
2417
2418       </div>
2419     <div class="jd-details-descr">
2420
2421   <div class="jd-tagdata jd-tagdescr"><p>Set the number of location updates.
2422
2423  <p>By default locations are continuously updated until the request is explicitly removed,
2424  however you can optionally request a set number of updates. For example, if your
2425  application only needs a single fresh location, then call this method with a value of 1
2426  before passing the request to the location client.</p></div>
2427   <div class="jd-tagdata">
2428       <h5 class="jd-tagtitle">Parameters</h5>
2429       <table class="jd-tagtable">
2430         <tr>
2431           <th>numUpdates</td>
2432           <td>the number of location updates requested</td>
2433         </tr>
2434       </table>
2435   </div>
2436   <div class="jd-tagdata">
2437       <h5 class="jd-tagtitle">Returns</h5>
2438       <ul class="nolist"><li>the same object, so that setters can be chained
2439 </li></ul>
2440   </div>
2441   <div class="jd-tagdata">
2442       <h5 class="jd-tagtitle">Throws</h5>
2443       <table class="jd-tagtable">
2444         <tr>
2445             <th>IllegalArgumentException</td>
2446             <td>if numUpdates is 0 or less</td>
2447         </tr>
2448       </table>
2449   </div>
2450
2451     </div>
2452 </div>
2453
2454
2455 <A NAME="setPriority(int)"></A>
2456
2457 <div class="jd-details api apilevel-">
2458     <h4 class="jd-details-title">
2459       <span class="normal">
2460         public
2461
2462
2463
2464
2465         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2466       </span>
2467       <span class="sympad">setPriority</span>
2468       <span class="normal">(int priority)</span>
2469     </h4>
2470       <div class="api-level">
2471         <div></div>
2472
2473
2474
2475       </div>
2476     <div class="jd-details-descr">
2477
2478   <div class="jd-tagdata jd-tagdescr"><p>Set the priority of the request.
2479
2480  <p>Use with a priority constant such as <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_HIGH_ACCURACY">PRIORITY_HIGH_ACCURACY</a></code>. No other values
2481  are accepted.
2482
2483  <p>The priority of the request is a strong hint to the LocationClient for which location
2484  sources to use. For example, <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_HIGH_ACCURACY">PRIORITY_HIGH_ACCURACY</a></code> is more likely to use GPS, and
2485  <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#PRIORITY_BALANCED_POWER_ACCURACY">PRIORITY_BALANCED_POWER_ACCURACY</a></code> is more likely to use WIFI &amp; Cell tower
2486  positioning, but it also depends on many other factors (such as which sources are available)
2487  and is implementation dependent.
2488
2489  <p><code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setPriority(int)">setPriority(int)</a></code> and <code><a href="/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)">setInterval(long)</a></code> are the most important parameters
2490  on a location request.</p></div>
2491   <div class="jd-tagdata">
2492       <h5 class="jd-tagtitle">Parameters</h5>
2493       <table class="jd-tagtable">
2494         <tr>
2495           <th>priority</td>
2496           <td>an accuracy or power constant</td>
2497         </tr>
2498       </table>
2499   </div>
2500   <div class="jd-tagdata">
2501       <h5 class="jd-tagtitle">Returns</h5>
2502       <ul class="nolist"><li>the same object, so that setters can be chained
2503 </li></ul>
2504   </div>
2505   <div class="jd-tagdata">
2506       <h5 class="jd-tagtitle">Throws</h5>
2507       <table class="jd-tagtable">
2508         <tr>
2509             <th>IllegalArgumentException</td>
2510             <td>if the quality constant is not valid</td>
2511         </tr>
2512       </table>
2513   </div>
2514
2515     </div>
2516 </div>
2517
2518
2519 <A NAME="setSmallestDisplacement(float)"></A>
2520
2521 <div class="jd-details api apilevel-">
2522     <h4 class="jd-details-title">
2523       <span class="normal">
2524         public
2525
2526
2527
2528
2529         <a href="/reference/com/google/android/gms/location/LocationRequest.html">LocationRequest</a>
2530       </span>
2531       <span class="sympad">setSmallestDisplacement</span>
2532       <span class="normal">(float smallestDisplacementMeters)</span>
2533     </h4>
2534       <div class="api-level">
2535         <div></div>
2536
2537
2538
2539       </div>
2540     <div class="jd-details-descr">
2541
2542   <div class="jd-tagdata jd-tagdescr"><p>Set the minimum displacement between location updates in meters
2543
2544  <p>By default this is 0.</p></div>
2545   <div class="jd-tagdata">
2546       <h5 class="jd-tagtitle">Parameters</h5>
2547       <table class="jd-tagtable">
2548         <tr>
2549           <th>smallestDisplacementMeters</td>
2550           <td>the smallest displacement in meters the user must move
2551                                    between location updates.</td>
2552         </tr>
2553       </table>
2554   </div>
2555   <div class="jd-tagdata">
2556       <h5 class="jd-tagtitle">Returns</h5>
2557       <ul class="nolist"><li>the same object, so that setters can be chained
2558 </li></ul>
2559   </div>
2560   <div class="jd-tagdata">
2561       <h5 class="jd-tagtitle">Throws</h5>
2562       <table class="jd-tagtable">
2563         <tr>
2564             <th>IllegalArgumentException</td>
2565             <td>if smallestDisplacementMeters is negative</td>
2566         </tr>
2567       </table>
2568   </div>
2569
2570     </div>
2571 </div>
2572
2573
2574 <A NAME="toString()"></A>
2575
2576 <div class="jd-details api apilevel-">
2577     <h4 class="jd-details-title">
2578       <span class="normal">
2579         public
2580
2581
2582
2583
2584         String
2585       </span>
2586       <span class="sympad">toString</span>
2587       <span class="normal">()</span>
2588     </h4>
2589       <div class="api-level">
2590         <div></div>
2591
2592
2593
2594       </div>
2595     <div class="jd-details-descr">
2596
2597   <div class="jd-tagdata jd-tagdescr"><p></p></div>
2598
2599     </div>
2600 </div>
2601
2602
2603 <A NAME="writeToParcel(android.os.Parcel, int)"></A>
2604
2605 <div class="jd-details api apilevel-">
2606     <h4 class="jd-details-title">
2607       <span class="normal">
2608         public
2609
2610
2611
2612
2613         void
2614       </span>
2615       <span class="sympad">writeToParcel</span>
2616       <span class="normal">(Parcel parcel, int flags)</span>
2617     </h4>
2618       <div class="api-level">
2619         <div></div>
2620
2621
2622
2623       </div>
2624     <div class="jd-details-descr">
2625
2626   <div class="jd-tagdata jd-tagdescr"><p></p></div>
2627
2628     </div>
2629 </div>
2630
2631
2632
2633
2634
2635 <!-- ========= METHOD DETAIL ======== -->
2636
2637
2638
2639 <!-- ========= END OF CLASS DATA ========= -->
2640 <A NAME="navbar_top"></A>
2641
2642 <div id="footer" class="wrap" >
2643
2644
2645   <div id="copyright">
2646
2647   Except as noted, this content is licensed under <a
2648   href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a>.
2649   For details and restrictions, see the <a href="/license.html">
2650   Content License</a>.
2651   </div>
2652   <div id="build_info">
2653
2654 <script src="/timestamp.js" type="text/javascript"></script>
2655 <script>document.write(BUILD_TIMESTAMP)</script>
2656
2657   </div>
2658
2659
2660   <div id="footerlinks">
2661
2662   <p>
2663     <a href="/about/index.html">About Android</a>&nbsp;&nbsp;|&nbsp;
2664     <a href="/legal.html">Legal</a>&nbsp;&nbsp;|&nbsp;
2665     <a href="/support.html">Support</a>
2666   </p>
2667   </div>
2668
2669 </div> <!-- end footer -->
2670 </div> <!-- jd-content -->
2671
2672 </div><!-- end doc-content -->
2673
2674 </div> <!-- end body-content -->
2675
2676
2677
2678
2679
2680
2681 </body>
2682 </html>