تنصح Google باستخدام واجهات برمجة التطبيقات الخاصة بالموقع الجغرافي والسياق في "خدمات Google Play" في التطبيقات التي تتطلّب خدمات الموقع الجغرافي. إذا كان تطبيقك يستخدم واجهات برمجة التطبيقات الخاصة بالموقع الجغرافي في إطار العمل، من المهم الانتقال إلى "خدمات Google Play" للاستفادة من أحدث الميزات المستندة إلى Google.
يُفضّل استخدام "خدمات Google Play" للحصول على خدمات الموقع الجغرافي في تطبيقك للأسباب التالية:
- توفّر "خدمات Google Play" واجهة بسيطة ومساحة أنظف لواجهة برمجة التطبيقات.
- يمكنك تحديد جودة الخدمة المطلوبة، وتتولّى واجهات برمجة التطبيقات إدارة التقنيات الأساسية نيابةً عنك.
- تم تحسين واجهات برمجة التطبيقات في "خدمات Google Play" من أجل الأداء واستهلاك البطارية.
- يتم الحفاظ على تحديث واجهات برمجة التطبيقات في "خدمات Google Play" باستمرار. تعمل Google باستمرار على تحسين الخوارزميات وإضافة المزيد من الميزات.
تحديث تطبيقك
توضّح الخطوات التالية عملية تعديل تطبيق لاستخدام واجهات برمجة التطبيقات الخاصة بالموقع الجغرافي والسياق:
- إعداد "خدمات Google Play" في مشروعك
- استخدِم واجهة برمجة التطبيقات لإعدادات الموقع الجغرافي من أجل التحقّق من صحة إعدادات الموقع الجغرافي الحالية.
- استخدام "خدمات Google Play" للميزات المعقّدة، مثل تحديد الموقع الجغرافي، والتعرّف على الأنشطة، والتنبيهات
- استبدِل استخدام واجهة برمجة التطبيقات الخاصة بالموقع الجغرافي في إطار العمل بواجهة برمجة التطبيقات الخاصة بمزوّد الموقع الجغرافي المدمج.
- إزالة المراجع إلى واجهة برمجة التطبيقات الخاصة بالموقع الجغرافي للإطار
إعداد "خدمات Google Play" في مشروعك
لإتاحة واجهات برمجة التطبيقات الخاصة بالموقع الجغرافي والسياق لمشروعك، يجب إضافة مرجع إلى مستودع Google Maven وتحديد تبعية لواجهات برمجة التطبيقات المطلوبة. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد خدمات Google Play.
استخدام Location Settings API
باستخدام واجهة برمجة التطبيقات لإعدادات الموقع الجغرافي، توفّر التطبيقات مستوى جودة الخدمة المطلوب، وتطلب واجهة برمجة التطبيقات من المستخدم إجراء التغييرات المناسبة على إعدادات النظام. اتّبِع الخطوات التالية لاستخدام واجهة برمجة التطبيقات الخاصة بإعدادات الموقع الجغرافي في تطبيقك:
- طلب أذونات تحديد الموقع الجغرافي في ملف بيان التطبيق
- اضبط عنصر
LocationRequestالذي يحدّد مستوى جودة الخدمة المطلوب. - استخدِم واجهة برمجة التطبيقات الخاصة بإعدادات الموقع الجغرافي للتحقّق من الإعدادات الحالية.
لمزيد من المعلومات، يمكنك الاطّلاع على تغيير إعدادات الموقع الجغرافي أو أمثلة على الموقع الجغرافي في Google Play للاطّلاع على نموذج الرمز.
استخدام "خدمات Google Play" للميزات المعقّدة
تساعدك مكتبات "خدمات Google Play" في تنفيذ تجارب مستخدم جديدة تتعلّق بالسياق والوعي بالمحيط الخاص بالمستخدم. تستفيد مكتبات الموقع الجغرافي والسياق المختلفة من أجهزة استشعار إضافية تتجاوز الموقع الجغرافي، وتفعل ذلك بطريقة فعّالة من حيث استهلاك الطاقة، ما يوفّر لتطبيقك بيانات أكثر دقة مع تقليل التأثير في عمر البطارية.
يمكنك دمج هذه المكتبات في تطبيقك بدلاً من كتابة حلول مخصّصة بنفسك:
استبدال واجهة برمجة التطبيقات الخاصة بموقع إطار العمل بواجهة برمجة التطبيقات الخاصة بمزوّد الموقع المدمج
يمكنك استخدام واجهة برمجة التطبيقات الخاصة بمزوّد الموقع الجغرافي المدمج للحصول على بيانات الموقع الجغرافي، مثل خطوط الطول والعرض. تستخدِم واجهة برمجة التطبيقات الخاصة بموفِّر الموقع الجغرافي المدمج العنصر Location، تمامًا مثل واجهة برمجة التطبيقات لإطار عمل الموقع الجغرافي، وذلك لتمثيل الموقع الجغرافي. توفّر واجهة برمجة التطبيقات ميزات
للاستماع إلى آخر التعديلات على الموقع الجغرافي، بالإضافة إلى الحصول على آخر موقع جغرافي معروف. تجعل كل هذه الميزات واجهة برمجة التطبيقات الخاصة بمزوّد الموقع الجغرافي المدمج خيارًا جيدًا لاستبدال المكوّنات التي تستخدم واجهة برمجة التطبيقات الخاصة بالموقع الجغرافي في إطار العمل مع إجراء أقل تغييرات ممكنة على بقية التطبيق.
يُعدّ الحصول على آخر موقع جغرافي معروف نقطة بداية جيدة للعديد من التجارب لأنّها عملية سريعة تستخدم بيانات الموقع الجغرافي التي يطلبها أي عميل على الجهاز. لتتبُّع الموقع الجغرافي بشكل دوري، يمكن لتطبيقك الاشتراك في تلقّي تحديثات الموقع الجغرافي، ما يوفّر بيانات حديثة ويتيح تجارب أكثر تعقيدًا.
إزالة مراجع واجهة برمجة التطبيقات الخاصة بموقع الإطار
استبدِل مراجع الفئات في الحزمة com.google.android.location بفئات من الحزمة com.google.android.gms.location، باستثناء مراجع الفئة Location التي تستخدمها واجهة برمجة التطبيقات الخاصة بموفّر الموقع الجغرافي المدمج. يمكنك عادةً إزالة المكوّنات التي تدير موفّري الخدمات المختلفين، مثل نظام تحديد المواقع العالمي (GPS) وشبكة Wi-Fi، من تطبيقك. وتدير واجهات برمجة التطبيقات الخاصة بالموقع الجغرافي والسياق موفّري الخدمات هؤلاء تلقائيًا.
اختبار تطبيقك
لتشغيل تطبيق يستخدم أحدث إصدار من "خدمات Google Play"، يجب أن يكون لديك جهاز مثبَّت عليه تطبيق "متجر Play" وأن تكون مسجّلاً الدخول إلى حساب Google. لأغراض التطوير، يمكنك استخدام الخيارات التالية:
- جهاز فعلي متصل ببيئة التطوير باستخدام كابل USB
- محاكي مثبَّت عليه تطبيق "متجر Play"
لمزيد من المعلومات حول ربط جهاز فعلي ببيئة التطوير، يُرجى الاطّلاع على تشغيل التطبيقات على جهاز فعلي. لإنشاء محاكي يتضمّن تطبيق "متجر Play"، راجِع إنشاء الأجهزة الافتراضية وإدارتها.