סקירה כללית והגדרה של Android KTX

‫Places Android KTX הוא אוסף של תוספי Kotlin ל-Places SDK ל-Android. התוספים האלה מספקים תכונות של שפת Kotlin שמאפשרות לכם לכתוב קוד תמציתי ואידיומטי של Kotlin כשאתם מפתחים באמצעות Places SDK ל-Android. ספריית Places KTX היא קוד פתוח וזמינה ב-GitHub, יחד עם דוגמאות.

התקנה של KTX ל-Places SDK

כדי להתקין את KTX עבור Places SDK ל-Android, מוסיפים את יחסי התלות הבאים לקובץ build.gradle.kts ברמת האפליקציה.

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.3.1")
}

ניסיון של אפליקציה לדוגמה

מאגר GitHub של הספרייה הזו מכיל גם אפליקציית הדגמה שמראה איך אפשר להשתמש בספריית Places KTX באפליקציה שלכם.

המסך הראשון של אפליקציית הדוגמה Places KTX, שבו מוצגות האפשרויות שלכם
מסך אפליקציית ההדגמה של חיפוש מקומות

כדי לנסות את אפליקציית ההדגמה, מבצעים את השלבים הבאים:

  1. מ-GitHub, משכפלים את קובץ ה-ZIP או מורידים אותו.
  2. ב-Android Studio, בוחרים באפשרות File -> Open (קובץ -> פתיחה), עוברים לספרייה ופותחים את התיקייה ששיבטתם או הורדתם.
  3. מוסיפים מפתח API לאפליקציית ההדגמה.
    1. קבלת מפתח Places API
    2. בתיקיית השורש, יוצרים קובץ בשם secrets.properties. כדי להגן על מפתח ה-API, הקובץ הזה לא צריך להיות תחת בקרת גרסאות.
    3. מוסיפים את השורה הזו אל secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
      כאשר YOUR_API_KEY הוא מפתח ה-API שקיבלתם בשלב הראשון. אפשר לראות דוגמה ב-local.defaults.properties.
  4. בקטע של הגדרת ההרצה, בוחרים את המודול app-places-ktx.
  5. בוחרים באפשרות הפעלת app-places-ktx.