کد نمونه کیت توسعه نرم‌افزار Google Maps برای Android

انتخاب پلاتفرم: Android iOS JavaScript

مخزن «کیت توسعه نرم‌افزار Maps ویژه Android» در GitHub شامل نمونه‌هایی است که استفاده از «کیت توسعه نرم‌افزار Maps ویژه Android» را در برنامه Android شما نشان می‌دهد.

این مخزن حاوی برنامه ApiDemos است، یک برنامه نمونه که به شما امکان می‌دهد نمونه‌ها را از یک برنامه Android واحد بسازید و اجرا کنید. برنامه را وارد و بسازید، کلید API خود را اضافه کنید، نسخه نمایشی را مشاهده کنید، و از کد نمونه ارائه‌شده به‌عنوان نقطه شروع برنامه خود استفاده کنید.

وقتی برنامه نمونه را اجرا می‌کنید، فهرستی از نمونه‌های دردسترس را نمایش می‌دهد که می‌توانید در دستگاه خودتان اجرا کنید. یکی از گزینه‌ها را انتخاب کنید. برای مثال، روی نقشه پایه کلیک کنید.

عیب‌یابی: اگر برنامه نمونه باموفقیت اجرا می‌شود اما نقشه را نمی‌بینید، بررسی کنید که کلید API خود را به فایل مانیفست برنامه اضافه کرده باشید، همان‌طور که در استفاده از کلیدهای API توضیح داده شده است.

فهرست برنامه نمونه کیت توسعه نرم‌افزار Maps ویژه Android

فعالیت‌های نمونه کلیدی موجود در برنامه ApiDemos در «کیت توسعه نرم‌افزار Google Maps برای Android» در زیر فهرست شده‌اند و در صفحه‌های پیوندشده برای ارجاع سریع بازتولید شده‌اند. برای فهرست کامل نمونه‌های دردسترس، پوشه Kotlin یا Java را ببینید.

نمونه‌ها را کلون و اجرا کنید

برای اجرای این نمونه به‌صورت محلی، Git لازم است. فرمان زیر مخزن برنامه نمونه را شبیه‌سازی می‌کند.

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

پروژه نمونه را به «استودیو Android» وارد کنید:

  1. در Android Studio، فایل > جدید > وارد کردن پروژه را انتخاب کنید.

  2. به مکانی که مخزن را ذخیره کرده‌اید بروید و دایرکتوری پروژه را برای Kotlin یا Java انتخاب کنید:

    • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. باز کردن را انتخاب کنید. «استودیو Android» بااستفاده از ابزار ساخت Gradle پروژه شما را می‌سازد.
  4. فایل secrets.properties خالی در همان پوشه فایل local.properties پروژه خود ایجاد کنید. برای کسب اطلاعات بیشتر درباره این فایل، به افزودن کلید API به پروژه مراجعه کنید.
  5. از پروژه خود که کیت توسعه نرم‌افزار Google Maps برای Android در آن فعال است، کلید میانای برنامه‌سازی کاربردی دریافت کنید.

  6. رشته زیر را به secrets.properties اضافه کنید و YOUR_API_KEY را با مقدار کلید میانای برنامه‌سازی کاربردی خود جایگزین کنید:

    MAPS_API_KEY=YOUR_API_KEY
  7. برنامه را اجرا کنید.

برنامه نمونه برای نقشه‌ها در Wear OS

برنامه نمونه‌ای برای «کیت توسعه نرم‌افزار Maps ویژه Android در Wear OS» در GitHub دردسترس است که می‌توانید از آن به‌عنوان نقطه شروعی برای ساختن برنامه پوشیدنی استفاده کنید. این نمونه به شما نشان می‌دهد چگونه «نقشه Google» پایه را در Wear OS راه‌اندازی کنید.