Maps SDK for Android Utility Setup

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

این صفحه نحوه راه‌اندازی Maps SDK برای کتابخانه ابزار Android و اجرای برنامه نمایشی موجود در کتابخانه را توضیح می‌دهد.

پیش نیازها و نکات

کتابخانه ابزار Maps SDK for Android از Android API سطح 15 و بالاتر پشتیبانی می کند. هنگام تنظیم هدف ساخت پروژه خود، مطمئن شوید که از آخرین سطح API Android استفاده می کنید.

مستندات مرجع در GitHub موجود است.

مرحله 1. کتابخانه ابزار Android Maps SDK را نصب کنید

وابستگی زیر را به فایل build.gradle.kts برنامه خود اضافه کنید:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.8.2")
}

از یکی از ابزارهای کتابخانه مانند خوشه بندی نشانگر ، نقشه حرارتی یا سایر ابزارها استفاده کنید.

مرحله 2. (اختیاری) Maps SDK برای کتابخانه ابزار Android KTX را نصب کنید

کتابخانه ابزار Maps SDK برای Android با یک کتابخانه برنامه‌های افزودنی Kotlin (KTX) مربوطه ارائه می‌شود. این کتابخانه ویژگی‌های زبان کاتلین را فراهم می‌کند - مانند توابع پسوند، آرگومان‌های نام‌گذاری شده و پیش‌فرض - تا شما را قادر می‌سازد کوتلین مختصر و اصطلاحی بنویسید. اگر در کاتلین در حال توسعه نیستید، می توانید از این مرحله صرف نظر کنید.

برای استفاده از این کتابخانه، علاوه بر وابستگی android-maps-utils ، وابستگی زیر را به فایل build.gradle.kts برنامه خود اضافه کنید:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation("com.google.maps.android:maps-utils-ktx:5.1.1")
}

برای اطلاعات بیشتر درباره این کتابخانه، صفحه Maps KTX GitHub را بررسی کنید.

مرحله 3. کد منبع کتابخانه ابزار Android Maps SDK را مشاهده کنید

از آنجایی که کتابخانه ابزار منبع باز است، می‌توانید کتابخانه android-maps-utils را در دستگاه خود دانلود کنید تا آن را سفارشی کنید، برنامه آزمایشی را مشاهده کنید، یا اگر فقط می‌خواهید بدانید که چگونه کتابخانه کار می‌کند. می‌توانید این کار را با شبیه‌سازی مخزن (توصیه می‌شود، برای دریافت به‌روزرسانی‌های خودکار) یا دانلود یک فایل فشرده انجام دهید. اگر می‌خواهید کتابخانه را سفارشی کنید، باید مخزن را جدا کنید .

مخزن شامل:

  • یک برنامه آزمایشی، در فهرست demo .
  • کتابخانه خدمات، در فهرست راهنمای library .
  • فایل های مختلف حاوی مجوز، مشارکت کنندگان و اطلاعات readme.
  • پیکربندی Gradle build، برای استفاده با Android Studio.

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

مخزن GitHub برای کتابخانه ابزار با یک برنامه آزمایشی ارائه می شود که شامل اجرای نمونه های هر ابزار است. برای اجرای برنامه دمو در دستگاه اندرویدی خود این مراحل را دنبال کنید.

  1. با استفاده از یکی از گزینه های ذکر شده در بالا، مخزن را دانلود کنید.
  2. در Android Studio، File -> New -> Import Project را انتخاب کنید.
  3. فهرست راهنمای android-maps-utils را که هنگام کلون کردن کتابخانه ابزار ایجاد شده است، مرور کرده و (دوبار کلیک کنید) انتخاب کنید. Android Studio اکنون پروژه را می سازد.
  4. اگر به جای شبیه ساز از یک دستگاه Android استفاده می کنید، مطمئن شوید که حالت برنامه نویس را فعال کنید . سپس دستگاه اندروید را به رایانه خود وصل کنید.
  5. یک خط به local.properties اضافه کنید که به شکل زیر است:

    MAPS_API_KEY=YOUR_API_KEY

    جایی که YOUR_API_KEY کلید API است که همانطور که در استفاده از کلیدهای API توضیح داده شده است.

  6. برنامه دمو را بسازید و اجرا کنید.

برنامه باید در دستگاه Android باز شود و لیستی از ابزارهای کاربردی از جمله خوشه بندی، poyutil، نقشه حرارتی و موارد دیگر را نمایش دهد. همچنین می‌توانید برنامه را در فهرست برنامه‌های خود، تحت نام Maps Utils Demo پیدا کنید.