Hướng dẫn triển khai quy trình Đăng ký nhanh & đã xác minh

Tổng quan

web iOS API

Nền tảng Google Maps có sẵn cho web (JS, TS), Android và iOS, đồng thời cũng cung cấp các API dịch vụ web để nhận thông tin về địa điểm, đường đi và khoảng cách. Các mẫu trong hướng dẫn này được viết cho một nền tảng, nhưng chúng tôi cung cấp đường liên kết đến tài liệu để triển khai trên các nền tảng khác.

Tạo ngay!

Trình tạo nhanh trong Google Cloud Console cho phép bạn tạo tính năng tự động hoàn thành biểu mẫu địa chỉ bằng một giao diện người dùng tương tác tạo mã JavaScript cho bạn.

Người dùng đã quen với việc sống và hoạt động trong một thế giới kỹ thuật số, trong đó sự tiện lợi, tốc độ và bảo mật là những kỳ vọng cơ bản. Khi đăng ký một sản phẩm như thẻ tín dụng, tài khoản ngân hàng hoặc khoản vay, họ muốn quy trình này diễn ra nhanh chóng và dễ dàng.

Càng nhiều người dùng phải nhập hoặc nhập dữ liệu trùng lặp, thì bạn càng ít có cơ hội giữ chân họ làm khách hàng. Việc tạo trải nghiệm đăng ký nhanh chóng, dễ dàng và được xác minh sẽ cải thiện trải nghiệm người dùng, đồng thời giúp bạn giữ chân người dùng trên trang web của mình.

Việc nhập địa chỉ theo cách thủ công có thể dẫn đến giảm số lượt chuyển đổi, dữ liệu CRM không chính xác và các lỗi phân phối tốn kém. Tính năng Đăng ký nhanh và xác minh giúp quá trình đăng ký diễn ra nhanh hơn, đề xuất ngay địa chỉ lân cận chỉ bằng vài thao tác nhấn và hiển thị địa chỉ đã nhập để xác nhận bằng hình ảnh, giúp người dùng tự tin rằng họ đã nhập đúng địa chỉ. Việc xác minh địa chỉ của người dùng bằng vị trí hiện tại cũng giúp ngăn chặn hành vi gian lận và củng cố niềm tin của người dùng đối với sản phẩm và dịch vụ của bạn. Quy trình xác minh cũng có thể giúp bạn tự tin hơn khi cung cấp thẻ tín dụng và thẻ ngân hàng ảo ngay lập tức.

Chủ đề này cung cấp hướng dẫn triển khai để xây dựng trải nghiệm Đăng ký nhanh và được xác minh bằng Nền tảng Google Maps. Vì người dùng có nhiều khả năng sẽ đăng ký trên thiết bị di động, nên hầu hết các ví dụ về cách triển khai trong chủ đề này đều tập trung vào Android. (Bạn có thể xem nguồn mẫu đầy đủ tại đây). Bạn cũng có thể sử dụng SDK iOS để thực hiện những việc tương tự.

Sơ đồ sau đây cho thấy các API cốt lõi liên quan đến việc xây dựng giải pháp (nhấp để phóng to).

Bật API

Để triển khai các đề xuất này, bạn phải bật các API sau trong Google Cloud Console:

Để biết thêm thông tin về cách thiết lập, hãy xem bài viết Bắt đầu sử dụng Nền tảng Google Maps.

Các phần về phương pháp hay nhất

Sau đây là các phương pháp và tuỳ chỉnh mà chúng ta sẽ đề cập trong chủ đề này.

  • Biểu tượng dấu kiểm là một phương pháp hay nhất cốt lõi.
  • Biểu tượng ngôi sao là một tuỳ chỉnh không bắt buộc nhưng nên dùng để nâng cao giải pháp.
Thêm tính năng tự động hoàn thành vào các trường nhập Tự động điền biểu mẫu địa chỉ. Thêm chức năng nhập khi di chuyển để cải thiện trải nghiệm người dùng trên tất cả các nền tảng và cải thiện độ chính xác của địa chỉ với số lần nhấn phím tối thiểu.
Cung cấp hình ảnh xác nhận địa chỉ Cho phép người dùng xem địa chỉ của họ trên bản đồ để xác nhận bằng hình ảnh rằng họ đã nhập đúng địa chỉ.
So sánh địa chỉ do người dùng nhập với vị trí thiết bị So sánh địa chỉ mà người dùng đã chọn hoặc nhập với vị trí thiết bị hiện tại của họ để xác định rằng họ đang ở địa chỉ đã chỉ định. (Để tính năng này hoạt động, người dùng phải ở nhà khi đăng ký.)
Mẹo cải thiện tính năng Đăng ký nhanh và xác minh Bạn có thể nâng cao hơn nữa tính năng nhập địa chỉ bằng các tính năng bổ sung như tuỳ chỉnh giao diện của tiện ích Tự động hoàn thành hoặc cho phép người dùng chọn tên của một doanh nghiệp hoặc địa danh làm địa chỉ.

Thêm tính năng tự động hoàn thành vào các trường nhập

Ví dụ này sử dụng: SDK Địa điểm dành cho Android Cũng có: iOS | JavaScript

Tính năng Tự động hoàn thành địa điểm có thể đơn giản hoá việc nhập địa chỉ trong ứng dụng, giúp tăng tỷ lệ chuyển đổi và mang lại trải nghiệm liền mạch cho khách hàng. Tính năng Tự động hoàn thành cung cấp một trường nhập nhanh duy nhất có tính năng dự đoán địa chỉ "nhập trước" có thể dùng để tự động điền vào biểu mẫu địa chỉ đăng ký. Khi tích hợp tính năng Tự động hoàn thành địa điểm vào quy trình đăng ký, bạn có thể:

  • Giảm lỗi nhập địa chỉ.
  • Giảm số bước trong quy trình đăng ký.
  • Đơn giản hoá trải nghiệm nhập địa chỉ trên thiết bị di động hoặc thiết bị đeo.
  • Giảm đáng kể số lần nhấn phím và tổng thời gian cần thiết để khách hàng đăng ký.

Khi người dùng chọn hộp mục nhập Tự động hoàn thành và bắt đầu nhập, danh sách các địa chỉ được gợi ý sẽ xuất hiện.

Khi người dùng chọn một địa chỉ trong danh sách dự đoán, bạn có thể sử dụng phản hồi để xác minh địa chỉ và lấy vị trí. Sau đó, ứng dụng của bạn có thể điền chính xác các trường của biểu mẫu nhập địa chỉ, như minh hoạ trong hình sau.

Video: Nâng cao biểu mẫu địa chỉ bằng tính năng Tự động hoàn thành địa điểm

Biểu mẫu địa chỉ

Android

iOS

Web

Nền tảng Google Maps cung cấp tiện ích Tự động hoàn thành địa điểm cho các nền tảng di động và web. Tiện ích hiển thị trong các hình trước cung cấp hộp thoại tìm kiếm có chức năng tự động hoàn thành tích hợp. Bạn thậm chí có thể tối ưu hoá tiện ích này cho nội dung tìm kiếm theo phạm vi địa điểm.

Phần này mô tả cách triển khai tính năng Tự động điền địa điểm cho quy trình Đăng ký nhanh và được xác minh.

Thêm tiện ích Tự động hoàn thành địa điểm

Trong Android, bạn có thể thêm tiện ích tự động hoàn thành bằng cách sử dụng ý định Tự động hoàn thành để chạy tính năng Tự động hoàn thành địa điểm từ trường nhập Address Line 1 (Dòng địa chỉ 1), nơi người dùng sẽ bắt đầu nhập địa chỉ của họ. Khi bắt đầu nhập, họ sẽ có thể chọn địa chỉ của mình trong danh sách nội dung dự đoán của tính năng Tự động hoàn thành.

Trước tiên, hãy chuẩn bị trình chạy hoạt động bằng cách sử dụng ActivityResultLauncher. Trình chạy này sẽ nhận kết quả từ hoạt động đã chạy. Lệnh gọi lại kết quả sẽ chứa một đối tượng Địa điểm tương ứng với địa chỉ mà người dùng chọn trong kết quả dự đoán của tính năng Tự động hoàn thành.

    private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult(
            new ActivityResultContracts.StartActivityForResult(),
            result -> {
                if (result.getResultCode() == Activity.RESULT_OK) {
                    Intent intent = result.getData();
                    if (intent != null) {
                        Place place = Autocomplete.getPlaceFromIntent(intent);

                        // 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);
                    }
                } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                    // The user canceled the operation.
                    Log.i(TAG, "User canceled autocomplete");
                }
            });

Tiếp theo, hãy xác định các trường, vị trí và thuộc tính loại của ý định Tự động hoàn thành địa điểm rồi tạo ý định đó bằng Autocomplete.IntentBuilder. Cuối cùng, hãy chạy ý định bằng cách sử dụng ActivityResultLauncher được xác định trong mã mẫu trước.

    private void startAutocompleteIntent() {

        // Set the fields to specify which types of place data to
        // return after the user has made a selection.
        List<Place.Field> fields = Arrays.asList(Place.Field.ADDRESS_COMPONENTS,
                Place.Field.LAT_LNG, Place.Field.VIEWPORT);

        // Build the autocomplete intent with field, country, and type filters applied
        Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.OVERLAY, fields)
                .setCountries(Arrays.asList("US"))
                .setTypesFilter(new ArrayList<String>() {{
                    add(TypeFilter.ADDRESS.toString().toLowerCase());
                }})
                .build(this);
        startAutocomplete.launch(intent);
    }

Xử lý địa chỉ do tính năng Tự động hoàn thành địa điểm trả về

Việc xác định ActivityResultLauncher trước đó cũng xác định những việc cần làm khi kết quả hoạt động được trả về trong lệnh gọi lại. Nếu người dùng chọn một nội dung dự đoán, thì nội dung đó sẽ được phân phối trong ý định có trong đối tượng kết quả. Vì ý định được tạo bởi Autocomplete.IntentBuilder, nên phương thức Autocomplete.getPlaceFromIntent() có thể trích xuất đối tượng Địa điểm từ ý định đó.

    private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult(
            new ActivityResultContracts.StartActivityForResult(),
            result -> {
                if (result.getResultCode() == Activity.RESULT_OK) {
                    Intent intent = result.getData();
                    if (intent != null) {
                        Place place = Autocomplete.getPlaceFromIntent(intent);

                        // 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);
                    }
                } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                    // The user canceled the operation.
                    Log.i(TAG, "User canceled autocomplete");
                }
            });

Từ đó, hãy gọi Place.getAddressComponents() và so khớp từng thành phần địa chỉ với trường nhập tương ứng trong biểu mẫu địa chỉ, điền giá trị từ Địa điểm mà người dùng đã chọn vào trường.

Việc thu thập dữ liệu địa chỉ từ thông tin dự đoán thay vì địa chỉ được nhập theo cách thủ công giúp đảm bảo địa chỉ chính xác, đảm bảo địa chỉ được biết và có thể giao đến, đồng thời giảm số lần nhấn phím của người dùng.

Những điều cần cân nhắc khi triển khai tính năng Tự động hoàn thành địa điểm

Tính năng Tự động hoàn thành địa điểm có một số tuỳ chọn cho phép linh hoạt trong việc triển khai nếu bạn muốn sử dụng nhiều tiện ích hơn. Bạn có thể sử dụng kết hợp các dịch vụ để nhận được chính xác những gì bạn cần để so khớp một vị trí theo cách chính xác.

  • Đối với biểu mẫu ADDRESS, hãy đặt tham số types thành address để giới hạn các kết quả trùng khớp ở địa chỉ đường phố đầy đủ. Tìm hiểu thêm về các loại được hỗ trợ trong yêu cầu Tự động hoàn thành địa điểm.

  • Đặt các giới hạn và thiên vị phù hợp nếu bạn không cần tìm kiếm trên toàn thế giới. Có một số thông số có thể được dùng để thiên vị hoặc hạn chế mọi kết quả trùng khớp chỉ ở một số khu vực cụ thể.

    • Sử dụng RectangularBounds để đặt các giới hạn hình chữ nhật để ràng buộc cho một khu vực, sử dụng setLocationRestriction() để đảm bảo chỉ trả về các địa chỉ trong những khu vực đó.

    • Sử dụng setCountries() để hạn chế phản hồi ở một số quốc gia nhất định.

  • Để các trường có thể chỉnh sửa trong trường hợp một số trường nhất định bị thiếu trong kết quả so khớp, đồng thời cho phép khách hàng cập nhật địa chỉ nếu cần. Vì hầu hết địa chỉ do tính năng Tự động hoàn thành địa điểm trả về không chứa số nhà phụ như số căn hộ, số phòng hoặc số đơn vị, nên bạn có thể di chuyển tiêu điểm đến Dòng địa chỉ 2 để khuyến khích người dùng điền thông tin đó nếu cần.

Cung cấp hình ảnh xác nhận địa chỉ

Ví dụ này sử dụng: SDK Bản đồ dành cho Android Cũng có: iOS | JavaScript

Trong quá trình nhập địa chỉ, hãy cung cấp cho người dùng thông tin xác nhận bằng hình ảnh về địa chỉ trên bản đồ. Điều này giúp người dùng thêm phần yên tâm rằng địa chỉ là chính xác.

Hình sau đây cho thấy một bản đồ bên dưới địa chỉ có một ghim tại địa chỉ đã nhập.

Ví dụ sau đây tuân theo các bước cơ bản để thêm bản đồ trong Android. Hãy tham khảo tài liệu để biết thêm thông tin chi tiết.

Thêm SupportMapFragment

Trước tiên, hãy thêm một mảnh SupportMapFragment vào tệp XML bố cục.

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

Sau đó, hãy thêm mảnh theo phương thức lập trình nếu mảnh đó chưa tồn tại.

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

        // 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);
        }
    }

Lấy handle cho mảnh và đăng ký lệnh gọi lại

  1. Để lấy một handle cho mảnh, hãy gọi phương thức FragmentManager.findFragmentById và truyền vào đó mã nhận dạng tài nguyên của mảnh trong tệp bố cục. Nếu bạn thêm mảnh một cách linh động, hãy bỏ qua bước này vì bạn đã truy xuất tay cầm.

  2. Gọi phương thức getMapAsync để đặt lệnh gọi lại trên mảnh.

Ví dụ: nếu bạn thêm mảnh một cách tĩnh:

Kotlin



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

      

Java


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

      

Định kiểu và thêm điểm đánh dấu vào bản đồ

Khi bản đồ đã sẵn sàng, hãy thiết lập kiểu, căn giữa máy ảnh và thêm điểm đánh dấu tại các toạ độ của địa chỉ đã nhập. Mã sau đây sử dụng kiểu được xác định trong đối tượng JSON hoặc bạn có thể tải mã bản đồ đã được xác định bằng tính năng Định kiểu bản đồ dựa trên đám mây.

    @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));
    }

(Xem mã mẫu đầy đủ)

Tắt các chế độ điều khiển trên bản đồ

Để giữ cho bản đồ đơn giản bằng cách hiển thị vị trí mà không cần các chế độ điều khiển bản đồ bổ sung (chẳng hạn như la bàn, thanh công cụ hoặc các tính năng tích hợp khác), hãy cân nhắc tắt các chế độ điều khiển mà bạn thấy không cần thiết. Trên Android, bạn có thể bật chế độ lite để cung cấp khả năng tương tác bị giới hạn.

So sánh địa chỉ do người dùng nhập với vị trí của thiết bị

Việc lấy bằng chứng về địa chỉ (để chắc chắn rằng người dùng đang ở địa chỉ mà họ đã nhập) có thể gặp nhiều khó khăn do các yếu tố như vị trí từ xa của người dùng, người dùng chuyển đến địa chỉ mới hoặc các doanh nghiệp kỹ thuật số (chẳng hạn như ngân hàng kỹ thuật số) không có địa điểm thực tế mà người dùng có thể truy cập để cung cấp bằng chứng về địa chỉ bằng hoá đơn tiện ích hoặc tài liệu khác. Việc cung cấp các phương thức xác minh địa chỉ người dùng bằng phương thức kỹ thuật số giúp bạn mang đến trải nghiệm đăng ký nhanh chóng và dễ dàng hơn.

Tính bảo mật là yếu tố quan trọng nhất khi kiểm tra địa chỉ, đặc biệt là với quy trình đăng ký qua mạng. Phần này cung cấp hướng dẫn và mẫu để kiểm tra xem vị trí của người dùng trong quá trình đăng ký có khớp với địa chỉ mà họ nhập là địa chỉ của riêng họ hay không.

Quy trình so sánh địa chỉ đã nhập với vị trí thiết bị bao gồm các bước sau:

  1. Chuyển đổi địa chỉ do người dùng nhập thành toạ độ địa lý.
  2. Nhắc người dùng cấp quyền lấy thông tin vị trí của thiết bị.
  3. Tính khoảng cách giữa địa chỉ đã nhập và vị trí thiết bị. Bạn có thể xác định khoảng cách tối đa được tính cho một kết quả khớp địa chỉ-vị trí.

Hình sau đây là ví dụ về cách bạn có thể nhắc người dùng so sánh địa chỉ họ đã nhập với vị trí hiện tại của họ.

Chuyển đổi địa chỉ do người dùng nhập thành toạ độ địa lý

Ví dụ này sử dụng: SDK Địa điểm dành cho Android Cũng có: iOS | JavaScript | API Địa chỉ mã hoá địa lý

Sau khi người dùng đồng ý xác minh địa chỉ (bằng cách nhấn vào "Xác minh tôi đang ở đó" trong hình trước), bước đầu tiên để so sánh địa chỉ với vị trí hiện tại là chuyển đổi địa chỉ đã nhập thành toạ độ địa lý.

Nếu người dùng đã chọn địa chỉ của họ bằng tính năng Tự động hoàn thành địa điểm, hãy nhớ yêu cầu Place.Field.LAT_LNG trong danh sách trường Tự động hoàn thành địa điểm như minh hoạ trong đoạn mã Thêm tiện ích Tự động hoàn thành địa điểm và gọi phương thức Place.getLatLng() để lấy toạ độ địa lý của địa chỉ đã chọn.

coordinates = place.getLatLng();

Nếu người dùng nhập địa chỉ theo cách thủ công hoặc chỉnh sửa sau khi tính năng Tự động hoàn thành địa điểm điền vào các trường, hãy sử dụng dịch vụ Bộ mã hoá địa lý của Android hoặc API Mã hoá địa lý để tra cứu tọa độ tương ứng với địa chỉ đó.

Ví dụ

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

Hãy nhớ mã hoá URL lệnh gọi đến API Mã hoá địa lý.

Tài liệu tham khảo nhanh về mã hoá URL: %20 = dấu cách, %2B = + (dấu cộng), %2C = , (dấu phẩy)

Nhắc người dùng cấp quyền lấy thông tin vị trí của thiết bị

Để nhận thông tin vị trí của thiết bị của người dùng, bạn cần yêu cầu người dùng cấp quyền bật dịch vụ vị trí. Sử dụng hướng dẫn trong tài liệu Android về cách xây dựng ứng dụng nhận biết vị trí, hãy triển khai quy trình sau:

  • Yêu cầu cấp quyền truy cập thông tin vị trí ở cấp chính xác (ACCESS_FINE_LOCATION) dưới dạng quyền cấp một lần.

  • Nếu người dùng cấp quyền truy cập thông tin vị trí, hãy lấy thông tin vị trí của người dùng.

  • Nếu người dùng từ chối quyền truy cập thông tin vị trí, hãy xử lý trường hợp từ chối một cách khéo léo. Ví dụ: bạn có thể hiển thị loại thông báo sau (giả sử bạn không lưu trữ vị trí hiện tại của người dùng):

    "Nếu không cho phép ứng dụng biết thông tin vị trí chính xác của bạn, bạn sẽ cần xác minh qua thư để kích hoạt tài khoản. [OK]"

Hình sau đây cho thấy một lời nhắc mẫu để người dùng cấp quyền truy cập thông tin vị trí của thiết bị.

Để kiểm tra quyền truy cập thông tin vị trí, hãy chuẩn bị một trình chạy hoạt động sẽ nhận kết quả từ hoạt động đã khởi chạy bằng ActivityResultLauncher. Lệnh gọi lại kết quả sẽ chứa một Chuỗi cho biết người dùng đã cấp hay từ chối quyền được yêu cầu.

    // 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");
                }
            });

Sau đó, hãy kiểm tra xem ứng dụng đã có quyền ACCESS_FINE_LOCATION hay chưa. Nếu không, hãy yêu cầu người dùng cấp quyền bằng cách chạy hoạt động yêu cầu cấp quyền bằng trình chạy được xác định ở bước trước.

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

Sau khi cấp quyền ACCESS_FINE_LOCATION, hãy sử dụng trình cung cấp vị trí kết hợp để lấy thông tin vị trí xác định gần đây nhất của thiết bị và tạo đối tượng LatLng từ đó.

        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());
                    // ...
                });
    }

Tính khoảng cách giữa địa chỉ đã nhập và vị trí thiết bị

Sử dụng toán học để tính khoảng cách giữa hai toạ độ vĩ độ/kinh độ (địa chỉ đã nhập và vị trí thiết bị). Thư viện tiện ích SDK Bản đồ dành cho Android nguồn mở có một số phương thức hữu ích để tính khoảng cách hình cầu giữa hai điểm trên Trái Đất.

Trước tiên, hãy cài đặt Thư viện tiện ích SDK Bản đồ dành cho Android bằng cách thêm phần phụ thuộc sau vào tệp build.gradle.kts của ứng dụng:

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")
}

Sau đó, quay lại tệp hoạt động sau khi nhận được vị trí thiết bị được biết gần đây nhất, hãy xác định bán kính tính bằng mét để coi hai vị trí là "khớp". Bán kính phải đủ lớn để tính đến sự biến động về độ chính xác của GPS và kích thước của địa điểm tại địa chỉ mà người dùng đã nhập. Ví dụ:

private static final double acceptableProximity = 150;

Sau đó, hãy sử dụng phương thức thư viện tiện ích computeDistanceBetween() để tính khoảng cách giữa vị trí thiết bị và vị trí địa chỉ do người dùng nhập. Nếu khoảng cách nằm trong bán kính được xác định ở trên, hãy xem xét các vị trí đã so khớp.

// 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
}

(Xem mã mẫu đầy đủ)

Nếu địa chỉ và vị trí khớp nhau, hãy hiển thị thông báo xác nhận trong ứng dụng, như trong hình sau.

Mẹo nâng cao tính năng Đăng ký nhanh và được xác minh

Cho phép người dùng nhập địa chỉ dựa trên tên của một doanh nghiệp hoặc điểm yêu thích. Dịch vụ dự đoán "nhập trước" không chỉ hoạt động với địa chỉ, mà bạn cũng có thể chọn cho phép người dùng nhập tên doanh nghiệp hoặc địa danh. Để cho phép nhập cả địa chỉ và tên cơ sở lưu trú, hãy xoá thuộc tính types khỏi định nghĩa Tự động hoàn thành.

Tuỳ chỉnh giao diện của hộp Tự động hoàn thành địa điểm cho phù hợp với phong cách trang web của bạn. Nếu muốn kiểm soát giao diện của tính năng Tự động hoàn thành địa điểm trong ứng dụng thay vì sử dụng tiện ích của Google, bạn có thể sử dụng tính năng Tự động hoàn thành địa điểm theo phương thức lập trình để hỗ trợ giao diện người dùng mà bạn tạo bằng dịch vụ Tự động hoàn thành địa điểm.