يتضمّن مستودع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android على GitHub
عيّنات توضّح كيفية استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
في تطبيق Android.
يحتوي المستودع على تطبيق ApiDemos، وهو تطبيق نموذجي يتيح لك إنشاء وتشغيل النماذج من تطبيق Android واحد. استورِد التطبيق وأنشئه، وأضِف مفتاح واجهة برمجة التطبيقات، واطّلِع على العرض التوضيحي، واستخدِم نموذج الرمز البرمجي المقدَّم كنقطة بداية لتطبيقك.
عند تشغيل تطبيق العيّنة، سيتم عرض قائمة بالعيّنات المتاحة التي يمكنك تشغيلها على جهازك. حدِّد أحد الخيارات. على سبيل المثال، انقر على الخريطة الأساسية.
تحديد المشاكل وحلّها: إذا تم تشغيل التطبيق النموذجي بنجاح ولكن لم تظهر لك خريطة، تأكَّد من أنّك أضفت مفتاح واجهة برمجة التطبيقات إلى ملف بيان التطبيق، كما هو موضّح في استخدام مفاتيح واجهة برمجة التطبيقات.
قائمة التطبيقات النموذجية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
في ما يلي قائمة بالأنشطة الرئيسية النموذجية الواردة في تطبيق ApiDemos الخاص بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android، وقد تم إعادة إنتاجها في الصفحات المرتبطة لتسهيل الرجوع إليها. اطّلِع على مجلد Kotlin أو Java
للحصول على القائمة الكاملة للعينات المتاحة.
استورِد نموذج المشروع إلى "استوديو Android" باتّباع الخطوات التالية:
في "استوديو Android"، انقر على ملف > جديد > استيراد مشروع.
انتقِل إلى الموقع الجغرافي الذي حفظت فيه المستودع واختَر دليل المشروع الخاص بلغة Kotlin أو Java:
Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
Java: PATH-REPO/android-samples/ApiDemos/java
انقر على فتح. ينشئ "استوديو Android" مشروعك باستخدام أداة الإنشاء Gradle.
أنشِئ ملف secrets.properties فارغًا في الدليل نفسه الذي يحتوي على ملف local.properties الخاص بمشروعك. لمزيد من المعلومات حول هذا الملف، يُرجى الاطّلاع على إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع.
أضِف السلسلة التالية إلى secrets.properties، مع استبدال YOUR_API_KEY بقيمة مفتاح واجهة برمجة التطبيقات:
MAPS_API_KEY=YOUR_API_KEY
شغِّل التطبيق.
تطبيق نموذجي للخرائط على Wear OS
يتوفّر نموذج تطبيق لحزمة تطوير البرامج "خرائط Google" لنظام التشغيل Android على Wear OS على GitHub، ويمكنك استخدامه كنقطة بداية عند إنشاء تطبيق متوافق مع الأجهزة القابلة للارتداء. يوضّح لك النموذج كيفية إعداد خريطة Google أساسية على Wear OS.
تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-12 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page provides access to the Maps SDK for Android sample code and apps, including a comprehensive ApiDemos app containing various map feature examples.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can clone the sample repository from GitHub, import it into Android Studio, add their API key, and run the app to explore different map functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThe ApiDemos app showcases key features such as basic maps, markers, events, polylines, polygons, and My Location, with code samples readily available for use.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting guidance is provided if the map doesn't display, directing users to verify their API key configuration.\u003c/p\u003e\n"],["\u003cp\u003eA separate sample app specifically for Wear OS is available on GitHub, demonstrating how to integrate Google Maps into wearable applications.\u003c/p\u003e\n"]]],["The Maps SDK for Android samples are available on GitHub. To use them, clone the repository, import the ApiDemos project into Android Studio (either Kotlin or Java), and add your API key to the `secrets.properties` file. Run the app to view a list of samples like Basic Map, Markers, and Polylines. A separate Wear OS sample is also available on GitHub, showing basic map setup for wearable apps. Ensure your API key is correctly added to the app manifest if you encounter map display issues.\n"],null,[]]
