סקירה כללית והגדרה של 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 של הספרייה הזו מכיל גם אפליקציית הדגמה שמראה איך להשתמש בספריית KTX של Places באפליקציה שלכם.

המסך הראשון של אפליקציית הדוגמה של 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'.