Maps SDK برای کد نمونه اندروید

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت

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

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

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

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

لیست برنامه‌های نمونه‌ی اندروید برای SDK نقشه‌ها

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

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

برای اجرای این نمونه به صورت محلی به گیت نیاز است. دستور زیر مخزن برنامه نمونه را کپی می‌کند.

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

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

  1. در اندروید استودیو، مسیر File > New > Import Project را انتخاب کنید.

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

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

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

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

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

یک نمونه برنامه برای Maps SDK برای اندروید در Wear OS در GitHub موجود است که می‌توانید هنگام ساخت یک برنامه پوشیدنی از آن به عنوان نقطه شروع استفاده کنید. این نمونه به شما نشان می‌دهد که چگونه یک نقشه گوگل پایه را در Wear OS راه‌اندازی کنید.