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

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

يتضمّن مستودع "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" على GitHub نماذج توضّح كيفية استخدام هذه الحزمة في تطبيق Android.

يحتوي المستودع على تطبيق ApiDemos، وهو نموذج تطبيق يتيح لك إنشاء النماذج وتشغيلها من تطبيق Android واحد. يمكنك استيراد التطبيق وإنشاؤه وإضافة مفتاح واجهة برمجة التطبيقات وعرض العرض التوضيحي واستخدام الرمز النموذجي المقدَّم كنقطة بداية لتطبيقك.

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

تحديد المشاكل وحلّها: إذا تم تشغيل نموذج التطبيق بنجاح ولكن لم تظهر لك خريطة، تأكَّد من إضافة مفتاح واجهة برمجة التطبيقات إلى ملف بيان التطبيق، كما هو موضّح في مقالة استخدام مفاتيح واجهة برمجة التطبيقات.

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

في ما يلي الأنشطة النموذجية الرئيسية المضمّنة في تطبيق ApiDemos ضمن حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android، وقد تم نسخها في الصفحات المرتبطة للرجوع إليها بسرعة. يمكنك الاطّلاع على مجلد Kotlin أو Java للحصول على القائمة الكاملة للنماذج المتاحة.

استنساخ النماذج وتشغيلها

يجب استخدام Git لتشغيل هذا النموذج محليًا. ينسخ الأمر التالي مستودع التطبيق النموذجي.

git clone git@github.com:googlemaps-samples/android-samples.git

استورِد نموذج المشروع إلى "استوديو Android":

  1. في "استوديو Android"، انقر على ملف > جديد > استيراد مشروع.

  2. انتقِل إلى الموقع الذي حفظت فيه المستودع واختَر دليل المشروع للغة Kotlin أو Java:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • ‫Java: PATH-REPO/android-samples/ApiDemos/java
  3. اختيار فتح ينشئ "استوديو Android" مشروعك باستخدام أداة الإصدار Gradle.
  4. أنشئ ملف secrets.properties فارغًا في الدليل نفسه الذي يحتوي على ملف local.properties الخاص بمشروعك. لمزيد من المعلومات حول هذا الملف، يُرجى الاطّلاع على إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع.
  5. احصل على مفتاح واجهة برمجة تطبيقات من مشروعك مع تفعيل حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android.

  6. أضِف السلسلة التالية إلى secrets.properties، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات:

    MAPS_API_KEY=YOUR_API_KEY
  7. شغِّل التطبيق.

نموذج تطبيق للخرائط على Wear OS

يتوفّر نموذج تطبيق لحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android على Wear OS على GitHub، ويمكنك استخدامه كنقطة بداية عند إنشاء تطبيق مخصّص لجهاز قابل للارتداء. يوضّح لك النموذج كيفية إعداد خريطة Google أساسية على Wear OS.