نسخه ی نمایشی را امتحان کنید

با ادغام Navigation SDK برای Android، برنامه شما می تواند فراتر از پیوند دادن به نمای نقشه خارجی باشد. با ناوبری Google Maps، برنامه شما می‌تواند بازیابی پویا و گزارش تک‌نگاهی داده‌های سفر راننده را ارائه دهد.

این راهنما یک پروژه اندروید استودیو را به شما ارائه می دهد، نحوه ادغام Navigation SDK را به شما نشان می دهد و سپس نحوه اجرای برنامه های نمایشی را به شما نشان می دهد.

Navigation SDK یک کتابخانه ثابت است که به شما امکان کنترل ظاهر و صدا را برای پیمایش در برنامه می دهد. برای جزئیات در مورد کتابخانه، مرجع SDK ناوبری (Javadoc) را در یک پنجره جداگانه باز کنید.

آماده شدن

مهم: از نسخه 3.0 Navigation SDK برای Android، می‌توانید آخرین نسخه Navigation SDK برای Android را از مخزن Maven ما دریافت کنید. اکنون این روش ترجیحی برای دریافت SDK است. برای اطلاعات بیشتر، به تنظیم پروژه خود مراجعه کنید.

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

برای شروع کار با Navigation SDK، حتما موارد زیر را داشته باشید.

• نماینده پلتفرم Google Maps برای دسترسی به موارد زیر:

  • یک کلید API که برای استفاده با Navigation SDK ارائه شده است. شما باید ID پروژه خود را که می توانید در داشبورد اصلی Google Cloud Console پیدا کنید، تحت نام پروژه ارائه دهید.
  • مصنوع SDK. مطمئن شوید که پروژه شما برای استفاده از Maven برای Navigation SDK پیکربندی شده است .
  • برای پروژه هایی که از نسخه 4.99.0 و نسخه های قبلی استفاده می کنند . اگر نمی توانید از Maven استفاده کنید، می توانید آرتیفکت فشرده شده را از Google Drive مشترک دانلود کنید. فایل کتابخانه ایستا .aar در دایرکتوری libs/ است که شامل Navigation SDK به عنوان یک بسته AAR است.
  • یک یا چند برنامه آزمایشی

• Android Studio ، محیط توسعه توصیه شده برای ساخت برنامه با Navigation SDK.

این مستندات برای افرادی که با توسعه اندروید و مفاهیم برنامه نویسی شی گرا آشنا هستند طراحی شده است. همچنین باید از نظر کاربر با نقشه های گوگل آشنا باشید.

برنامه های آزمایشی را دریافت کنید

Google دو برنامه برای کمک به شما در درک آنچه که Navigation SDK در بالای APIهای Google Maps ارائه می دهد، بسته به سطح تجربه شما، ارائه می دهد. توسعه‌دهندگانی که با APIهای Google Maps آشنا هستند می‌توانند توجه خود را روی نسخه نمایشی GoogleNavigation متمرکز کنند. توسعه دهندگانی که در هر دو پروژه جدید هستند، هر دو برنامه را مفید خواهند یافت.

از Navigation SDK for Android نسخه 4.1، برنامه‌های آزمایشی زیر هر دو در Google Drive مشترک برای دانلود در دسترس هستند.

• نسخه ی نمایشی GoogleNavigation : ادغام رفتارها و نماهای API را که به تجربه کاربر مربوط می شود در یک جلسه پیمایش هدایت شده نشان می دهد.

• نسخه نمایشی GoogleMap : رفتارهای فردی رابط GoogleMap را برای سفارشی کردن احساس و ارائه نقشه ها به نمایش می گذارد.

نکته ای در مورد استفاده از Maven

برنامه‌های نمایشی برای دانلود مصنوع SDK از مخزن راه دور Maven با استفاده از افزونه Artifact Registry در Gradle پیکربندی شده‌اند. برای دسترسی به SDK، حتماً دستورالعمل‌های پیکربندی پروژه را دنبال کنید.

توجه: برای نسخه‌های 4.99.0 و نسخه‌های قبلی، اگر همچنان می‌خواهید از بسته نرم‌افزار AAR خام در پروژه خود استفاده کنید، می‌توانید آن را در فهرست libs به پروژه خود اضافه کنید. سپس باید تمام ارجاعات به افزونه artifactregistry و مخزن راه دور مربوطه را حذف کنید و وابستگی AAR زیر را در build.gradle سطح برنامه خود اعلام کنید: api(نام: 'google_navigation', ext: 'aar')

نسخه ی نمایشی GoogleNavigation

آخرین نسخه نمایشی GoogleNavigation در ریشه Google Drive مشترک موجود است. نسخه‌های قبلی برنامه در «بایگانی» وجود دارد. برای نسخه‌های قبل از 4.1، برنامه در کنار AAR در همان فایل فشرده همراه است.

ساختمان

1. در Android Studio ، برنامه آزمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.

   توجه: برنامه تا زمانی که local.defaults.properties با کلید API ارائه شده به‌روزرسانی نکنید، نقشه را بار نمی‌کند.

2. local.defaults.properties را باز کنید و مقدار ویژگی MAPS_API_KEY را به روز کنید:

     MAPS_API_KEY=YOUR_API_KEY
   

3. روی build کلیک کنید و جزئیات پیاده سازی SDK را بررسی کنید.

   • در کلاس جاوا، کد پیاده سازی را یادداشت کنید.

   • در طرح‌بندی XML، به طرح و متن طرح‌بندی توجه کنید.

   • در فایل build.gradle ، SDK را در وابستگی ها یادداشت کنید.

برای اطلاعات بیشتر در مورد نحوه افزودن کلید API به مانیفست به مستندات افزونه Secrets Gradle مراجعه کنید.

در حال دویدن

1. یک دستگاه Android را به رایانه خود وصل کنید یا از یک شبیه ساز استفاده کنید.

   • دستگاه Android — برای فعال کردن گزینه های توسعه دهنده در دستگاه Android خود و پیکربندی سیستم خود برای شناسایی دستگاه به دستورالعمل ها مراجعه کنید.
   • شبیه ساز mdash؛ از مدیر دستگاه مجازی اندروید (AVD) برای پیکربندی یک دستگاه مجازی استفاده کنید. هنگام انتخاب یک شبیه ساز، مطمئن شوید که تصویری را انتخاب کرده اید که شامل API های Google باشد.

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

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

گزینه های NavViewActivity و NavFragmentActivity

پذیرندگان جدید NavSDK احتمالاً این دو گزینه را مفیدترین خواهند دانست.

گزینه 1 : NavViewActivity رفتارها را با استفاده از NavigationView در ارتباط با Navigator به نمایش می گذارد.

گزینه 2 : گزینه دوم، با عنوان NavFragmentActivity ، رفتارها را با استفاده از SupportNavigationFragment در کنار Navigator به نمایش می گذارد.

هنگامی که روی یکی از این گزینه ها کلیک می کنید، با موارد زیر روبرو خواهید شد:

• رابط کاربری ناوبری
• یک دکمه "تنظیم مقصد" در منوی برنامه
• پوششی که می توانید برای فراخوانی پویا متدها در API با آن تعامل داشته باشید
• یک منوی سرریز با گزینه های بیشتر

برای شروع، روی تنظیم مقصد کلیک کنید و آدرسی را انتخاب کنید. سپس برنامه سفر از مکان فعلی شما به آن آدرس را شبیه سازی می کند. از پوشش پانل های کنترل استفاده کنید تا ببینید هنگام فراخوانی یک API چه اتفاقی می افتد. به عنوان مثال، می‌توانید روی View Methods کلیک کنید تا سعی کنید SDK را به حالت شب مجبور کنید تا ببینید چه شکلی است.

گزینه SwappingMapAndNavActivity

توجه: این گزینه به شما در انتقال از نسخه 1 به نسخه 4 کمک می کند. ما استفاده از NavigationView به طور انحصاری در صورت امکان توصیه می کنیم، اما این را به عنوان مثالی برای نحوه استفاده از هر دو دست در دست ارائه می دهیم.

SwappingMapAndNavActivity الگوهای رایج زیر را به نمایش می گذارد:

• نمایش MapView
• با شروع ناوبری به NavigationView تغییر دهید
• بازگشت به MapView پس از پایان ناوبری

نسخه ی نمایشی GoogleMap

توجه: این برنامه برای نسخه‌های SDK قبل از نسخه 4.1 در دسترس نیست.

آخرین نسخه نمایشی GoogleNavigation در ریشه Google Drive مشترک موجود است. نسخه‌های قبلی برنامه در «بایگانی» وجود دارد.

ساختمان

1. در Android Studio ، برنامه آزمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.

   توجه: برنامه تا زمانی که local.defaults.properties را با کلید API ارائه شده به‌روزرسانی نکنید، نقشه را بارگیری نمی‌کند.

2. local.defaults.properties را باز کنید و مقدار ویژگی MAPS_API_KEY را به روز کنید:

     MAPS_API_KEY=YOUR_API_KEY
   

3. روی build کلیک کنید و جزئیات پیاده سازی SDK را بررسی کنید.

   • در کلاس جاوا، کد پیاده سازی را یادداشت کنید.

   • در طرح‌بندی XML، به طرح و متن طرح‌بندی توجه کنید.

   • در فایل build.gradle ، SDK را در وابستگی ها یادداشت کنید.

برای اطلاعات بیشتر در مورد نحوه افزودن کلید API به Manifest به افزونه Secrets gradle مراجعه کنید.

در حال دویدن

1. یک دستگاه Android را به رایانه خود وصل کنید یا از یک شبیه ساز استفاده کنید.

   • دستگاه Android به دستورالعمل‌ها مراجعه کنید تا گزینه‌های برنامه‌نویس را در دستگاه Android خود فعال کنید و سیستم خود را برای شناسایی دستگاه پیکربندی کنید.
   • شبیه ساز از مدیر دستگاه مجازی اندروید (AVD) برای پیکربندی یک دستگاه مجازی استفاده کنید. هنگام انتخاب یک شبیه ساز، مطمئن شوید که تصویری را انتخاب کرده اید که شامل API های Google باشد.

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

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

این الگوی ارائه و ساختار متناظر کد منبع باید برای کاربران دموهای Google Maps SDK آشنا باشد. این به این دلیل است که نسخه نمایشی GoogleMap به گونه ای طراحی شده است که شبیه برنامه نمایشی Maps API باشد. تفاوت اصلی این است که نسخه ی نمایشی Navigation SDK به کاربر اجازه می دهد انتخاب کند که کدام کلاس نمایش را می خواهد آزمایش کند: NavigationView یا MapView ، در صورت لزوم.

Google عموماً پذیرندگان را تشویق می‌کند که از NavigationView استفاده کنند. این نسخه نمایشی انعطاف‌پذیری را برای امتحان این رفتارها در هر دو نسخه در برنامه آزمایشی ما فراهم می‌کند و هر کدام را برای شما مناسب است انتخاب کنید. برای مثال، در شرایطی که از کتابخانه شخص ثالثی استفاده می‌کنید که انتظار دارد با آن کلاس تعامل داشته باشد، ممکن است همچنان استفاده از MapView ضروری باشد.

مهم: کلاس‌های MapView ، MapFragment و SupportMapFragment نیاز دارند که دستگاه‌ها برنامه خدمات Google Play را نصب کرده باشند. اگر یک شبیه‌ساز جدید بچرخانید، یا دستگاه بسیار قدیمی را به حالت کارخانه بازنشانی کنید، ممکن است تصویر Android با سرویس‌های Google Play بسیار قدیمی نصب شده باشد. در چنین مواردی، باید منتظر بمانید تا نسخه جدیدتر به طور خودکار ارائه شود، یا به صورت دستی خدمات Play را از طریق فروشگاه Google Play به روز کنید.