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

dependencies {

    // KTX for the Places SDK for Android library
    implementation 'com.google.maps.android:places-ktx:3.1.1'
}

רוצה לנסות את האפליקציה לדוגמה?

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

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

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

  1. משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
  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'.