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

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

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

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

ספריית העזרה של מפות Google ל-Android תומכת ב-Android API רמה 15 ומעלה. כשמגדירים יעד build של פרויקט, חשוב לוודא שמשתמשים רמת ה-API ב-Android.

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

שלב 1. התקנת ה-SDK של מפות Google עבור ספריית העזרה של Android

צריך להוסיף את התלות הבאה לקובץ 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.8.2")
}

להשתמש באחת מכלי העזר מהספרייה, כמו סמן clustering, מפות חום, או האחר כלי תחזוקה.

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation("com.google.maps.android:maps-utils-ktx:5.1.1")
}

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

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

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

המאגר כולל:

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

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

המאגר של ספריית שירותי ה-GitHub ב-GitHub כולל אפליקציית הדגמה (דמו) שכוללת של כל כלי שירות. כדי להריץ את אפליקציית ההדגמה צריך לבצע את ההוראות הבאות: במכשיר ה-Android.

  1. מורידים את המאגר באמצעות אחת מהאפשרויות שלמעלה.
  2. ב-Android Studio, בוחרים באפשרות File -> חדש -> ייבוא פרויקט.
  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, מפת חום ועוד. אפשר למצוא את האפליקציה גם את רשימת האפליקציות, תחת השם הדגמה של שימוש במפות Google.