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

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

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

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

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

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

في ما يلي نماذج الأنشطة الرئيسية الواردة في حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android ApiDemos، كما يمكنك الاطّلاع عليها في الصفحات المرتبطة للرجوع إليها سريعًا. اطّلِع على مجلد 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. أضِف السلسلة التالية إلى secrets.properties، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات:

   MAPS_API_KEY=YOUR_API_KEY

6. شغِّل التطبيق.

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

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