شروع سریع جغرافیایی برای اندروید

این شروع سریع برای ARCore Geospatial API به شما نشان می دهد که چگونه یک برنامه نمونه را در Android Studio اجرا کنید که API Geospatial را نشان می دهد.

برای راهنمایی برای توسعه برنامه خود با Geospatial API، به راهنمای توسعه‌دهنده Geospatial برای Android (Kotlin/Java) یا راهنمای توسعه‌دهنده Geospatial برای Android NDK (C) مراجعه کنید.

برای اطلاعات بیشتر در مورد Geospatial API به مقدمه ARCore Geospatial API مراجعه کنید.

اگر برای توسعه با ARCore تازه کار هستید، به شروع به کار مراجعه کنید.

الزامات

پشتیبانی دستگاه

برای لیست کاملی از دستگاه هایی که برای کار با ARCore تأیید شده اند، به دستگاه های پشتیبانی شده مراجعه کنید. برای Geospatial API، یکی از قطعات کلیدی سخت افزار مورد نیاز یک مغناطیس سنج است که با مشخصات Geospatial API مطابقت دارد. برخی از مغناطیس‌سنج‌ها با مشخصات مطابقت ندارند. دستگاه‌های دارای این مغناطیس‌سنج‌های خارج از مشخصات پشتیبانی نمی‌شوند.

نرم افزار

  • آخرین نسخه Google Play Services برای واقعیت افزوده بر روی دستگاه پشتیبانی شده نصب شده است.

  • Android Studio نسخه 3.0 یا بالاتر با پلتفرم Android SDK نسخه 7.0 (سطح API 24) یا بالاتر

  • ARCore SDK برای اندروید، که می توانید به یکی از دو روش دریافت کنید:

    • آن را از GitHub دانلود کنید و در دستگاه خود استخراج کنید.

    • با دستور زیر مخزن را کلون کنید:

      git clone https://github.com/google-ar/arcore-android-sdk.git

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

پروژه geospatial_java همراه با ARCore SDK برای Android کدی را توصیف می کند که Geospatial API را فراخوانی می کند.

  1. در Android Studio، از منوی File ، روی Open کلیک کنید.

  2. به پوشه پروژه برای arcore-android-sdk بروید.

  3. پوشه نمونه را باز کنید، پوشه geospatial_java را انتخاب کنید و روی Open کلیک کنید.

یک پروژه Google Cloud راه اندازی کنید

برای استفاده از سیستم موقعیت‌یابی بصری (VPS)، برنامه شما باید با پروژه Google Cloud مرتبط باشد که برای ARCore API فعال است. برای تنظیم مجوز ، استفاده از ARCore API در Google Cloud را ببینید. می‌توانید مجوز بدون کلید یا API Key را انتخاب کنید.

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

در اندروید استودیو، برنامه نمونه را اجرا کنید.

شما باید بتوانید نمای دوربین را به همراه اطلاعات اشکال زدایی که موقعیت جغرافیایی فعلی دستگاه شما را توصیف می کند، مشاهده کنید. همانطور که محیط اطراف خود را اسکن می کنید، اگر در منطقه ای هستید که توسط محلی سازی VPS پشتیبانی می شود، توجه کنید که مقادیر اطمینان دقت موقعیت یابی ممکن است با حرکت در اطراف تغییر کند.

هنگامی که ARCore به مکان و عنوان دستگاه شما اطمینان دارد، می توانید با استفاده از حالت Geospatial یک Anchor را در مکان فعلی خود قرار دهید.

اگر اطلاعات VPS در دسترس نباشد، ممکن است دقت موقعیت یابی بسیار پایین باشد. برنامه باید به اینترنت متصل باشد و مکان آن باید برای VPS مشخص باشد. برای بهترین نتایج، برنامه نمونه را در ساعات روشنایی روز در بیرون (نه داخل خانه) اجرا کنید.

همچنین، اگر در منطقه‌ای هستید که از VPS پشتیبانی نمی‌کند، یا اگر سیگنال‌های GPS کافی نیستند، ممکن است لازم باشد آستانه‌های اطمینان را در برنامه تنظیم کنید تا یک لنگر قرار دهید.

برای تنظیم آستانه ها:

  1. در Android Studio، GeospatialActivity را باز کنید و به بخش زیر بروید:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. در صورت نیاز این مقادیر را تنظیم کنید. هر چه مقدار بالاتر باشد، دقت کمتری دارد .

    کاهش دقت به برنامه اجازه می دهد تا عرض جغرافیایی بیشتری در قرار دادن لنگر داشته باشد. برای اطلاعات بیشتر به تنظیم برای دقت ژست مراجعه کنید.

مراحل بعدی