نظرة عامة على تطبيق KTX لنظام التشغيل Android وأماكنه

أماكن Android KTX عبارة عن مجموعة من إضافات Kotlin لـ Places SDK لنظام التشغيل Android. توفر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin مختصرة ومفهومة عند تطوير حزمة تطوير البرامج (SDK) للأماكن في Android. خدمة KTX مفتوحة المصدر ومتوفرة على GitHub بالإضافة إلى أمثلة.

تثبيت KTX على SDK للأماكن

لتثبيت KTX لـ الأماكن لـ Android، أضف التبعيات التالية إلى ملف build.gradle على مستوى التطبيق.

dependencies {
    implementation 'com.google.maps.android:places-ktx:0.4.0'
}

إذا كنت تستخدم مكتبة ثابتة في الأماكن من خلال الإصدار التجريبي الثالث من SDK للخرائط، فأضف التبعية التالية إلى ملف build.gradle على مستوى التطبيق بدلاً من ذلك.

dependencies {
    implementation 'com.google.maps.android:places-v3-ktx:0.4.0'
}

تجربة نموذج التطبيق

يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي يوضّح كيفية استخدام مكتبة أماكن KTX في تطبيقك.

لتجربة التطبيق التجريبي، اتبع الخطوات التالية:

1. من GitHub، يمكنك نسخ ملف ZIP أو تنزيله.
2. في Android Studio، اختر File -> Open ثم انتقل إلى الدليل وافتح المجلد الذي تم نسخه أو تنزيله للتو.
3. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
1. الحصول على مفتاح واجهة برمجة تطبيقات الأماكن.
2. في الدليل الجذري، أنشئ ملفًا باسم secure.properties. يجب ألا يخضع هذا الملف للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات.
3. أضِف هذا السطر الفردي إلى secure.properties
   

   PLACES_API_KEY=”YOUR_API_KEY”

   حيث يمثل YOUR_API_KEY مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على مثال secure.properties.template كمثال.
4. ضمن إعداد التشغيل، اختَر الوحدة التطبيق.
5. اختَر تشغيل "التطبيق".