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

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

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

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

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

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

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

• الخريطة الأساسية
• العلامات
• العلامات المتقدّمة
• موقعي الجغرافي
• الأحداث
• الخطوط المتعددة
• المضلّعات

استنساخ العيّنات وتشغيلها

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

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

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

1. في "استوديو Android"، انقر على ملف (File) > جديد (New) > استيراد مشروع (Import Project).

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.