إعداد حزمة تطوير البرامج (SDK) في "خرائط Google" لأجهزة Android المساعدة

اختيار النظام الأساسي: Android iOS

توضّح هذه الصفحة كيفية إعداد حزمة تطوير برامج (SDK) "خرائط Google" لنظام التشغيل Android وتشغيل التطبيق التجريبي المضمّن في المكتبة.

المتطلّبات الأساسية والملاحظات

تتوافق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android مع مستوى واجهة برمجة التطبيقات 15 أو الإصدارات الأحدث من Android. عند تحديد هدف إصدار مشروعك، احرِص على استخدام أحدث مستوى لواجهة برمجة تطبيقات Android.

تتوفر المستندات المرجعية على GitHub.

الخطوة 1. تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android

أضِف التبعية التالية إلى ملف build.gradle في تطبيقك:

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.0'
}

استخدِم إحدى الأدوات المساعدة من المكتبة، مثل تجميع العلامات أو خرائط التمثيل اللوني أو الأدوات الأخرى.

الخطوة 2. (اختياري) تثبيت مكتبة KTX لأداة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android

إنّ حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android تأتي مع مكتبة إضافات لغة البرمجة Kotlin (KTX) المقابلة. توفّر هذه المكتبة ميزات لغة Kotlin، مثل دوال الإضافات والوسيطات المسماة والوسيطات التلقائية، وذلك للسماح لك بكتابة لغة Kotlin مختصرة واصطلاحية. وإذا لم تكن مطوّر البرامج باستخدام لغة Kotlin، يمكنك تخطّي هذه الخطوة.

لاستخدام هذه المكتبة، أضِف الوحدة الاعتمادية التالية، بالإضافة إلى تبعية android-maps-utils، إلى ملف build.gradle الخاص بتطبيقك:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

يمكنك الاطّلاع على صفحة خرائط KTX GitHub للحصول على معلومات إضافية حول هذه المكتبة.

الخطوة 3. عرض رمز مصدر مكتبة الأدوات المساعدة لـ "خرائط Google" لنظام التشغيل Android

بما أنّ مكتبة الأدوات هي مفتوحة المصدر، يمكنك تنزيل مكتبة android-maps-utils على جهازك لتخصيصها أو عرض التطبيق التجريبي أو لمعرفة آلية عمل المكتبة فقط. يمكنك إجراء ذلك من خلال نسخ الريبو (ننصح به لتلقّي التعديلات التلقائية) أو تنزيل ملف ZIP. إذا أردت تخصيص المكتبة، عليك تسجيل الدخول إلى المخزن.

يتضمن المستودع ما يلي:

  • تطبيق تجريبي في الدليل demo
  • مكتبة الأدوات المساعدة، في دليل library
  • ملفات متنوعة تحتوي على معلومات الترخيص والمساهمين ومعلومات الملف التمهيدي.
  • إعدادات تصميم Gradle لاستخدامها مع "استوديو Android"

تشغيل تطبيق العرض التوضيحي للأداة

يحتوي مستودع GitHub لمكتبة الأدوات على تطبيق تجريبي يتضمن نماذج من عمليات التنفيذ لكل أداة مساعدة. اتّبِع هذه الخطوات لتشغيل التطبيق التجريبي على جهاز Android الخاص بك.

  1. نزِّل المستودع باستخدام أحد الخيارات المذكورة أعلاه.
  2. في "استوديو Android"، اختَر ملف -> جديد -> استيراد مشروع.
  3. تصفَّح للوصول إلى دليل android-maps-utils الذي تم إنشاؤه عند استنساخ مكتبة الأدوات واختيارها (انقر مرّتين). يتم الآن إنشاء المشروع من خلال "استوديو Android".
  4. إذا كنت تستخدم جهاز Android بدلاً من المحاكي، احرص على تفعيل وضع مطوّر البرامج. بعد ذلك، وصِّل جهاز Android بجهاز الكمبيوتر.

  5. أضف سطرًا واحدًا إلى local.properties يبدو كالتالي:

    MAPS_API_KEY=YOUR_API_KEY

    حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه كما هو موضّح في استخدام مفاتيح واجهة برمجة التطبيقات.

  6. إنشاء تطبيق العرض التوضيحي وتشغيله.

من المفترض أن يتم فتح التطبيق على جهاز Android مع عرض قائمة بالأدوات المساعدة، بما في ذلك التجميع العنقودي وpoyutil وخريطة التمثيل اللوني وغيرها. يمكنك أيضًا العثور على التطبيق في قائمة التطبيقات، ضمن الاسم العرض التوضيحي لتطبيق "خرائط Google".