با ادغام Navigation SDK برای Android، برنامه شما می تواند فراتر از پیوند دادن به نمای نقشه خارجی باشد. با ناوبری Google Maps، برنامه شما می‌تواند بازیابی پویا و گزارش تک‌نگاهی از داده‌های سفر کاربر را ارائه دهد. این راهنما نحوه اجرای برنامه‌های نمایشی Navigation SDK را که در GitHub در دسترس هستند، توضیح می‌دهد.
آماده شو
برای شروع کار با Navigation SDK، حتما موارد زیر را داشته باشید.
- یک کلید API که برای استفاده با Navigation SDK ارائه شده است. برای اطلاعات بیشتر در مورد ایجاد و محدود کردن کلیدها به استفاده از کلیدهای API مراجعه کنید.
- مصنوع SDK. مطمئن شوید که پروژه شما برای استفاده از Maven برای Navigation SDK پیکربندی شده است .
- یک یا چند برنامه آزمایشی
- Android Studio ، محیط توسعه توصیه شده برای ساخت برنامه با Navigation SDK.
این مستندات برای افرادی که با توسعه اندروید و مفاهیم برنامه نویسی شی گرا آشنا هستند طراحی شده است. همچنین باید از نظر کاربر با نقشه های گوگل آشنا باشید.
برنامه های آزمایشی را دریافت کنید
Google دو برنامه برای کمک به شما در درک آنچه که Navigation SDK در بالای APIهای Google Maps ارائه می دهد، بسته به سطح تجربه شما، ارائه می دهد. توسعه‌دهندگانی که با APIهای Google Maps آشنا هستند می‌توانند توجه خود را روی نسخه نمایشی GoogleNavigation متمرکز کنند. توسعه دهندگانی که در هر دو پروژه جدید هستند، هر دو برنامه را مفید خواهند یافت.
از Navigation SDK برای Android نسخه 4.1، برنامه های آزمایشی زیر هر دو در GitHub برای دانلود در دسترس هستند.
نسخه ی نمایشی GoogleNavigation : ادغام رفتارها و نماهای API را که به تجربه کاربر مربوط می شود در یک جلسه پیمایش هدایت شده نشان می دهد.
نسخه نمایشی GoogleMap : رفتارهای فردی رابط
GoogleMapرا برای سفارشی کردن احساس و ارائه نقشه ها به نمایش می گذارد.
نسخه ی نمایشی GoogleNavigation
آخرین نسخه نمایشی GoogleNavigation در GitHub در دسترس است.
ساختمان
در Android Studio ، برنامه آزمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.
local.defaults.propertiesرا باز کنید و مقدار ویژگیMAPS_API_KEYرا به روز کنید:MAPS_API_KEY=YOUR_API_KEYروی build کلیک کنید و جزئیات پیاده سازی SDK را بررسی کنید.
در کلاس جاوا، کد پیاده سازی را یادداشت کنید.
در طرح‌بندی XML، به طرح و متن طرح‌بندی توجه کنید.
در فایل
build.gradle، SDK را در وابستگی ها یادداشت کنید.
برای اطلاعات بیشتر در مورد نحوه افزودن کلید API به مانیفست به مستندات افزونه Secrets Gradle مراجعه کنید.
در حال دویدن
یک دستگاه Android را به رایانه خود وصل کنید یا از یک شبیه ساز استفاده کنید.
- دستگاه Android — برای فعال کردن گزینه های توسعه دهنده در دستگاه Android خود و پیکربندی سیستم خود برای شناسایی دستگاه به دستورالعمل ها مراجعه کنید.
- شبیه ساز mdash؛ از مدیر دستگاه مجازی اندروید (AVD) برای پیکربندی یک دستگاه مجازی استفاده کنید. هنگام انتخاب یک شبیه ساز، مطمئن شوید که تصویری را انتخاب کرده اید که شامل API های Google باشد.
در اندروید استودیو ، روی گزینه منوی اجرا (یا نماد دکمه پخش) کلیک کنید. و سپس یک هدف استقرار را انتخاب کنید.
هنگامی که برنامه ساخته و راه اندازی شد، صفحه فرود لیستی از گزینه ها را به کاربر ارائه می دهد.
گزینه های NavViewActivity و NavFragmentActivity
پذیرندگان جدید NavSDK احتمالاً این دو گزینه را مفیدترین خواهند دانست.
گزینه 1 : NavViewActivity رفتارها را با استفاده از NavigationView در ارتباط با Navigator به نمایش می گذارد.
گزینه 2 : گزینه دوم، با عنوان NavFragmentActivity ، رفتارها را با استفاده از SupportNavigationFragment در کنار Navigator به نمایش می گذارد.
هنگامی که روی یکی از این گزینه ها کلیک می کنید، با موارد زیر روبرو خواهید شد:
- رابط کاربری ناوبری
- یک دکمه "تنظیم مقصد" در منوی برنامه
- پوششی که می توانید برای فراخوانی پویا متدها در API با آن تعامل داشته باشید
- یک منوی سرریز با گزینه های بیشتر
برای شروع، روی تنظیم مقصد کلیک کنید و آدرسی را انتخاب کنید. سپس برنامه سفر از مکان فعلی شما به آن آدرس را شبیه سازی می کند. از پوشش پانل های کنترل استفاده کنید تا ببینید هنگام فراخوانی یک API چه اتفاقی می افتد. به عنوان مثال، می‌توانید روی View Methods کلیک کنید تا سعی کنید SDK را به حالت شب مجبور کنید تا ببینید چه شکلی است.
گزینه SwappingMapAndNavActivity
SwappingMapAndNavActivity الگوهای رایج زیر را به نمایش می گذارد:
- نمایش
MapView - با شروع ناوبری به
NavigationViewتغییر دهید - بازگشت به
MapViewپس از پایان ناوبری
نسخه ی نمایشی GoogleMap
آخرین نسخه نمایشی GoogleNavigation در GitHub در دسترس است.
ساختمان
در Android Studio ، برنامه آزمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.
local.defaults.propertiesرا باز کنید و مقدار ویژگیMAPS_API_KEYرا به روز کنید:MAPS_API_KEY=YOUR_API_KEYروی build کلیک کنید و جزئیات پیاده سازی SDK را بررسی کنید.
در کلاس جاوا، کد پیاده سازی را یادداشت کنید.
در طرح‌بندی XML، به طرح و متن طرح‌بندی توجه کنید.
در فایل
build.gradle، SDK را در وابستگی ها یادداشت کنید.
برای اطلاعات بیشتر در مورد نحوه افزودن کلید API به Manifest به افزونه Secrets gradle مراجعه کنید.
در حال دویدن
یک دستگاه Android را به رایانه خود وصل کنید یا از یک شبیه ساز استفاده کنید.
- دستگاه Android به دستورالعمل‌ها مراجعه کنید تا گزینه‌های برنامه‌نویس را در دستگاه Android خود فعال کنید و سیستم خود را برای شناسایی دستگاه پیکربندی کنید.
- شبیه ساز از مدیر دستگاه مجازی اندروید (AVD) برای پیکربندی یک دستگاه مجازی استفاده کنید. هنگام انتخاب یک شبیه ساز، مطمئن شوید که تصویری را انتخاب کرده اید که شامل API های Google باشد.
در اندروید استودیو ، روی گزینه منوی اجرا (یا نماد دکمه پخش) کلیک کنید. و سپس یک هدف استقرار را انتخاب کنید.
هنگامی که برنامه ساخته و راه اندازی شد، صفحه فرود لیستی از دموها را به کاربر ارائه می دهد.
این الگوی ارائه و ساختار متناظر کد منبع باید برای کاربران دموهای Google Maps SDK آشنا باشد. این به این دلیل است که نسخه نمایشی GoogleMap به گونه ای طراحی شده است که شبیه برنامه نمایشی Maps API باشد. تفاوت اصلی این است که نسخه ی نمایشی Navigation SDK به کاربر اجازه می دهد انتخاب کند که کدام کلاس نمایش را می خواهد آزمایش کند: NavigationView یا MapView ، در صورت لزوم.
Google عموماً پذیرندگان را تشویق می‌کند که از NavigationView استفاده کنند. این نسخه آزمایشی انعطاف‌پذیری را فراهم می‌کند تا این رفتارها را در هر دو نسخه در برنامه آزمایشی ما امتحان کنید و هر کدام برای شما مناسب است را انتخاب کنید. برای مثال، در شرایطی که از کتابخانه شخص ثالثی استفاده می‌کنید که انتظار دارد با آن کلاس تعامل داشته باشد، ممکن است همچنان استفاده از MapView ضروری باشد.