الأماكن التي تعمل بنظام التشغيل Android KTX هي مجموعة من إضافات Kotlin لنظام التشغيل SDK للأماكن المخصصة لأجهزة Android. توفّر هذه الإضافات ميزات بلغة Kotlin تمكّنك من كتابة لغة Kotlin موجزة ومميّزة عند تطوير حزمة تطوير البرامج (SDK) للأماكن في نظام التشغيل Android. الأماكن (KTX) مفتوحة المصدر ومتاحة على GitHub بالإضافة إلى أمثلة.
تثبيت KTX لحزمة تطوير البرامج لأماكن Google
لتثبيت KTX لحزمة تطوير البرامج لحزمة تطوير البرامج (SDK) للأماكن في Android، أضِف الاعتمادات التالية إلى ملف build.gradle
على مستوى التطبيق.
dependencies {
implementation 'com.google.maps.android:places-ktx:0.4.0'
}
إذا كنت تستخدم مكتبة "الأماكن الثابتة" مع الإصدار التجريبي الإصدار 3 من حزمة تطوير البرامج في "خرائط Google"، أضِف الاعتمادية التالية إلى ملف build.gradle
على مستوى التطبيق بدلاً من ذلك.
dependencies {
implementation 'com.google.maps.android:places-v3-ktx:0.4.0'
}
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي يوضح كيفية استخدام مكتبة الأماكن في KTX في تطبيقك الخاص.
![]() |
![]() |
لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:
- من GitHub، استنسِق ملف ZIP أو نزِّله.
- في تطبيق "استوديو Android"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي تم نسخه أو تنزيله للتو.
- أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
- الحصول على مفتاح واجهة برمجة تطبيقات الأماكن
- في الدليل الجذري، أنشِئ ملفًا باسم
secure.properties
. يجب ألا يخضع هذا الملف للتحكّم في الإصدارات لحماية مفتاح واجهة برمجة التطبيقات. - أضِف هذا السطر الفردي إلى
secure.properties
PLACES_API_KEY=”YOUR_API_KEY”
حيث يكونYOUR_API_KEY
هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع علىsecure.properties.template
كمثال. - ضمن إعدادات الضبط، اختَر الوحدة app.
- اختَر تشغيل "التطبيق".