نظرة عامة على نظام Android KTX وإعداده

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

تثبيت حزمة KTX لحزمة SDK من Places

لتثبيت حزمة KTX لحزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل 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 في تطبيقك.

الشاشة الأولى من نموذج تطبيق "الأماكن في KTX"، والتي تعرض خياراتك
شاشة تطبيق "البحث عن الأماكن" التجريبي

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

  1. من GitHub، يمكنك استنساخ ملف ZIP أو تنزيله.
  2. في Android Studio، اختَر ملف -> فتح وانتقِل إلى directory (الدليل) وافتح المجلد الذي نسخته أو نزّلته للتو.
  3. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
    1. احصل على مفتاح واجهة برمجة التطبيقات Places API.
    2. في الدليل الجذر، أنشئ ملفًا باسم secrets.properties. يجب ألّا يكون هذا الملف خاضعًا للإصدار التحكّم لحماية مفتاح واجهة برمجة التطبيقات.
    3. أضِف هذا السطر الواحد إلى secrets.properties
      . 
      PLACES_API_KEY="YOUR_API_KEY"
       حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على local.defaults.properties كمثال.
  4. ضمن إعدادات التشغيل، اختَر الوحدة app-places-ktx.
  5. اختَر تشغيل "app-places-ktx".