تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
للوصول إلى
واجهات برمجة التطبيقات التي توفّرها "خدمات Google Play"
في تطبيق Android، عليك استخدام عناصر عميل واجهة برمجة التطبيقات. تتعامل هذه العناصر مع عملية الربط بخدمات Google Play، وتضع الطلبات في قائمة الانتظار وتنفّذها بالترتيب عند توفّر اتصال. يمكنك إنشاء عملاء جدد لواجهة برمجة التطبيقات حسب الحاجة، لأنّ إنشاءهم غير مكلف.
للوصول إلى خدمة لا تتطلّب تفويضًا، أنشئ مثيلاً لكائن العميل الخاص بالخدمة، مع تمرير إما Context أو كائن Activity. إذا لزم الأمر، يُطلب من المستخدمين ترقية "خدمات Google Play" قبل تنفيذ أي طلبات من واجهة برمجة التطبيقات.
يوضّح مقتطف الرمز التالي كيفية الحصول على آخر موقع جغرافي معروف للجهاز
باستخدام Fused Location Provider:
Kotlin
// Code required for requesting location permissions omitted for brevity.valclient=LocationServices.getFusedLocationProviderClient(this)// Get the last known location. In some rare situations, this can be null.client.lastLocation.addOnSuccessListener{location:Location? ->
location?.let{// Logic to handle location object.}}
Java
// Code required for requesting location permissions omitted for brevity.FusedLocationProviderClientclient=LocationServices.getFusedLocationProviderClient(this);// Get the last known location. In some rare situations, this can be null.client.getLastLocation().addOnSuccessListener(this,location->{if(location!=null){// Logic to handle location object.}});
قبل تفعيل ميزة تعتمد على إحدى واجهات برمجة التطبيقات في "خدمات Google Play"، تحقَّق مما إذا كانت واجهة برمجة التطبيقات متوفّرة على الجهاز من خلال استدعاء checkApiAvailability().
يوضِّح مقتطف الرمز البرمجي التالي كيفية التحقّق من توفّر "موفِّر الموقع المدمج":
تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eTo use Google Play services APIs, create API client objects which manage the connection and queue requests when offline.\u003c/p\u003e\n"],["\u003cp\u003eAccess services without authorization by obtaining the client object using the current \u003ccode\u003eContext\u003c/code\u003e or \u003ccode\u003eActivity\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAccess services requiring authorization by signing in the user, requesting necessary permissions, and then getting the client object.\u003c/p\u003e\n"],["\u003cp\u003eCheck for API availability using \u003ccode\u003echeckApiAvailability()\u003c/code\u003e if you need to disable features when an API is unavailable, although API calls will fail gracefully if the API isn't present.\u003c/p\u003e\n"]]],["To use Google Play services APIs, create an API client object, which manages the connection and queues requests. For services not requiring authorization, obtain the client instance using `Context` or `Activity`; for example, the Fused Location Provider client. For services requiring authorization, sign the user in, request necessary permissions, and then get the client using `GoogleSignInAccount`. For example, the Fit API client to get the daily steps. Before making API calls check with `checkApiAvailability()`.\n"],null,[]]