Places Android KTX هي مجموعة من إضافات Kotlin لحِزمة تطوير البرامج (SDK) للأماكن لنظام Android. توفّر هذه الإضافات لغة Kotlin. التي تمكّنك من كتابة لغة Kotlin الموجزة والاصطلاحية عند لتطوير حزمة تطوير برامج الأماكن لأجهزة Android. تطبيق Places KTX مفتوح المصدر ومتاح على GitHub إلى جانب الأمثلة.
تثبيت حزمة KTX لحزمة تطوير البرامج للأماكن
لتثبيت KTX من أجل حزمة تطوير برامج الأماكن لأجهزة Android، أضف
متابعة الاعتماديات على ملف build.gradle.kts
على مستوى التطبيق.
dependencies { // KTX for the Places SDK for Android library implementation("com.google.maps.android:places-ktx:3.2.0") }
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على عرض توضيحي التطبيق الذي يعرض كيفية استخدام مكتبة Places 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'.