يُعد تطبيق "الأماكن" بنظام التشغيل Android KTX مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) الخاصة بالأماكن على نظام التشغيل Android. وتوفِّر هذه الإضافات ميزات لغة بلغة Kotlin تتيح لك كتابة لغة Kotlin موجزة واصطلاحية عند تطوير حزمة "SDK للأماكن" على نظام التشغيل 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.1.1' }
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي يوضح كيفية استخدام مكتبة KTX للأماكن في تطبيقك الخاص.
لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:
- من GitHub، استنسِخ ملف ZIP أو نزِّله.
- في "استوديو Android"، انقر على ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
- أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
- الحصول على مفتاح Places API.
- في الدليل الجذر، أنشِئ ملفًا باسم
secrets.properties
. يجب ألا يكون هذا الملف خاضعًا للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات. - أضِف هذا السطر الفردي إلى
secrets.properties
PLACES_API_KEY="YOUR_API_KEY"
حيث يكونYOUR_API_KEY
هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع علىlocal.defaults.properties
كمثال. - ضمن إعدادات التشغيل، اختَر الوحدة app-places-ktx.
- اختَر تشغيل 'app- places-ktx'.