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

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

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

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

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

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

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

   MAPS_API_KEY=YOUR_API_KEY

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

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

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