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