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

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

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

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

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

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

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

يتم سرد نماذج الأنشطة الرئيسية المُضمنة في تطبيق ApiDemos لـ Android لـ "خرائط Google" أدناه وإعادة إنتاجها في الصفحات المرتبطة للرجوع إليها سريعًا. راجِع مجلد 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.