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