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

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

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

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

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

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

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

בהמשך מפורטות דוגמאות לפעילויות מרכזיות שנכללות באפליקציית ApiDemos של Maps 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

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