توضّح هذه الصفحة كيفية إعداد حزمة تطوير البرامج (SDK) للخرائط في "خرائط Google" للتطبيقات المتوافقة مع Android، وتشغيل التطبيق التجريبي المضمّن في المكتبة.
المتطلبات الأساسية والملاحظات
تتوافق مكتبة أدوات تطوير البرامج (SDK) لخدمة "خرائط Google" لنظام التشغيل Android مع الإصدار من واجهة برمجة التطبيقات لنظام التشغيل Android 15 والإصدارات الأحدث. عند إعداد هدف إنشاء المشروع، تأكَّد من استخدام أحدث مستوى من واجهة برمجة تطبيقات Android.
تتوفّر المستندات المرجعية على GitHub.
الخطوة الأولى: تثبيت "حزمة تطوير البرامج" (SDK) للخرائط لخدمة برامج خدمات Android
أضف التبعية التالية إلى ملف build.gradle
لتطبيقك:
dependencies { implementation 'com.google.maps.android:android-maps-utils:2.3.0' }
استخدِم إحدى الأدوات المساعدة من المكتبة، مثل تجميع العلامات أو خرائط الحالة أو المرافق الأخرى.
الخطوة 2: (اختياري) تثبيت حزمة تطوير البرامج (SDK) لخدمة "خرائط Google" لمكتبة KTX لخدمة Android
تتوفّر مكتبة "SDK للخرائط" لنظام التشغيل Android مع مكتبة إضافات Kotlin (KTX) المقابلة لها. توفّر هذه المكتبة ميزات لغة Kotlin، مثل دوال الإضافات والوسيطات المُسمّاة والتلقائية، وذلك لتتمكّن من كتابة لغة Kotlin مختصرة وأصلية. إذا لم تكن تطوّر لغة Kotlin، يمكنك تخطّي هذه الخطوة.
لاستخدام هذه المكتبة، أضِف الاعتمادية التالية، بالإضافة إلى التبعية android-maps-utils
، إلى ملف build.gradle
لتطبيقك:
dependencies { implementation 'com.google.maps.android:maps-utils-ktx:3.4.0' }
يمكنك الاطّلاع على صفحة Maps KTX GitHub للحصول على معلومات إضافية حول هذه المكتبة.
الخطوة 3: عرض رمز مصدر مكتبة أدوات تطوير البرامج (SDK) للخرائط لخدمة Android
نظرًا لأن مكتبة الأدوات مفتوحة المصدر، يمكنك تنزيل مكتبة android-maps-utils على جهازك لتخصيصها أو عرض التطبيق التجريبي أو إذا كنت تريد فقط فهم آلية عمل المكتبة. ويمكنك إجراء ذلك من خلال نسخ الاسترجاع (يُنصَح به لتلقّي تحديثات تلقائية) أو تنزيل ملف ZIP. إذا كنت تريد تخصيص المكتبة، عليك تنفيذ عملية التجزئة.
ويتضمّن المستودع ما يلي:
- تطبيق تجريبي في الدليل
demo
. - مكتبة الأدوات المساعدة في الدليل
library
- مكتبة الأدوات المساعدة
لإصدار "خرائط Google
SDK" للإصدار 3 من الإصدار التجريبي في الدليل
library-v3
. - ملفات متنوعة تحتوي على ترخيص ومساهمين ومعلومات عن القراءة.
- إعدادات إنشاء Gradle متاحة للاستخدام مع "استوديو Android".
تشغيل التطبيق التجريبي لبرنامج الخدمات
يتم توفير مستودع GitHub لمكتبة الخدمات من خلال تطبيق تجريبي يتضمّن نماذج عمليات تنفيذ لكل أداة. اتّبِع الخطوات التالية لتشغيل التطبيق التجريبي على جهاز Android.
- نزِّل المستودع باستخدام أحد الخيارات المذكورة أعلاه.
- في "استوديو Android"، اختَر File -> New -> Import Project.
- تصفَّح للوصول إلى الدليل android-maps-utils الذي تم إنشاؤه عند نسخ مكتبة الأدوات، واختَرها (النقر مرّتين). يتم إنشاء المشروع من خلال "استوديو Android".
- إذا كنت تستخدم جهاز Android بدلاً من المحاكي، احرص على تفعيل وضع مطوّر البرامج. بعد ذلك، عليك توصيل جهاز Android بجهاز الكمبيوتر.
أضف سطرًا واحدًا إلى
local.properties
يبدو على النحو التالي:MAPS_API_KEY=YOUR_API_KEY
حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه على النحو الموضح في استخدام مفاتيح واجهة برمجة التطبيقات.
- أنشئ تطبيق الإصدار التجريبي وشغِّله.
من المفترض أن يتم فتح التطبيق على جهاز Android، ويعرض قائمة بالأدوات المساعدة، بما في ذلك التجميع وpoyutil وخريطة التمثيل اللوني وغيرها. يمكنك العثور على التطبيق أيضًا في قائمة التطبيقات، تحت اسم الإصدار التجريبي من برامج خرائط.