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

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

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

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

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

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

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

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

نمونه‌ها را شبیه‌سازی و اجرا کنید

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

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

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

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

  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 SDK for Android در Wear OS در GitHub دردسترس است که می‌توانید از آن به‌عنوان نقطه شروع هنگام ساختن برنامه پوشیدنی استفاده کنید. این نمونه به شما نشان می‌دهد که چگونه یک Google Map پایه را در Wear OS راه‌اندازی کنید.