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

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

تثبيت KTX في حزمة تطوير برامج الأماكن (الأماكن)

لتثبيت KTX في حزمة تطوير برامج الأماكن (SDK) لنظام التشغيل 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 في هذه المكتبة أيضًا على تطبيق تجريبي يوضّح كيفية استخدام مكتبة Places KTX في تطبيقك الخاص.

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

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

  1. من GitHub، يمكنك نسخ ملف ZIP أو تنزيله.
  2. في "استوديو Android"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
  3. أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
    1. احصل على مفتاح واجهة برمجة تطبيقات الأماكن.
    2. في الدليل الجذري، أنشِئ ملفًا باسم secure.properties. يجب ألا يخضع هذا الملف للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات.
    3. أضِف هذا السطر الفردي إلى secure.properties
      PLACES_API_KEY=”YOUR_API_KEY”
      حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على secure.properties.template كمثال.
  4. ضمن إعدادات التشغيل، اختَر الوحدة التطبيق.
  5. اختَر تشغيل "التطبيق".