ثبت‌نام سریع و تأییدشده

نمای کلی

وب iOS میانای برنامه‌سازی کاربردی

Google Maps Platform برای وب (JS،‏ TS)،‏ Android، و iOS دردسترس است و همچنین میاناهای برنامه‌سازی کاربردی سرویس‌های وب را برای دریافت اطلاعات درباره مکان‌ها، مسیرها، و فاصله‌ها ارائه می‌دهد. نمونه‌های این راهنما برای یک پلاتفرم نوشته شده‌اند، اما پیوندهای اسناد برای پیاده‌سازی در پلاتفرم‌های دیگر ارائه شده‌اند.

اکنون بسازید!

Quick Builder در کنسول Google Cloud به شما امکان می‌دهد بااستفاده از میانای کاربر تعاملی که کد جاوا اسکریپت برایتان تولید می‌کند، تکمیل خودکار فرم نشانی بسازید.

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

هرچه کاربران بیشتر مجبور به تایپ کردن یا وارد کردن داده‌های تکراری باشند، احتمال کمتری وجود دارد که آن‌ها را به‌عنوان مشتری حفظ کنید. ایجاد تجربه ثبت‌نام سریع، آسان، و تأییدشده تجربه کاربری را بهبود می‌بخشد و درعین‌حال به شما کمک می‌کند کاربران را در سایتتان نگه دارید.

نشانی‌هایی که به‌صورت دستی وارد می‌شوند می‌توانند منجر به کاهش تبدیل‌ها، داده‌های CRM اشتباه، و اشتباهات پرهزینه در ارسال شوند. «ثبت‌نام سریع و تأییدشده» ثبت‌نام را سریع‌تر می‌کند، نشانی‌های اطراف را فوراً با چند ضربه انگشت پیشنهاد می‌دهد، و نشانی واردشده را برای تأیید دیداری نمایش می‌دهد، که به کاربر کمک می‌کند مطمئن شود نشانی درست را وارد کرده است. درستی‌سنجی نشانی کاربر بااستفاده از مکان فعلی او به جلوگیری از کلاهبرداری نیز کمک می‌کند و اعتماد کاربر به محصولات و خدمات شما را تقویت می‌کند. درستی‌سنجی همچنین می‌تواند اطمینان شما را در ارائه فوری کارت‌های اعتباری و بانکی مجازی افزایش دهد.

این سند راهنمای پیاده‌سازی برای ساختن تجربه «ثبت‌نام سریع و تأییدشده» با «پلاتفرم Google Maps» را ارائه می‌دهد. چون کاربران به احتمال زیاد در دستگاه‌های همراه ثبت‌نام می‌کنند، بیشتر نمونه‌های پیاده‌سازی در این سند بر Android تمرکز دارند. برای مشاهده مثال کامل، کد منبع نمونه را ببینید. همچنین می‌توانید از کیت‌های توسعه نرم‌افزار iOS برای دستیابی به اهداف مشابه استفاده کنید.

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

درحال فعال کردن میاناهای برنامه‌سازی کاربردی

برای پیاده‌سازی این توصیه‌ها، باید میاناهای برنامه‌سازی کاربردی زیر را در کنسول Google Cloud فعال کنید:

برای اطلاعات بیشتر درباره راه‌اندازی، به شروع به کار با Google Maps Platform مراجعه کنید.

بخش‌های روال‌های مطلوب

این سند شامل روش‌ها و سفارشی‌سازی‌های زیر است.

  • نماد علامت تأیید یکی از روال‌های مطلوب اصلی است.
  • نماد ستاره سفارشی‌سازی اختیاری اما توصیه‌شده‌ای است که راهکار را بهبود می‌بخشد.
افزودن تکمیل خودکار به فیلدهای ورودی فرم نشانی را به‌طور خودکار تکمیل کنید. عملکرد «تایپ درحین حرکت» را اضافه کنید تا تجربه کاربری در همه پلاتفرم‌ها بهبود یابد و دقت نشانی با حداقل تعداد کلیدهای فشرده‌شده افزایش یابد.
ارائه تأیید تصویری نشانی به کاربران اجازه دهید نشانی‌شان را روی نقشه ببینند تا به‌صورت تصویری تأیید شود که نشانی را درست وارد کرده‌اند.
مقایسه نشانی واردشده توسط کاربر با مکان دستگاه نشانی انتخاب‌شده یا واردشده کاربر را با مکان فعلی دستگاه او مقایسه کنید تا به تعیین اینکه او در نشانی مشخص‌شده است کمک کنید. (برای اینکه این کار انجام شود، کاربران باید هنگام ثبت‌نام در خانه باشند.)
نکاتی برای بهبود بیشتر «ثبت‌نام سریع و درستی‌سنجی‌شده» می‌توانید با افزودن مواردی مثل سفارشی‌سازی ظاهر و حس ابزاره «تکمیل خودکار» یا اجازه دادن به کاربران برای انتخاب نام کسب‌وکار یا نشان به‌عنوان نشانی، ورودی نشانی را حتی بیشتر بهبود دهید.

افزودن تکمیل خودکار به فیلدهای ورودی

این نمونه از موارد زیر استفاده می‌کند: کیت توسعه نرم‌افزار مکان‌ها، ویژه Android همچنین دردسترس است: iOS | JavaScript

«تکمیل خودکار جا» می‌تواند وارد کردن نشانی را در برنامه‌تان ساده کند و به نرخ تبدیل بالاتر و تجربه یکپارچه برای مشتریانتان منجر شود. «تکمیل خودکار» یک فیلد ورودی سریع با پیش‌بینی نشانی «تایپ پیش‌نگر» ارائه می‌دهد که می‌توان از آن برای پر کردن خودکار فرم نشانی ثبت‌نام استفاده کرد. با گنجاندن «تکمیل خودکار جا» در جریان ثبت‌نامتان، می‌توانید:

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

وقتی کاربر چارگوش ورودی «تکمیل خودکار» را انتخاب می‌کند و شروع به تایپ می‌کند، فهرستی از پیش‌بینی‌های نشانی ظاهر می‌شود.

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

ویدیوها: بهبود فرم‌های نشانی با «تکمیل خودکار جا»

فرم‌های نشانی

Android

iOS

وب

Google Maps Platform ابزاره «تکمیل خودکار جا» را برای پلاتفرم‌های تلفن همراه و وب ارائه می‌دهد. این ابزاره که در شکل‌های قبلی نشان داده شده است، کادر گفتگوی جستجویی با عملکرد تکمیل خودکار داخلی ارائه می‌دهد که حتی می‌توانید آن را برای جستجوی محدود به مکان بهینه‌سازی کنید.

این بخش نحوه پیاده‌سازی «تکمیل خودکار جا» را برای «ثبت‌نام سریع و درستی‌سنجی‌شده» شرح می‌دهد.

افزودن ابزارک «تکمیل خودکار جا»

در Android، می‌توانید ابزاره تکمیل خودکار را بااستفاده از هدف تکمیل خودکار اضافه کنید که «تکمیل خودکار جا» را از فیلد ورودی «خط نشانی ۱» راه‌اندازی می‌کند، جایی که کاربر شروع به وارد کردن نشانی خود می‌کند. وقتی شروع به تایپ کردن می‌کنند، می‌توانند نشانی‌شان را از فهرست پیش‌بینی‌های «تکمیل خودکار» انتخاب کنند.

ابتدا، بااستفاده از ActivityResultLauncher، راه‌انداز فعالیتی آماده کنید که منتظر نتیجه‌ای از فعالیت راه‌اندازی‌شده باشد. فراخوانی نتیجه حاوی شیء «مکان» مربوط به نشانی‌ای خواهد بود که کاربر از پیش‌بینی‌های «تکمیل خودکار» انتخاب می‌کند.

    private final ActivityResultLauncher<Intent> startAutocomplete =
            registerForActivityResult(
                    new ActivityResultContracts.StartActivityForResult(),
                    result -> {
                        if (result.getResultCode() == Activity.RESULT_OK) {
                            Intent intent = result.getData();
                            if (intent != null) {
                                AutocompletePrediction prediction =
                                        PlaceAutocomplete.getPredictionFromIntent(intent);
                                AutocompleteSessionToken sessionToken =
                                        PlaceAutocomplete.getSessionTokenFromIntent(intent);
                                if (prediction != null) {
                                    List<Place.Field> fields =
                                            Arrays.asList(
                                                    Place.Field.ADDRESS_COMPONENTS,
                                                    Place.Field.LOCATION,
                                                    Place.Field.VIEWPORT);
                                    FetchPlaceRequest request =
                                            FetchPlaceRequest.builder(
                                                            prediction.getPlaceId(), fields)
                                                    .setSessionToken(sessionToken)
                                                    .build();
                                    placesClient
                                            .fetchPlace(request)
                                            .addOnSuccessListener(
                                                    response -> {
                                                        Place place = response.getPlace();
                                                        // Write a method to read the address
                                                        // components from the Place
                                                        // and populate the form with the address
                                                        // components
                                                        Log.d(
                                                                TAG,
                                                                "Place: "
                                                                        + place
                                                                                .getAddressComponents());
                                                        fillInAddress(place);
                                                    })
                                            .addOnFailureListener(
                                                    exception -> {
                                                        Log.e(
                                                                TAG,
                                                                "Place not found: "
                                                                        + exception.getMessage());
                                                    });
                                }
                            }
                        } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                            // The user canceled the operation.
                            Log.i(TAG, "User canceled autocomplete");
                        }
                    });

سپس، فیلدها، مکان، و ویژگی‌های نوع هدف «تکمیل خودکار جا» را تعریف کنید و آن را با Autocomplete.IntentBuilder بسازید. درنهایت، هدف را بااستفاده از ActivityResultLauncher تعریف‌شده در نمونه کد قبلی راه‌اندازی کنید.

    private void startAutocompleteIntent() {
        // Build the autocomplete intent with country and type filters applied
        Intent intent =
                new PlaceAutocomplete.IntentBuilder()
                        .setCountries(List.of("US"))
                        .setTypesFilter(List.of(PlaceTypes.ADDRESS))
                        .build(this);
        startAutocomplete.launch(intent);
    }

مدیریت نشانی برگردانده‌شده توسط «تکمیل خودکار جا»

تعریف کردن ActivityResultLauncher در مراحل قبل همچنین مشخص می‌کند که وقتی نتیجه فعالیت در فراخوانی برگشتی برگردانده می‌شود چه کاری باید انجام شود. اگر کاربر پیش‌بینی‌ای را انتخاب کرده باشد، آن پیش‌بینی در هدف موجود در شیء نتیجه ارائه خواهد شد. ازآنجایی‌که هدف توسط Autocomplete.IntentBuilder ساخته شده است، روش Autocomplete.getPlaceFromIntent() می‌تواند شیء Place را از آن استخراج کند.

    private final ActivityResultLauncher<Intent> startAutocomplete =
            registerForActivityResult(
                    new ActivityResultContracts.StartActivityForResult(),
                    result -> {
                        if (result.getResultCode() == Activity.RESULT_OK) {
                            Intent intent = result.getData();
                            if (intent != null) {
                                AutocompletePrediction prediction =
                                        PlaceAutocomplete.getPredictionFromIntent(intent);
                                AutocompleteSessionToken sessionToken =
                                        PlaceAutocomplete.getSessionTokenFromIntent(intent);
                                if (prediction != null) {
                                    List<Place.Field> fields =
                                            Arrays.asList(
                                                    Place.Field.ADDRESS_COMPONENTS,
                                                    Place.Field.LOCATION,
                                                    Place.Field.VIEWPORT);
                                    FetchPlaceRequest request =
                                            FetchPlaceRequest.builder(
                                                            prediction.getPlaceId(), fields)
                                                    .setSessionToken(sessionToken)
                                                    .build();
                                    placesClient
                                            .fetchPlace(request)
                                            .addOnSuccessListener(
                                                    response -> {
                                                        Place place = response.getPlace();
                                                        // Write a method to read the address
                                                        // components from the Place
                                                        // and populate the form with the address
                                                        // components
                                                        Log.d(
                                                                TAG,
                                                                "Place: "
                                                                        + place
                                                                                .getAddressComponents());
                                                        fillInAddress(place);
                                                    })
                                            .addOnFailureListener(
                                                    exception -> {
                                                        Log.e(
                                                                TAG,
                                                                "Place not found: "
                                                                        + exception.getMessage());
                                                    });
                                }
                            }
                        } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                            // The user canceled the operation.
                            Log.i(TAG, "User canceled autocomplete");
                        }
                    });

از آنجا، Place.getAddressComponents() را فراخوانی کنید و هر مؤلفه نشانی را با فیلد ورودی مربوطه در فرم نشانی مطابقت دهید و فیلد را با مقدار «مکان» انتخاب‌شده کاربر پُر کنید.

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

ملاحظات هنگام پیاده‌سازی «تکمیل خودکار جا»

«تکمیل خودکار جا» گزینه‌هایی دارد که به آن اجازه می‌دهد در پیاده‌سازی‌اش انعطاف‌پذیر باشد، اگر بخواهید از چیزی بیشتر از ابزاره استفاده کنید. می‌توانید از ترکیبی از سرویس‌ها استفاده کنید تا دقیقاً آنچه را نیاز دارید برای مطابقت دادن مکان به روش صحیح دریافت کنید.

  • برای فرم ADDRESS، پارامتر types را روی address تنظیم کنید تا مطابقت‌ها به نشانی‌های کامل خیابان محدود شود. درباره انواع پشتیبانی‌شده در درخواست‌های «تکمیل خودکار جا» بیشتر بدانید.

  • اگر نیازی به جستجوی سراسری ندارید، محدودیت‌ها و سوگیری‌های مناسب را تنظیم کنید. پارامترهای متعددی وجود دارد که می‌توان از آن‌ها برای سوگیری یا محدود کردن هرگونه مطابقت فقط به مناطق خاص استفاده کرد.

    • از RectangularBounds برای تنظیم مرزهای مستطیلی برای محدود کردن یک منطقه استفاده کنید، از setLocationRestriction() استفاده کنید تا مطمئن شوید فقط نشانی‌های موجود در آن مناطق برگردانده می‌شوند.

    • از setCountries() برای محدود کردن پاسخ‌ها به مجموعه خاصی از کشورها استفاده کنید.

  • فیلدها را قابل‌ویرایش بگذارید تا اگر فیلدهای خاصی در تطابق ازقلم افتاده بود، مشتریان بتوانند درصورت نیاز نشانی را به‌روز کنند. چون اکثر نشانی‌های برگردانده‌شده توسط «تکمیل خودکار جا» حاوی شماره‌های فرعی مانند شماره آپارتمان، سوئیت، یا واحد نیستند، می‌توانید تمرکز را به «خط نشانی ۲» منتقل کنید تا کاربر را تشویق کنید درصورت لزوم آن اطلاعات را تکمیل کند.

ارائه تأیید تصویری نشانی

این نمونه از موارد زیر استفاده می‌کند: کیت توسعه نرم‌افزار Google Maps برای Android همچنین دردسترس است: iOS | JavaScript

به‌عنوان بخشی از ورودی نشانی، تأیید دیداری نشانی را در نقشه به کاربران ارائه دهید. این کار به کاربران اطمینان بیشتری می‌دهد که نشانی درست است.

شکل زیر نقشه‌ای را در زیر نشانی نشان می‌دهد که سنجاقی روی نشانی واردشده قرار دارد.

مثال زیر از مراحل اصلی برای افزودن نقشه در Android پیروی می‌کند. برای جزئیات بیشتر به اسناد مراجعه کنید.

درحال افزودن SupportMapFragment…

ابتدا، قطعه SupportMapFragment را به فایل XML چیدمان اضافه کنید.

    <fragment
        android:name="com.google.android.gms.maps.SupportMapFragment"
        android:id="@+id/confirmation_map"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

سپس، اگر قطعه هنوز وجود ندارد، آن را به‌صورت برنامه‌نویسی‌شده اضافه کنید.

    private void showMap(Place place) {
        coordinates = place.getLocation();

        // It isn't possible to set a fragment's id programmatically so we set a tag instead and
        // search for it using that.
        mapFragment =
                (SupportMapFragment)
                        getSupportFragmentManager().findFragmentByTag(MAP_FRAGMENT_TAG);

        // We only create a fragment if it doesn't already exist.
        if (mapFragment == null) {
            mapPanel = ((ViewStub) findViewById(R.id.stub_map)).inflate();
            GoogleMapOptions mapOptions = new GoogleMapOptions();
            mapOptions.mapToolbarEnabled(false);

            // To programmatically add the map, we first create a SupportMapFragment.
            mapFragment = SupportMapFragment.newInstance(mapOptions);

            // Then we add it using a FragmentTransaction.
            getSupportFragmentManager()
                    .beginTransaction()
                    .add(R.id.confirmation_map, mapFragment, MAP_FRAGMENT_TAG)
                    .commit();
            mapFragment.getMapAsync(this);
        } else {
            updateMap(coordinates);
        }
    }

دریافت نام کاربری برای قطعه و ثبت کردن فراخوانی برگشتی

  1. برای دریافت دستگیره قطعه، روش FragmentManager.findFragmentById را فراخوانی کنید و شناسه منبع قطعه را در فایل چیدمان به آن ارسال کنید. اگر قطعه را به‌صورت پویا اضافه کرده‌اید، این مرحله را رد کنید زیرا قبلاً دسته را بازیابی کرده‌اید.

  2. برای تنظیم کردن فراخوانی برگشتی در قطعه، روش getMapAsync را فراخوانی کنید.

برای مثال، اگر قطعه را به‌صورت ایستا اضافه کرده‌اید:

Kotlin

val mapFragment = supportFragmentManager
    .findFragmentById(R.id.map) as SupportMapFragment
mapFragment.getMapAsync(this)

      

جاوا

SupportMapFragment mapFragment =
        (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
mapFragment.getMapAsync(this);

      

سبک‌بندی و افزودن نشانگر به نقشه

وقتی نقشه آماده شد، سبک را تنظیم کنید، دوربین را در مرکز قرار دهید، و نشانگری در مختصات نشانی واردشده اضافه کنید. کد زیر از سبک‌پردازی تعریف‌شده در شیء JSON استفاده می‌کند یا می‌توانید شناسه نقشه‌ای را بار کنید که با سبک‌پردازی نقشه بااستفاده از فضای ابری تعریف شده است.

    @Override
    public void onMapReady(@NonNull GoogleMap googleMap) {
        map = googleMap;
        try {
            // Customise the styling of the base map using a JSON object defined
            // in a string resource.
            boolean success =
                    map.setMapStyle(MapStyleOptions.loadRawResourceStyle(this, R.raw.style_json));

            if (!success) {
                Log.e(TAG, "Style parsing failed.");
            }
        } catch (Resources.NotFoundException e) {
            Log.e(TAG, "Can't find style. Error: ", e);
        }
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(coordinates, 15f));
        marker = map.addMarker(new MarkerOptions().position(coordinates));
    }

(مشاهده نمونه کد کامل)

درحال غیرفعال کردن کنترل‌های نقشه

برای تمیز نگه داشتن نقشه با نشان دادن مکان بدون کنترل‌های اضافی نقشه مانند قطب‌نما یا نوار ابزار، کنترل‌هایی را که نیاز ندارید غیرفعال کنید. در Android، گزینه دیگر فعال کردن حالت ساده برای ارائه تعامل محدود است.

مقایسه نشانی واردشده توسط کاربر با مکان دستگاه

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

امنیت در دریافت بررسی نشانی، به‌ویژه با فرایند ثبت‌نام دیجیتال، بسیار مهم است. این بخش راهنمایی و نمونه‌هایی برای بررسی اینکه آیا مکان کاربر درطول ثبت‌نام با نشانی‌ای که به‌عنوان نشانی خودش وارد می‌کند مطابقت دارد یا نه ارائه می‌دهد.

فرایند مقایسه نشانی واردشده با مکان دستگاه شامل مراحل زیر است:

  1. تبدیل نشانی واردشده توسط کاربر به مختصات جغرافیایی.
  2. درخواست اجازه از کاربر برای دریافت مکان دستگاه او.
  3. محاسبه فاصله بین نشانی واردشده و مکان دستگاه. شما می‌توانید حداکثر فاصله‌ای را که برای مطابقت نشانی-مکان درنظر گرفته می‌شود تعیین کنید.

شکل زیر نمونه‌ای از نحوه درخواست از کاربران برای مقایسه نشانی واردشده با مکان فعلی‌شان است.

تبدیل نشانی واردشده توسط کاربر به مختصات جغرافیایی

این نمونه از موارد زیر استفاده می‌کند: کیت توسعه نرم‌افزار مکان‌ها، ویژه Android همچنین دردسترس است: iOS | JavaScript | Geocoding API

پس‌از اینکه کاربران با درستی‌سنجی نشانی موافقت کردند (با لمس کردن «تأیید کنید که اکنون آنجا هستم» در شکل قبلی)، اولین گام در مقایسه نشانی با مکان فعلی تبدیل نشانی واردشده به مختصات جغرافیایی است.

اگر کاربر نشانی‌اش را با «تکمیل خودکار جا» انتخاب کرده است، حتماً Place.Field.LAT_LNG را در فهرست فیلد «تکمیل خودکار جا» درخواست کنید، همان‌طور که در تکه‌کد افزودن ابزاره «تکمیل خودکار جا» نشان داده شده است، و روش Place.getLatLng() را برای دریافت مختصات جغرافیایی نشانی انتخاب‌شده فراخوانی کنید.

coordinates = place.getLatLng();

اگر کاربر نشانی‌اش را به‌صورت دستی وارد کرده است یا پس‌از اینکه «تکمیل خودکار جا» فیلدها را پر کرد، ویرایش‌هایی انجام داده است، از سرویس زمین‌کدیاب Android یا Geocoding API برای جستجوی مختصات مربوط به آن نشانی استفاده کنید.

نمونه

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%2BParkway%2C%20Mountain%20View%2C%20CA%2094043&key=YOUR_API_KEY

حتماً فراخوانی Geocoding API را کدبندی نشانی وب کنید.

مرجع سریع کدبندی نشانی وب: %20 = فاصله، %2B = + (به‌علاوه)، %2C = , (کاما)

درخواست اجازه از کاربر برای دریافت مکان دستگاه او

برای دریافت مکان دستگاه کاربر، باید از کاربر درخواست کنید اجازه دهد خدمات مکان فعال شود. بااستفاده از راهنمایی‌های موجود در سند Android درباره ساختن برنامه‌های آگاه از مکان، جریان زیر را پیاده‌سازی کنید:

  • درخواست اجازه مکان، به‌صورت اعطای یک‌باره، در سطح دقیق (ACCESS_FINE_LOCATION).

  • اگر کاربر دسترسی به مکان را اعطا کرد، مکان کاربر را دریافت کنید.

  • اگر کاربر دسترسی به مکان را رد کرد، این رد کردن را به‌درستی مدیریت کنید. برای مثال، می‌توانید نوع پیام زیر را ارائه دهید (با فرض اینکه مکان فعلی کاربر را ذخیره نمی‌کنید):

    «اگر به برنامه اجازه ندهید مکان دقیق شما را بداند، باید ازطریق پست درستی‌سنجی کنید تا حسابتان فعال شود. [OK]»

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

برای بررسی اجازه مکان، راه‌انداز فعالیتی آماده کنید که منتظر نتیجه فعالیت راه‌اندازی‌شده با ActivityResultLauncher باشد. فراخوانی برگشتی نتیجه حاوی رشته‌ای خواهد بود که نشان می‌دهد کاربر اجازه درخواست‌شده را اعطا یا رد کرده است.

    // Register the permissions callback, which handles the user's response to the
    // system permissions dialog. Save the return value, an instance of
    // ActivityResultLauncher, as an instance variable.
    private final ActivityResultLauncher<String> requestPermissionLauncher =
            registerForActivityResult(
                    new ActivityResultContracts.RequestPermission(),
                    isGranted -> {
                        if (isGranted) {
                            // Since ACCESS_FINE_LOCATION is the only permission in this sample,
                            // run the location comparison task once permission is granted.
                            // Otherwise, check which permission is granted.
                            getAndCompareLocations();
                        } else {
                            // Fallback behavior if user denies permission
                            Log.d(TAG, "User denied permission");
                        }
                    });

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

    private void checkLocationPermissions() {
        if (ContextCompat.checkSelfPermission(this, ACCESS_FINE_LOCATION)
                == PackageManager.PERMISSION_GRANTED) {
            getAndCompareLocations();
        } else {
            requestPermissionLauncher.launch(ACCESS_FINE_LOCATION);
        }
    }

پس‌از اعطای اجازه ACCESS_FINE_LOCATION، از ارائه‌دهنده تلفیقی مکان برای دریافت آخرین مکان شناخته‌شده دستگاه استفاده کنید و شیء LatLng را از آن ایجاد کنید.

        FusedLocationProviderClient fusedLocationClient =
                LocationServices.getFusedLocationProviderClient(this);

        fusedLocationClient
                .getLastLocation()
                .addOnSuccessListener(
                        this,
                        location -> {
                            // Got last known location. In some rare situations this can be null.
                            if (location == null) {
                                return;
                            }

                            deviceLocation =
                                    new LatLng(location.getLatitude(), location.getLongitude());
                            // ...
                        });
    }

محاسبه فاصله بین نشانی واردشده و مکان دستگاه

استفاده از ریاضی برای محاسبه فاصله بین دو مختصات طول و عرض جغرافیایی (نشانی واردشده و مکان دستگاه). کیت توسعه نرم‌افزار متن‌باز Maps ویژه کتابخانه کاروری‌های Android چند روش مفید برای محاسبه فاصله کروی بین دو نقطه روی زمین دارد.

ابتدا، «کتابخانه کاروری‌های کیت توسعه نرم‌افزار Maps ویژه Android» را با افزودن وابستگی زیر به فایل 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(libs.android.maps.utils)
}

سپس، پس‌از دریافت آخرین مکان شناخته‌شده دستگاه، به فایل فعالیت برگردید، شعاعی را برحسب متر تعریف کنید تا دو مکان به‌عنوان «مطابقت‌یافته» درنظر گرفته شوند. شعاع باید به‌اندازه کافی بزرگ باشد تا تغییرپذیری در دقت GPS و اندازه مکان در نشانی واردشده کاربر را دربرگیرد. برای مثال:

private static final double acceptableProximity = 150;

سپس، از روش کتابخانه کمکی computeDistanceBetween() برای محاسبه فاصله بین مکان دستگاه و مکان نشانی واردشده توسط کاربر استفاده کنید. اگر فاصله در شعاع تعریف‌شده در بالا قرار می‌گیرد، مکان‌ها را منطبق درنظر بگیرید.

// Use the computeDistanceBetween function in the Maps SDK for Android
// Utility Library
// to use spherical geometry to compute the distance between two Lat/Lng
// points.
double distanceInMeters =
        computeDistanceBetween(deviceLocation, enteredLocation);
if (distanceInMeters <= acceptedProximity) {
    Log.d(TAG, "location matched");
    // TODO: Display UI based on the locations matching
} else {
    Log.d(TAG, "location not matched");
    // TODO: Display UI based on the locations not matching
}

(مشاهده نمونه کد کامل)

اگر نشانی و مکان مطابقت داشته باشند، تأییدیه‌ای در برنامه نمایش داده می‌شود، همان‌طور که در شکل زیر نشان داده شده است.

نکاتی برای بهبود بیشتر «ثبت‌نام سریع و تأییدشده»

به کاربران اجازه دهید نشانی را براساس نام کسب‌وکار یا مکان جالب وارد کنند. سرویس پیش‌بینی «تایپ پیش‌نگر» نه‌تنها برای نشانی‌ها کار می‌کند، بلکه می‌توانید به کاربران اجازه دهید نام کسب‌وکارها یا نشان‌های جغرافیایی را وارد کنند. برای اینکه هم نشانی‌ها و هم نام‌های مؤسسه وارد شوند، ویژگی types را از تعریف «تکمیل خودکار» بردارید.

ظاهر و حس‌وحال چارگوش «تکمیل خودکار جا» را سفارشی‌سازی کنید تا با سبک وب‌سایت شما مطابقت داشته باشد. اگر ترجیح می‌دهید به‌جای استفاده از ابزاره Google، ظاهر و حس «تکمیل خودکار جا» را در برنامه‌تان کنترل کنید، می‌توانید از تکمیل خودکار جا به‌صورت برنامه‌نویسی‌شده برای تقویت واسط کاربری‌ای که با سرویس «تکمیل خودکار جا» می‌سازید استفاده کنید.