إعداد حزمة تطوير البرامج (SDK) في "خرائط Google" لأجهزة Android المساعدة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
نظام التشغيل
Android
iOS
تصف هذه الصفحة كيفية إعداد
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
ومكتبة الأدوات ولتشغيل التطبيق التجريبي المضمن في المكتبة.
المتطلّبات الأساسية والملاحظات
تدعم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة أدوات Android خدمات Android.
واجهة برمجة التطبيقات
المستوى 15 والأعلى. عند تحديد هدف إصدار مشروعك، احرص على استخدام أحدث إصدار
مستوى واجهة برمجة تطبيقات Android.
تشير رسالة الأشكال البيانية
المرجع
على GitHub.
الخطوة 1: تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة خدمات Android
أضِف الاعتمادية التالية إلى ملف build.gradle.kts في تطبيقك:
dependencies {
// Utility Library for Maps SDK for Android
// You do not need to add a separate dependency for the Maps SDK for Android
// since this library builds in the compatible version of the Maps SDK.
implementation("com.google.maps.android:android-maps-utils:3.14.0")
}
استخدام إحدى الأدوات المساعدة من المكتبة، مثل
علامة
والتجميع العنقودي،
خرائط التمثيل اللوني
الآخر
والمرافق.
الخطوة 2: (اختياري) تثبيت مكتبة KTX للخرائط من أجل أداة Android المساعدة
تأتي حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة برامج Android المساعدة مع إضافات Kotlin المقابلة.
(KTX). وتوفر هذه المكتبة ميزات لغة Kotlin، مثل دوال الإضافات،
والوسيطات الافتراضية - لتمكينك من كتابة لغة Kotlin مختصرة ومثالية. إذا لم تكن كذلك
في Kotlin، يمكنك تخطي هذه الخطوة.
لاستخدام هذه المكتبة، أضف التبعية التالية، بالإضافة إلى
android-maps-utils إلى ملف build.gradle.kts في تطبيقك:
dependencies {
// KTX for the Maps SDK for Android Utility Library
implementation("com.google.maps.android:maps-utils-ktx:5.2.0")
}
يمكنك الاطّلاع على صفحة خرائط KTX GitHub
للحصول على معلومات إضافية حول هذه المكتبة.
الخطوة 3: عرض رمز مصدر مكتبة "حزمة تطوير البرامج (SDK) للخرائط" لتطبيقات Android
بما أنّ مكتبة الخدمات مفتوحة المصدر، يمكنك تنزيل
android-maps-utils
إلى جهازك لتخصيصها أو عرض التطبيق التجريبي، أو إذا كنت تريد فقط فهم
أعمال المكتبة. يمكنك إجراء ذلك من خلال
استنساخ المستودع (يُنصح به،
بتلقّي تحديثات تلقائية) أو
تنزيل
ملف ZIP. إذا كنت تريد تخصيص المكتبة، يجب عليك
إرسال بيانات المستودع
يتضمّن المستودع ما يلي:
- تطبيق تجريبي، في دليل
demo.
- تعرض هذه الصفحة مكتبة البرامج المساعدة في دليل
library.
- ملفات متنوعة تحتوي على معلومات حول التراخيص والمساهمين ومعلومات الملف التمهيدي.
- إعداد إصدار Gradle للاستخدام مع "استوديو Android"
تشغيل التطبيق التجريبي للأداة المساعدة
يشحن مستودع GitHub لمكتبة المرافق بتطبيق تجريبي يتضمن عينة
لكل أداة مساعدة. اتّبِع الخطوات التالية لتشغيل التطبيق التجريبي على
على جهاز Android.
- قم بتنزيل المستودع باستخدام أحد الخيارات المذكورة أعلاه.
- في "استوديو Android"، انقر على ملف -> جديد -> استيراد المشروع:
- تصفَّح للوصول إلى الدليل واختَره (بالنقر المزدوج)
android-maps-utils الذي تم إنشاؤه عندما
قد نسخت مكتبة المرافق. يعمل Android Studio الآن على إنشاء المشروع.
- إذا كنت تستخدم جهاز Android بدلاً من محاكي، تأكد من
تفعيل وضع مطور البرامج.
بعد ذلك، وصِّل جهاز Android بجهاز الكمبيوتر.
إضافة سطر واحد إلى local.properties يبدو كالتالي:
MAPS_API_KEY=YOUR_API_KEY
حيث YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه كما هو موضّح في
استخدام مفاتيح واجهة برمجة التطبيقات:
- أنشِئ تطبيق العرض التوضيحي وشغِّله.
من المفترض أن يتم فتح التطبيق على جهاز Android، ويعرض قائمة ببرامج الخدمات
بما في ذلك التجميع العنقودي وpoyutil وخريطة التمثيل اللوني وغيرها. يمكنك أيضًا العثور على التطبيق في
قائمة التطبيقات، تحت اسم العرض التوضيحي لاستخدام الخرائط.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page explains how to set up the Maps SDK for Android utility library and run its demo app, allowing you to utilize features like marker clustering and heatmaps.\u003c/p\u003e\n"],["\u003cp\u003eThe library supports Android API level 15 and above, requiring you to add a specific dependency to your app's \u003ccode\u003ebuild.gradle.kts\u003c/code\u003e file for implementation.\u003c/p\u003e\n"],["\u003cp\u003eAn optional Kotlin extensions (KTX) library provides Kotlin-specific features for more concise coding if you are developing in Kotlin.\u003c/p\u003e\n"],["\u003cp\u003eThe open-source nature of the library allows for customization by cloning or downloading the \u003ccode\u003eandroid-maps-utils\u003c/code\u003e repository from GitHub.\u003c/p\u003e\n"],["\u003cp\u003eYou can explore the functionalities of the library by running the demo app included in the repository, requiring steps like adding your API key and building the project in Android Studio.\u003c/p\u003e\n"]]],["To set up the Maps SDK for Android utility library, add the `android-maps-utils` dependency to your `build.gradle.kts` file. Optionally, include the `maps-utils-ktx` dependency for Kotlin features. The library, which supports Android API level 15 and above, is open-source and can be downloaded from GitHub. To run the included demo app, clone the repository, import the project into Android Studio, enable developer mode on your Android device, add your API key to `local.properties`, and then build and run the app.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/utility/setup \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/utility/setup \"View this page for the iOS platform docs.\")\n\nThis page describes how to set up the\n[Maps SDK for Android\nutility library](https://github.com/googlemaps/android-maps-utils), and to run the demo app included in the library.\n\nPrerequisites and notes\n\nThe Maps SDK for Android utility library supports Android\n[API\nlevel](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 15 and above. When setting your project build target, make sure you use the latest\nAndroid API level.\n\nThe\n[reference\ndocumentation](http://googlemaps.github.io/android-maps-utils/javadoc/) is available on GitHub.\n\nStep 1. Install the Maps SDK for Android utility library\n\nAdd the following dependency to your app's `build.gradle.kts` file: \n\n```carbon\ndependencies {\n\n\n // Utility Library for Maps SDK for Android\n // You do not need to add a separate dependency for the Maps SDK for Android\n // since this library builds in the compatible version of the Maps SDK.\n implementation(\"com.google.maps.android:android-maps-utils:3.14.0\")\n}\n```\n\nUse one of the utilities from the library, such as\n[marker\nclustering](/maps/documentation/android-sdk/utility/marker-clustering),\n[heatmaps](/maps/documentation/android-sdk/utility/heatmap), or\nthe [other\nutilities](/maps/documentation/android-sdk/utility).\n\nStep 2. (Optional) Install the Maps SDK for Android utility KTX library\n\nThe Maps SDK for Android utility library comes with a corresponding Kotlin extensions\n(KTX) library. This library provides Kotlin language features---such as extension functions, named\nand default arguments---to enable you to write concise and idiomatic Kotlin. If you are not\ndeveloping in Kotlin, you can skip this step.\n\nTo use this library, add the following dependency, in addition to the\n`android-maps-utils` dependency, to your app's `build.gradle.kts` file: \n\n```carbon\ndependencies {\n\n // KTX for the Maps SDK for Android Utility Library\n implementation(\"com.google.maps.android:maps-utils-ktx:5.2.0\")\n}\n```\n\nCheck out the [Maps KTX GitHub](https://github.com/googlemaps/android-maps-ktx) page\nfor additional information about this library.\n\nStep 3. View the Maps SDK for Android utility library source code\n\nSince the utility library is open source, you can download the\n[android-maps-utils](https://github.com/googlemaps/android-maps-utils)\nlibrary to your machine to customize it, view the demo app, or if you just want to understand how\nthe library works. You can do so by\n[cloning](https://github.com/googlemaps/android-maps-utils.git) the repo (recommended,\nto receive automatic updates) or\n[downloading\na zip file](https://github.com/googlemaps/android-maps-utils/archive/master.zip). If you want to customize the library, you should\n[fork the repo](https://help.github.com/articles/fork-a-repo).\n\nThe repository includes:\n\n- A demo application, in the `demo` directory.\n- The library of utilities, in the `library` directory.\n- Various files containing license, contributors, and readme information.\n- Gradle build configuration, for use with Android Studio.\n\nRun the utility demo app\n\nThe GitHub repository for the utility library ships with a demo app that includes sample\nimplementations of each utility. Follow these steps to run the demo app on\nyour Android device.\n\n1. Download the repository using one of the options mentioned above.\n2. In Android Studio, choose **File -\\\u003e New -\\\u003e Import Project**.\n3. Browse to and select (double-click) the **android-maps-utils** directory that was created when you cloned the utility library. Android Studio now builds the project.\n4. If you are using an Android device instead of an emulator, make sure to [enable developer mode](https://developer.android.com/tools/device.html#setting-up). Then attach the Android device to your computer.\n5. Add a single line to `local.properties` that looks like this:\n\n ```scdoc\n MAPS_API_KEY=YOUR_API_KEY\n ```\n\n Where \u003cvar translate=\"no\"\u003eYOUR_API_KEY\u003c/var\u003e is the API key you obtained as described in\n [Using API Keys](/maps/documentation/android-sdk/get-api-key).\n6. Build and run the **demo** app.\n\nThe app should open on the Android device, displaying a list of utilities\nincluding clustering, poyutil, heatmap, and more. You can also find the app in\nyour app list, under the name **Maps Utils Demo**."]]
