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

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

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

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

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

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

نموذج قائمة تطبيقات "حزمة تطوير البرامج (SDK) لـ "خرائط Google" لتطبيقات Android

نماذج أساسية من الأنشطة المضمّنة في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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

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