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

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

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

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

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

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

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

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

יצירת עותקים מקודמים (cloning) של הדוגמאות והרצה שלהן

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

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 של Gradle.
  4. יוצרים קובץ secrets.properties ריק באותה ספרייה שבה נמצא קובץ local.properties של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח ה-API לפרויקט.

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

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

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

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