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

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

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

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

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

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

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

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

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

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

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

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

  1. ב-Android Studio, בוחרים באפשרות File > New > Import Project (קובץ > חדש > ייבוא פרויקט).

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

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

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

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

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

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