קוד לדוגמה של מפות Google ל-Android

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

המאגר של Maps SDK ל-Android ב-GitHub כולל דוגמאות שממחישות את השימוש ב-SDK של מפות Google ל-Android באפליקציה ל-Android.

המאגר מכיל את האפליקציה ApiDemos – אפליקציה לדוגמה שמאפשרת ליצור ולהפעיל את הדוגמאות מאפליקציה אחת ל-Android. תוכלו לייבא ולבנות את האפליקציה, להוסיף את מפתח ה-API, להציג את ההדגמה ולהשתמש בקוד לדוגמה שמופיע כנקודת התחלה לאפליקציה.

כשמריצים את האפליקציה לדוגמה, מוצגת רשימה של דוגמאות זמינות שתוכלו להריץ במכשיר שלכם. בוחרים אחת מהאפשרויות. לדוגמה, לוחצים על Basic Map.

פתרון בעיות: אם האפליקציה לדוגמה פועלת בהצלחה אבל המפה לא מוצגת, עליכם לבדוק שהוספתם את מפתח ה-API לקובץ המניפסט של האפליקציה, כפי שמתואר במאמר שימוש במפתחות API.

רשימת אפליקציות לדוגמה של מפות Google ל-Android

הפעילויות העיקריות לדוגמה שנכללות ב-SDK של מפות Google לאפליקציה ApiDemos ל-Android מפורטות למטה ומוצגות שוב בדפים המקושרים, כדי לעיין בהן במהירות. בתיקייה Kotlin או Java תוכלו לראות את הרשימה המלאה של הדוגמאות הזמינות.

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

יש צורך ב-Git כדי להריץ את הדוגמה הזו באופן מקומי. הפקודה הבאה משכפלת את מאגר האפליקציות לדוגמה.

git clone git@github.com:googlemaps-samples/android-samples.git

ייבוא של הפרויקט לדוגמה אל Android Studio:

  1. ב-Android Studio, בוחרים באפשרות קובץ > חדש > ייבוא פרויקט.

  2. נכנסים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט עבור Kotlin או Java:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. לוחצים על פתיחה. המערכת של Android Studio יוצרת את הפרויקט שלך באמצעות הכלי לבניית אתרים של Gradle.
  4. יוצרים קובץ secrets.properties ריק באותה ספרייה שבה נמצא קובץ local.properties של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח ה-API לפרויקט.

  5. מוסיפים את המחרוזת הבאה אל secrets.properties ומחליפים את YOUR_API_KEY בערך של מפתח ה-API:

    MAPS_API_KEY=YOUR_API_KEY
  6. מפעילים את האפליקציה.

אפליקציה לדוגמה למפות ב-Wear OS

דוגמה לאפליקציה של מפות Google ל-Android ב-Wear OS זמינה ב-GitHub, שבה אפשר להשתמש כנקודת התחלה כשמפתחים אפליקציה לבישה. הדוגמה מראה איך מגדירים מפה בסיסית של Google ב-Wear OS.