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

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

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

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

‫SDK של מפות ל-Android Utility Library תומך ב-Android API level 15 ומעלה. כשמגדירים את יעד ה-build של הפרויקט, חשוב להשתמש ב-Android API level העדכני ביותר.

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

שלב 1. התקנה של Maps SDK for Android utility library

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

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.19.0")
}

אפשר להשתמש באחד מכלי השירות מהספרייה, כמו marker clustering,‏ heatmaps או other utilities.

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

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

שלב 3. הצגת קוד המקור של ספריית כלי העזר של Maps SDK ל-Android

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

המאגר כולל:

• אפליקציית הדגמה, בספרייה demo.
• ספריית כלי העזר, בספרייה library.
• קבצים שונים שמכילים מידע על רישיון, תורמים וקובץ readme.
• הגדרת build של Gradle, לשימוש עם 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 ותציג רשימה של כלי עזר, כולל clustering,‏ polyutil,‏ heatmap ועוד. אפשר גם למצוא את האפליקציה ברשימת האפליקציות, בשם Maps Utils Demo.