Tổng quan
Google Maps Platform có sẵn cho web (JS, TS), Android và iOS, đồng thời cung cấp các API dịch vụ web để lấy 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 các đường liên kết đến tài liệu được cung cấp để triển khai trên các nền tảng khác.
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 giao diện người dùng tương tác, giúp 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ố, nơi mà 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 dịch vụ nào đó, chẳng hạn như thẻ tín dụng, tài khoản ngân hàng hoặc khoản vay, họ mong đợi quy trình đăng ký sẽ nhanh chóng và dễ dàng.
Người dùng càng phải nhập nhiều 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 ra 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 có lợi thế trong việc giữ chân người dùng trên trang web của mình.
Địa chỉ được nhập thủ công có thể dẫn đến việc giảm số lượt chuyển đổi, dữ liệu CRM bị sai sót và lỗi giao hàng 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 các địa chỉ lân cận chỉ bằng vài lần 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 yên tâm rằng họ đã nhập đúng địa chỉ. Xác minh địa chỉ của người dùng bằng vị trí hiện tại của họ cũng giúp ngăn chặn hành vi gian lận và củng cố lòng 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 yên tâm hơn khi cung cấp thẻ tín dụng và thẻ ngân hàng ảo ngay lập tức.
Tài liệu 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 Google Maps Platform. 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 tài liệu này đều tập trung vào Android. Để xem ví dụ hoàn chỉnh, hãy xem mã nguồn mẫu. Bạn cũng có thể sử dụng SDK iOS để đạt được các mục tiêu 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 những đề xuất này, bạn phải bật các API sau trong Google Cloud Console:
- Maps SDK cho Android (hoặc API cho nền tảng bạn chọn)
- Places API
- Geocoding API
Để 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 Google Maps Platform.
Các phần về phương pháp hay nhất
Tài liệu này trình bày các phương pháp và hoạt động tuỳ chỉnh sau đâ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 chế độ 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 dữ liệu | Tự động điền biểu mẫu địa chỉ. Thêm chức năng nhập địa chỉ nhanh để cải thiện trải nghiệm người dùng trên mọi nền tảng và tăng độ chính xác của địa chỉ với số lần nhấn phím tối thiểu. | |
| Cung cấp bằng chứng xác nhận địa chỉ bằng hình ảnh | Cho phép người dùng xem địa chỉ của họ trên bản đồ dưới dạng xác nhận trực quan 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í hiện tại của thiết bị để giúp 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 để nâng cao hơn nữa tính năng Đăng ký nhanh và đã xác minh | Bạn có thể cải thiện hơn nữa việc 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 dữ liệu
| Ví dụ này sử dụng: SDK Địa điểm cho Android | Cũng có sẵn: iOS | JavaScript |
Place Autocomplete có thể đơn giản hoá việc nhập địa chỉ trong ứng dụng của bạn, dẫn đến tỷ lệ chuyển đổi cao hơn và 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ý. Bằng cách kết 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 nhập Tự động hoàn thành và bắt đầu nhập, danh sách các cụm từ gợi ý về địa chỉ sẽ xuất hiện.
Khi người dùng chọn một địa chỉ trong danh sách gợi ý, bạn có thể sử dụng phản hồi để xác minh địa chỉ và lấy thông tin vị trí. Sau đó, ứng dụng của bạn có thể điền sẵn các trường chính xác của biểu mẫu nhập địa chỉ, như minh hoạ trong hình sau.
Video: Cải thiện 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
Google Maps Platform cung cấp một tiện ích Place Autocomplete cho các nền tảng di động và web. Tiện ích (như trong các hình trước) cung cấp một hộp thoại tìm kiếm có chức năng tự động hoàn thành tích hợp sẵn mà bạn thậm chí có thể tối ưu hoá cho tính năng tìm kiếm theo phạm vi vị trí.
Phần này mô tả cách triển khai tính năng Tự động hoàn thành địa điểm cho quy trình Đăng ký nhanh và đã xác minh.
Thêm tiện ích Place Autocomplete
Trong Android, bạn có thể thêm tiện ích tự động hoàn thành bằng cách sử dụng một Autocomplete intent (Ý định tự động hoàn thành) sẽ khởi chạy tính năng Place Autocomplete từ trường nhập dữ liệu 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, trẻ sẽ có thể chọn địa chỉ của mình trong danh sách cụm từ gợi ý của tính năng tự động hoàn thành.
Trước tiên, hãy chuẩn bị một trình chạy hoạt động bằng cách sử dụng ActivityResultLauncher để lắng nghe 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 Place tương ứng với địa chỉ mà người dùng chọn trong các đề xuất 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 Place Autocomplete 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.LOCATION, Place.Field.VIEWPORT); // Build the autocomplete intent with field, country, and type filters applied Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.OVERLAY, fields) .setCountries(List.of("US")) // IMPORTANT: the widget uses the legacy api .setTypesFilter(List.of(PlaceTypes.ADDRESS)) .build(this); startAutocomplete.launch(intent); }
Xử lý địa chỉ do Place Autocomplete 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 cụm từ gợi ý, thì cụm từ đó sẽ được phân phối theo ý đị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ừ đó.
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ại đó, hãy gọi Place.getAddressComponents() và so khớp từng thành phần địa chỉ với trường nhập dữ liệu 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ỉ do người dùng nhập theo cách thủ công giúp đảm bảo tính chính xác của địa chỉ, đảm bảo rằng địa chỉ đã biết và có thể giao hàng đế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 Place Autocomplete
Place Autocomplete có một số tùy chọn cho phép bạn linh hoạt triển khai nếu muốn sử dụng nhiều hơn chỉ một tiện ích. Bạn có thể sử dụng kết hợp các dịch vụ để nhận được chính xác thông tin bạn cần nhằm so khớp một vị trí theo cách chính xác.
Đối với biểu mẫu ĐỊA CHỈ, hãy đặt tham số types thành
addressđể giới hạn các kết quả trùng khớp thành địa chỉ đường phố đầy đủ. Tìm hiểu thêm về các loại được hỗ trợ trong yêu cầu của tính năng Place Autocomplete.Đặt các quy tắc hạn chế 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ố tham số có thể dùng để thiên vị hoặc hạn chế kết quả trùng khớp chỉ cho một số khu vực cụ thể.
Dùng
RectangularBoundsđể đặt giới hạn hình chữ nhật nhằm hạn chế một khu vực, dùngsetLocationRestriction()để đảm bảo chỉ các địa chỉ trong những khu vực đó được trả về.Sử dụng
setCountries()để hạn chế phản hồi cho một nhóm quốc gia nhất định.
Cho phép chỉnh sửa các trường trong trường hợp một số trường không khớp, và 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 Place Autocomplete trả về không chứa số địa điểm phụ, chẳng hạn 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: Maps SDK cho Android | Cũng có trên: 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 trực quan về địa chỉ trên bản đồ. Điều này giúp người dùng yên tâm hơn rằng địa chỉ là chính xác.
Hình ả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 minh hoạ các bước cơ bản để thêm bản đồ vào Android. Hãy tham khảo tài liệu để biết thêm chi tiết.
- Thêm
SupportMapFragment(trong trường hợp này là thêm một mảnh theo cách linh động) - Lấy tên người dùng cho mảnh và đăng ký lệnh gọi lại
- Tạo kiểu và thêm điểm đánh dấu vào bản đồ
- Tắt các chế độ điều khiển bản đồ
Đang 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.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);
}
}Lấy một đối tượng xử lý đến phân mảnh và đăng ký lệnh gọi lại
Để lấy tên người dùng cho mảnh, hãy gọi phương thức
FragmentManager.findFragmentByIdvà truyền mã tài nguyên của mảnh vào tệp bố cục. Nếu bạn đã thêm mảnh một cách linh hoạt, hãy bỏ qua bước này vì bạn đã truy xuất được giá trị nhận dạng.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 theo 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);
Tạo kiểu và thêm điểm đánh dấu vào bản đồ
Khi bản đồ đã sẵn sàng, hãy đặt kiểu, căn giữa camera và thêm một điểm đánh dấu tại toạ độ của địa chỉ đã nhập. Đoạn mã sau đây sử dụng kiểu được xác định trong một đối tượng JSON hoặc bạn có thể tải một 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)); }
Tắt các nút điều khiển bản đồ
Để giữ cho bản đồ gọn gàng bằng cách hiển thị vị trí mà không có các chế độ điều khiển bản đồ bổ sung như la bàn hoặc thanh công cụ, hãy cân nhắc tắt các chế độ điều khiển mà bạn không cần. Trên Android, một lựa chọn khác là bật chế độ thu gọn để cung cấp khả năng tương tác hạn chế.
So sánh địa chỉ do người dùng nhập với vị trí thiết bị
Việc lấy giấy tờ chứng minh địa chỉ (để đảm bảo rằng người dùng đang ở địa chỉ mà họ đã nhập) có thể gặp khó khăn do các yếu tố như vị trí của người dùng ở xa, người dùng chuyển đến địa chỉ mới hoặ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ế để người dùng có thể đến và cung cấp giấy tờ chứng minh địa chỉ bằng hoá đơn dịch vụ tiện ích hoặc giấy tờ khác. Việc cung cấp các phương thức kỹ thuật số để xác minh địa chỉ người dùng giúp bạn mang đến trải nghiệm đăng ký nhanh hơn và mượt mà hơn.
Bảo mật là yếu tố tối quan trọng trong việc xác minh địa chỉ, đặc biệt là trong quy trình đăng ký kỹ thuật số. 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àm địa chỉ của mình 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:
- Chuyển đổi địa chỉ do người dùng nhập thành toạ độ địa lý.
- Nhắc người dùng cấp quyền để lấy thông tin vị trí của thiết bị.
- Tính khoảng cách giữa địa chỉ đã nhập và vị trí của 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 cho Android | Cũng có sẵn: iOS | JavaScript | Geocoding API |
Sau khi người dùng đồng ý xác minh địa chỉ (bằng cách nhấn vào "Xác minh rằng 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 Place Autocomplete, hãy nhớ yêu cầu Place.Field.LAT_LNG trong danh sách trường Place Autocomplete như trong đoạn mã Thêm tiện ích Place Autocomplete 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 Place Autocomplete điền các trường, hãy sử dụng dịch vụ Android Geocoder hoặc Geocoding API để tra cứu toạ độ 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 cho lệnh gọi đến Geocoding API.
Thông tin tham khảo nhanh về việc 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ị
Để lấy thông tin vị trí thiết bị của người dùng, bạn cần yêu cầu người dùng cấp sự cho phép của người dùng để 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 vị trí một lần, ở mức chính xác (
ACCESS_FINE_LOCATION).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ý việc từ chối một cách linh hoạt. 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 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 minh hoạ một ví dụ về lời nhắc để người dùng cho phép quyền truy cập nhằm lấy thông tin vị trí của thiết bị.
Để kiểm tra quyền truy cập vị trí, hãy chuẩn bị một trình chạy hoạt động sẽ lắng nghe kết quả từ hoạt động được chạy bằng ActivityResultLauncher.
Lệnh gọi lại kết quả sẽ chứa một chuỗi cho biết liệu 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 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ừ thông tin đó.
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ị
Dùng toán học để tính khoảng cách giữa hai toạ độ vĩ độ và kinh độ (địa chỉ đã nhập và vị trí thiết bị). Thư viện tiện ích Maps SDK dành cho Android mã 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 Maps SDK cho Thư viện tiện ích 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(libs.android.maps.utils) }
Sau đó, trong tệp hoạt động sau khi nhận được vị trí thiết bị đã biết gần đây nhất, hãy xác định bán kính tính bằng mét để coi 2 vị trí là "trùng khớp". Bán kính phải đủ lớn để tính đến sự biến thiên 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ỉ mà 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í phù hợ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 }
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ư minh hoạ trong hình sau.
Mẹo để cải thiện hơn nữa tính năng Đăng ký nhanh và đã xác minh
Cho phép người dùng nhập địa chỉ dựa trên tên doanh nghiệp hoặc địa điểm yêu thích. Dịch vụ dự đoán "nhập trước" không chỉ hoạt động cho đị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ở, 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 Place Autocomplete cho phù hợp với kiểu trang web của bạn. Nếu muốn kiểm soát giao diện của tính năng Place Autocomplete trong ứng dụng thay vì sử dụng tiện ích của Google, bạn có thể sử dụng Place Autocomplete theo phương thức lập trình để hỗ trợ giao diện người dùng mà bạn xây dựng bằng dịch vụ Place Autocomplete.