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

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

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

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

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

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

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

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. افتح ملف local.properties لمشروعك.

  5. أضِف السلسلة التالية، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات الخاص بك:

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

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

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