Google توصیه می‌کند در برنامه‌هایی که به خدمات مکان نیاز دارند، از میاناهای برنامه‌سازی کاربردی مکان و زمینه در خدمات Google Play استفاده کنید. اگر برنامه‌تان از میاناهای برنامه‌سازی کاربردی مکان چارچوب استفاده می‌کند، مهم است که به خدمات Google Play منتقل شوید تا از جدیدترین ویژگی‌های ارائه شده توسط Google بهره‌مند شوید.
استفاده از خدمات Google Play گزینه ترجیحی برای دریافت خدمات مکان در برنامه شما به دلایل زیر است:
- خدمات Google Play میانای ساده و سطح API تمیزتری ارائه می‌دهد.
- شما کیفیت سرویس موردنظرتان را مشخص می‌کنید و میاناهای برنامه‌سازی کاربردی فناوری‌های زیربنایی را برای شما مدیریت می‌کنند.
- میاناهای برنامه‌سازی کاربردی خدمات Google Play برای عملکرد و مصرف باتری بهینه‌سازی شده‌اند.
- میاناهای برنامه‌سازی کاربردی خدمات Google Play به‌طور فعال نگهداری می‌شوند. Google دائماً درحال بهبود الگوریتم‌ها و افزودن ویژگی‌های بیشتر است.
به‌روزرسانی برنامه
مراحل زیر فرایند به‌روزرسانی برنامه برای استفاده از میاناهای برنامه‌سازی کاربردی مکان و بافت را شرح می‌دهد:
- «خدمات Google Play» را در پروژه‌تان راه‌اندازی کنید.
- از API تنظیمات مکان برای اعتبارسنجی تنظیمات مکان فعلی استفاده کنید.
- از «خدمات Google Play» برای ویژگی‌های پیچیده مانند حصار جغرافیایی، تشخیص فعالیت، و آگاهی استفاده کنید.
- استفاده از میانای برنامه‌سازی کاربردی مکان چارچوب را با میانای برنامه‌سازی کاربردی ارائه‌دهنده تلفیقی مکان جایگزین کنید.
- ارجاع‌ها به میانای برنامه‌سازی کاربردی مکان چارچوب را بردارید.
راه‌اندازی خدمات Google Play در پروژه
برای دردسترس قرار دادن میاناهای برنامه‌سازی کاربردی مکان و بافت برای پروژه‌تان، باید مرجعی به مخزن Google maven اضافه کنید و وابستگی به میاناهای برنامه‌سازی کاربردی موردنیاز را اعلام کنید. برای اطلاعات بیشتر، راه‌اندازی خدمات Google Play را ببینید.
استفاده از API تنظیمات مکان
بااستفاده از API تنظیمات مکان، برنامه‌ها سطح QoS موردنیازشان را ارائه می‌دهند و API از کاربر می‌خواهد تغییرات مناسب را در تنظیمات سیستم اعمال کند. برای استفاده از Location Settings API در برنامه‌تان، مراحل زیر را دنبال کنید:
- درخواست اجازه‌های مکان در مانیفست برنامه.
- شیء
LocationRequestرا راه‌اندازی کنید که سطح QoS موردنظرتان را مشخص می‌کند. - از API تنظیمات مکان برای بررسی تنظیمات فعلی استفاده کنید.
برای اطلاعات بیشتر، به تغییر تنظیمات مکان مراجعه کنید یا برای کد نمونه، نمونه‌های مکان Google Play را ببینید.
استفاده از «خدمات Google Play» برای ویژگی‌های پیچیده
کتابخانه‌های «خدمات Google Play» به شما کمک می‌کنند تا تجربه‌های کاربری جدیدی را در زمینه بافت و آگاهی از محیط اطراف کاربر پیاده‌سازی کنید. کتابخانه‌های مختلف مکان و زمینه از حسگرهای اضافی فراتر از مکان استفاده می‌کنند و این کار را به‌صورت کم‌مصرف انجام می‌دهند و داده‌های دقیق‌تری را برای برنامه شما ارائه می‌دهند و درعین‌حال تأثیر بر عمر باتری را کاهش می‌دهند.
به‌جای نوشتن راه‌حل‌های سفارشی خودتان، این کتابخانه‌ها را در برنامه‌تان بگنجانید:
جایگزین کردن میانای برنامه‌سازی کاربردی مکان چارچوب با میانای برنامه‌سازی کاربردی ارائه‌دهنده تلفیقی مکان
می‌توانید از میانای برنامه‌سازی کاربردی ارائه‌دهنده تلفیقی مکان برای دریافت داده‌های مکان، مثل عرض و طول جغرافیایی، استفاده کنید. fused location provider API از شیء Location
(درست مثل location framework API) برای نمایش مکان جغرافیایی
استفاده می‌کند. این API ویژگی‌هایی برای گوش دادن به به‌روزرسانی‌های مکان و همچنین دریافت آخرین مکان شناخته‌شده ارائه می‌دهد. همه این ویژگی‌ها باعث می‌شود میانای برنامه‌سازی کاربردی ارائه‌دهنده تلفیقی مکان
گزینه خوبی برای جایگزینی مؤلفه‌هایی باشد که از میانای برنامه‌سازی کاربردی مکان چارچوب
استفاده می‌کنند، با حداقل تغییرات در بقیه برنامه.
دریافت آخرین مکان معلوم نقطه شروع خوبی برای بسیاری از تجربه‌ها است زیرا عملیاتی سریع است که از داده‌های مکان درخواست‌شده توسط هر کارخواهی در دستگاه استفاده می‌کند. برای ردیابی دوره‌ای مکان، برنامه‌تان می‌تواند برای دریافت به‌روزرسانی‌های مکان مشترک شود که داده‌های به‌روز ارائه می‌دهد و تجربه‌های پیچیده‌تری را ممکن می‌کند.
برداشتن ارجاع‌ها به میانای برنامه‌سازی کاربردی مکان چارچوب
ارجاع‌ها به کلاس‌ها در بسته com.google.android.location را با کلاس‌های بسته com.google.android.gms.location جایگزین کنید، به‌جز ارجاع‌ها به کلاس Location که API ارائه‌دهنده تلفیقی مکان از آن استفاده می‌کند. معمولاً می‌توانید مؤلفه‌هایی را که ارائه‌دهندگان مختلف (مثل GPS و Wi-Fi) را مدیریت می‌کنند از برنامه‌تان بردارید. Location and Context API به‌طور خودکار این ارائه‌دهندگان را مدیریت می‌کنند.
آزمایش کردن برنامه
برای اجرای برنامه‌ای که از جدیدترین نسخه خدمات Google Play استفاده می‌کند، به دستگاهی نیاز دارید که برنامه «فروشگاه Play» در آن نصب شده باشد و باید به سیستم «حساب Google» وارد شده باشید. برای اهداف توسعه می‌توانید از گزینه‌های زیر استفاده کنید:
- دستگاهی فیزیکی که بااستفاده از کابل USB به محیط توسعه نرم‌افزار شما متصل شده است.
- شبیه‌سازی که برنامه «فروشگاه Play» در آن نصب شده باشد.
برای اطلاعات بیشتر درباره متصل کردن دستگاه فیزیکی به محیط توسعه نرم‌افزار، اجرای برنامه‌ها در دستگاه سخت‌افزاری را ببینید. برای ایجاد شبیه‌سازی که شامل برنامه «فروشگاه Play» باشد، ایجاد و مدیریت دستگاه‌های مجازی را ببینید.