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

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

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

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

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

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

نموذج قائمة تطبيقات "حزمة تطوير البرامج (SDK) لـ "خرائط 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 Studio مشروعك باستخدام أداة إنشاء 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.