הגדרת SDK של מפות ל-Android Utility

בחירת פלטפורמה: Android iOS

בדף זה מוסבר איך להגדיר את ה-SDK של מפות Google לספריית הכלים של Android, ואיך להפעיל את אפליקציית ההדגמה שכלולה בספרייה.

דרישות מוקדמות והערות

ספריית הכלים של Maps SDK ל-Android תומכת ב-Android API ברמה 15 ומעלה. כשמגדירים יעד עבור ה-build של הפרויקט, צריך להשתמש ברמת ה-API העדכנית ביותר של Android.

מסמכי העזרה זמינים ב-GitHub.

שלב 1. התקנה של ערכת הכלים של מפות Google עבור ספריית הכלים של Android

יש להוסיף את התלות הבאה לקובץ build.gradle של האפליקציה:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

משתמשים באחד מכלי התחזוקה מהספרייה, כמו אשכולות של סמנים, מפות חום או כלים אחרים.

שלב 2: (אופציונלי) התקנת ספריית KTX של מפות Google ל-Android

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

כדי להשתמש בספרייה הזו, צריך להוסיף לקובץ build.gradle של האפליקציה את התלות הבאה, בנוסף לתלות android-maps-utils:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

מידע נוסף על הספרייה הזו זמין בדף מפות KTX GitHub.

שלב 3. הצגת קוד המקור של ספריית התשתיות של מפות Google עבור Android

מאחר שספריית כלי השירות היא בקוד פתוח, תוכלו להוריד את הספרייה android-maps-utils למחשב כדי להתאים אותה אישית, לצפות באפליקציית ההדגמה או רק כדי להבין איך הספרייה פועלת. אפשר לעשות זאת באמצעות שכפול המאגר (מומלץ, כדי לקבל עדכונים אוטומטיים) או הורדת קובץ ZIP. אם רוצים להתאים אישית את הספרייה, צריך לשכפל את המאגר.

המאגר כולל:

• אפליקציה להדגמה, בספרייה demo.
• ספריית הכלים, בספרייה library.
• קבצים שונים שמכילים פרטי רישיון, תורמים ומידע Readme.
• הגדרת Gradle של גרסת build, לשימוש ב-Android Studio.

הפעלת האפליקציה להדגמה של כלי השירות

המאגר ב-GitHub של ספריית התשתיות כולל אפליקציית הדגמה (דמו) שכוללת הטמעות לדוגמה של כל אחת מהן. כדי להפעיל את אפליקציית ההדגמה במכשיר Android, פועלים לפי השלבים הבאים.

1. מורידים את המאגר באמצעות אחת מהאפשרויות שלמעלה.
2. ב-Android Studio, בוחרים באפשרות File -> New -> Import Project (קובץ -> חדש -> ייבוא פרויקט).
3. מנווטים אל ספריית android-maps-utils שנוצרה בזמן השכפול של ספריית הכלים, ובוחרים בה (בלחיצה כפולה). המערכת יוצרת עכשיו את הפרויקט ב-Android Studio.
4. אם משתמשים במכשיר Android ולא באמולטור, חשוב להפעיל את מצב פיתוח. לאחר מכן מחברים את מכשיר Android למחשב.

5. מוסיפים שורה אחת ל-local.properties שנראית כך:

   MAPS_API_KEY=YOUR_API_KEY

   כאשר YOUR_API_KEY הוא מפתח ה-API שקיבלתם, כפי שמתואר במאמר שימוש במפתחות API.

6. מפתחים ומפעילים את אפליקציית ההדגמה.

האפליקציה אמורה להיפתח במכשיר Android ולהציג רשימה של כלי עזר, כולל אשכולות, poyutil, מפת חום ועוד. אפשר למצוא את האפליקציה גם ברשימת האפליקציות, בשם Maps Utils Demo.