تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Places Android KTX هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) الخاصة بخدمة Places API لنظام التشغيل Android. توفّر هذه الإضافات ميزات لغة Kotlin تتيح لك كتابة رمز Kotlin موجز ومناسب عند تطوير تطبيقات تستخدم حزمة تطوير البرامج Places SDK لنظام التشغيل Android.
Places KTX هي مكتبة مفتوحة المصدر ومتاحة على GitHub مع أمثلة.
تثبيت KTX لحزمة تطوير البرامج Places SDK
لتثبيت KTX لحزمة Places SDK لنظام التشغيل Android، أضِف التبعيات التالية إلى ملف build.gradle.kts على مستوى التطبيق.
dependencies{// KTX for the Places SDK for Android libraryimplementation("com.google.maps.android:places-ktx:3.3.1")}
تجربة التطبيق النموذجي
يحتوي مستودع GitHub الخاص بهذه المكتبة أيضًا على تطبيق
تجريبي
يوضّح كيفية استخدام مكتبة Places KTX في تطبيقك.
تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ePlaces Android KTX offers Kotlin extensions for streamlined Places SDK interaction using idiomatic Kotlin.\u003c/p\u003e\n"],["\u003cp\u003eNative Kotlin APIs within the Places SDK for Android (version 4.0.0 and later) can be used as an alternative to Places Android KTX extensions.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can easily integrate Places KTX by adding the specified dependency to their app's \u003ccode\u003ebuild.gradle.kts\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eA demo application within the GitHub repository provides practical examples of utilizing the Places KTX library.\u003c/p\u003e\n"]]],["Places KTX provides Kotlin extensions for the Places SDK for Android, enabling concise Kotlin development. Install it by adding the `com.google.maps.android:places-ktx:3.3.1` dependency to your app's `build.gradle.kts` file. A demo app is available on GitHub; to run it, clone the repository, obtain a Places API key, and store it in a `secrets.properties` file in the root directory. Select and Run the **app-places-ktx** module in Android Studio. The Places SDK also offers native Kotlin APIs as of version 4.0.0.\n"],null,["Places Android KTX is a collection of Kotlin extensions for the\nPlaces SDK for Android. These extensions provide Kotlin\nlanguage features that enable you to write concise and idiomatic Kotlin when\ndeveloping for the Places SDK for Android.\nPlaces KTX is open-sourced and available on\n[GitHub](https://github.com/googlemaps/android-places-ktx)\nalong with examples.\n| **Note:** As of [version\n| 4.0.0](/maps/documentation/places/android-sdk/release-notes), the Places SDK for Android includes native Kotlin APIs that can be used instead of the Places Android KTX extensions. For more information, see the Places SDK for Android [Reference\n| Overview](/maps/documentation/places/android-sdk/reference).\n\nInstall KTX for the Places SDK\n\nTo install KTX for the Places SDK for Android, add the\nfollowing dependencies to your app-level `build.gradle.kts` file. \n\n```carbon\ndependencies {\n\n // KTX for the Places SDK for Android library\n implementation(\"com.google.maps.android:places-ktx:3.3.1\")\n}\n```\n\nTry the sample application\n\nThe GitHub repository for this library also contains a [demo\napplication](https://github.com/googlemaps/android-places-ktx)\nthat shows how you can use the Places KTX library in your own app.\n\n|---|---|\n| | |\n\nTo try the demo application, follow these steps:\n\n1. From [GitHub](https://github.com/googlemaps/android-places-ktx), clone the or download the ZIP file.\n2. In Android Studio, choose **File -\\\u003e Open** and navigate to the directory and open the folder that you just cloned or downloaded.\n3. Add an API key to the demo app.\n 1. [Get a Places API key](/maps/documentation/places/android-sdk/get-api-key).\n 2. In the root directory, create a file called `secrets.properties`. This file should NOT be under version control to protect your API key.\n 3. Add this single line to `secrets.properties` \n\n ```\n PLACES_API_KEY=\"YOUR_API_KEY\"\n ```\n where `YOUR_API_KEY` is the actual API key you obtained in the first step. You can look at the [`local.defaults.properties`](https://github.com/googlemaps/android-places-ktx/blob/main/local.defaults.properties) as an example.\n4. Under the run configuration, select the module **app-places-ktx**.\n5. Select **Run 'app-places-ktx'.**"]]
