الأماكن Android KTX هي مجموعة من إضافات Kotlin لحزمة تطوير برامج الأماكن (SDK) لنظام التشغيل Android. توفّر هذه الإضافات ميزات لغة البرمجة Kotlin التي تتيح لك كتابة لغة Kotlin موجزة واصطلاحية عند تطوير البرامج لحزمة تطوير برامج الأماكن (SDK) لنظام التشغيل Android. خدمة الأماكن KTX مفتوحة المصدر ومتاحة على GitHub مع أمثلة.
تثبيت KTX لحزمة تطوير برامج الأماكن
لتثبيت KTX لحزمة تطوير برامج الأماكن لأجهزة Android، أضِف التبعيات التالية إلى ملف build.gradle
على مستوى التطبيق.
dependencies { // KTX for the Places SDK for Android library implementation 'com.google.maps.android:places-ktx:3.0.0' }
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق عرض توضيحي يوضح كيفية استخدام مكتبة الأماكن KTX في تطبيقك الخاص.
![]() |
![]() |
لتجربة التطبيق التجريبي، اتبِع الخطوات التالية:
- من GitHub، استنسِخ ملف ZIP أو نزِّله.
- في "استوديو Android"، انقر على ملف -> فتح وانتقِل إلى الدليل، ثم افتح المجلد الذي نسخته أو نزّلته للتو.
- أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
- الحصول على مفتاح واجهة برمجة تطبيقات الأماكن.
- في الدليل الجذر، أنشِئ ملفًا باسم
secrets.properties
. يجب ألا يكون هذا الملف خاضعًا للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات. - أضِف هذا السطر الواحد إلى
secrets.properties
PLACES_API_KEY="YOUR_API_KEY"
حيث يكونYOUR_API_KEY
هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع علىlocal.defaults.properties
كمثال. - ضمن إعدادات التشغيل، اختَر الوحدة app-places-ktx.
- اختَر تشغيل 'app-place-ktx'.