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

המסך הראשון של אפליקציית 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. בתצורת ההרצה, בוחרים את המודול app-places-ktx.
  5. בוחרים באפשרות הפעלת 'app-places-ktx'.