סקירה כללית והגדרה של 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.2.0")
}

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

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

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

כדי לנסות את אפליקציית הדגמה:

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