الأماكن Android KTX عبارة عن مجموعة من إضافات Kotlin لحزمة SDK للأماكن لنظام التشغيل Android. توفر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin موجزة ومفهومة عند تطوير حزمة تطوير برامج الأماكن لنظام التشغيل Android. تطبيق Places KTX مفتوح المصدر ومتاح على GitHub إلى جانب أمثلة.
تثبيت حزمة KTX لحزمة تطوير البرامج للأماكن
لتثبيت KTX من أجل حزمة تطوير برامج الأماكن لأجهزة Android، أضِف العناصر التابعة التالية إلى ملف build.gradle
على مستوى التطبيق.
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'.