از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
مکان های فرصت طلب را محدود کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
هنگامی که یک برنامه مکان یک دستگاه را درخواست می کند، می تواند منتظر پاسخ درخواست باشد یا با استفاده از شنوندگان موقعیت مکانی فعال، به روز رسانی موقعیت مکانی فرصت طلبانه را دریافت کند. این در اندروید 9 و پایین‌تر (بدون محدودیت) در دسترس بود و زمانی ارائه شد که یک برنامه فقط نرخ به‌روزرسانی مکان فعال را مشخص می‌کرد و نرخ غیرفعال را خالی می‌گذاشت. (شنوندگان مکان غیرفعال به‌روزرسانی موقعیت مکانی را دریافت نمی‌کنند زیرا نرخ به‌روزرسانی مکان را مشخص نمی‌کنند.)
با شروع اندروید 10، برای دریافت به‌روزرسانی‌های موقعیت مکانی، توسعه‌دهندگان باید مشخص کنند که به به‌روزرسانی‌های موقعیت مکانی غیرفعال از کلاس FusedLocationProviderClient نیاز دارند.
ارائه دهنده مکان ترکیبی
برنامه‌ها می‌توانند سرعت دریافت به‌روزرسانی‌های فرصت‌طلبانه موقعیت مکانی را از کلاس FusedLocationProviderClient به دو طریق مشخص کنند.
تأثیر
اگر مقداری برای setFastestInterval ارائه نکنید، ممکن است برنامه شما کاهش قابل توجهی در به‌روزرسانی‌های مکان ارائه شده به آن داشته باشد.
پیاده سازی
برای پیاده سازی این ویژگی به غیر از استفاده از مقادیر پیشنهادی برای متد setFastestInterval کلاس FusedLocationProviderClient نیازی به انجام هیچ کاری ندارید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Restrict opportunistic locations\n\nWhen an app requests a device's location, it can either wait for\nthe request response or, by using active location listeners, get an\nopportunistic location update. This was available (unrestricted) in\nAndroid 9 and lower, and was provided when an app specified only\nthe active location update rate, leaving the passive rate blank.\n(Passive location listeners don't receive opportunistic location\nupdates because they don't specify a location update rate.)\n\nStarting in Android 10, to get opportunistic\nlocation updates, developers must specify that they need passive location\nupdates from the **[FusedLocationProviderClient](https://developers.google.com/android/reference/com/google/android/gms/location\n/FusedLocationProviderClient)** class.\n\nFused location provider\n-----------------------\n\nApps can specify the rate at which they get opportunistic location updates from the [FusedLocationProviderClient](https://developers.google.com/android/reference/com/google/android/gms/location/FusedLocationProviderClient)\nclass in two ways.\n\n- Specify a value in the [setFastestInterval](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)) method that's lower than the value of the [setInterval](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html#setInterval(long)) parameter. (Use a value of 0 ms or greater.)\n- Let the value be set automatically by leaving [setFastestInterval](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)) unspecified.\n\nImpact\n------\n\nIf you don't provide a value for [setFastestInterval](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long)),\nyour app may experience a significant\nreduction in location updates delivered to it.\n\nImplementation\n--------------\n\nYou don't need to do anything to implement this feature other\nthan to use the suggested values for the [FusedLocationProviderClient](https://developers.google.com/android/reference/com/google/android/gms/location\n/FusedLocationProviderClient) class [setFastestInterval](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html#setFastestInterval(long))\nmethod."]]
