تصف هذه الصفحة كيفية إعداد حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android ومكتبة الأدوات ولتشغيل التطبيق التجريبي المضمن في المكتبة.
المتطلّبات الأساسية والملاحظات
تدعم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة أدوات Android خدمات Android. واجهة برمجة التطبيقات المستوى 15 والأعلى. عند تحديد هدف إصدار مشروعك، احرص على استخدام أحدث إصدار مستوى واجهة برمجة تطبيقات Android.
تشير رسالة الأشكال البيانية المرجع على GitHub.
الخطوة 1: تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة خدمات Android
أضِف الاعتمادية التالية إلى ملف build.gradle.kts في تطبيقك:
dependencies {
// Utility Library for Maps SDK for Android
// You do not need to add a separate dependency for the Maps SDK for Android
// since this library builds in the compatible version of the Maps SDK.
implementation("com.google.maps.android:android-maps-utils:3.8.2")
}
استخدام إحدى الأدوات المساعدة من المكتبة، مثل علامة والتجميع العنقودي، خرائط التمثيل اللوني الآخر والمرافق.
الخطوة 2: (اختياري) تثبيت مكتبة KTX للخرائط من أجل أداة Android المساعدة
تأتي حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة برامج Android المساعدة مع إضافات Kotlin المقابلة. (KTX). وتوفر هذه المكتبة ميزات لغة Kotlin، مثل دوال الإضافات، والوسيطات الافتراضية - لتمكينك من كتابة لغة Kotlin مختصرة ومثالية. إذا لم تكن كذلك في Kotlin، يمكنك تخطي هذه الخطوة.
لاستخدام هذه المكتبة، أضف التبعية التالية، بالإضافة إلى
android-maps-utils إلى ملف build.gradle.kts في تطبيقك:
dependencies {
// KTX for the Maps SDK for Android Utility Library
implementation("com.google.maps.android:maps-utils-ktx:5.1.1")
}
يمكنك الاطّلاع على صفحة خرائط KTX GitHub للحصول على معلومات إضافية حول هذه المكتبة.
الخطوة 3: عرض رمز مصدر مكتبة "حزمة تطوير البرامج (SDK) للخرائط" لتطبيقات Android
بما أنّ مكتبة الخدمات مفتوحة المصدر، يمكنك تنزيل android-maps-utils إلى جهازك لتخصيصها أو عرض التطبيق التجريبي، أو إذا كنت تريد فقط فهم أعمال المكتبة. يمكنك إجراء ذلك من خلال استنساخ المستودع (يُنصح به، بتلقّي تحديثات تلقائية) أو تنزيل ملف ZIP. إذا كنت تريد تخصيص المكتبة، يجب عليك إرسال بيانات المستودع
يتضمّن المستودع ما يلي:
- تطبيق تجريبي، في دليل
demo. - تعرض هذه الصفحة مكتبة البرامج المساعدة في دليل
library. - ملفات متنوعة تحتوي على معلومات حول التراخيص والمساهمين ومعلومات الملف التمهيدي.
- إعداد إصدار Gradle للاستخدام مع "استوديو Android"
تشغيل التطبيق التجريبي للأداة المساعدة
يشحن مستودع GitHub لمكتبة المرافق بتطبيق تجريبي يتضمن عينة لكل أداة مساعدة. اتّبِع الخطوات التالية لتشغيل التطبيق التجريبي على على جهاز Android.
- قم بتنزيل المستودع باستخدام أحد الخيارات المذكورة أعلاه.
- في "استوديو Android"، انقر على ملف -> جديد -> استيراد المشروع:
- تصفَّح للوصول إلى الدليل واختَره (بالنقر المزدوج) android-maps-utils الذي تم إنشاؤه عندما قد نسخت مكتبة المرافق. يعمل Android Studio الآن على إنشاء المشروع.
- إذا كنت تستخدم جهاز Android بدلاً من محاكي، تأكد من تفعيل وضع مطور البرامج. بعد ذلك، وصِّل جهاز Android بجهاز الكمبيوتر.
إضافة سطر واحد إلى
local.propertiesيبدو كالتالي:MAPS_API_KEY=YOUR_API_KEY
حيث YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه كما هو موضّح في استخدام مفاتيح واجهة برمجة التطبيقات:
- أنشِئ تطبيق العرض التوضيحي وشغِّله.
من المفترض أن يتم فتح التطبيق على جهاز Android، ويعرض قائمة ببرامج الخدمات بما في ذلك التجميع العنقودي وpoyutil وخريطة التمثيل اللوني وغيرها. يمكنك أيضًا العثور على التطبيق في قائمة التطبيقات، تحت اسم العرض التوضيحي لاستخدام الخرائط.