Hiển thị các địa điểm gần đây trên bản đồ trong một flow

Làm theo hướng dẫn này để tích hợp bản đồ tương tác vào một flow. Bản đồ hiển thị các địa điểm của bạn, chẳng hạn như các trung tâm thể dục đối tác, trong phạm vi 2 km tính từ vị trí người dùng. Ứng dụng của bạn render bản đồ dưới dạng native view trong một phần tử tùy chỉnh, sử dụng MapLibre. Ứng dụng sẽ yêu cầu quyền truy cập vị trí ngay trên màn hình flow.

Trước khi bắt đầu

  • Cập nhật ứng dụng lên Adapty Android SDK 4.4 trở lên. Các phiên bản SDK cũ hơn sẽ hiển thị nội dung dự phòng cho mọi phần tử tùy chỉnh.
  • Thiết lập ứng dụng để lấy và hiển thị flow.
  • Để yêu cầu người dùng cấp quyền truy cập vị trí, hãy hiển thị flow trong một activity kế thừa từ ComponentActivity, chẳng hạn như AppCompatActivity.
  • Thêm MapLibre vào ứng dụng bằng Gradle, từ org.maplibre.gl:android-sdk-opengl. Với artifact này, Google Play cũng cung cấp ứng dụng của bạn cho các thiết bị không có Vulkan — đây là yêu cầu của artifact android-sdk mặc định.
  • Đặt minSdk ở mức 23 hoặc cao hơn, vì MapLibre yêu cầu như vậy.

Để giới hạn ứng dụng chỉ sử dụng vị trí gần đúng, hãy thêm đoạn sau vào bên trong phần tử <manifest> của AndroidManifest.xml. Đảm bảo rằng phần tử <manifest> đã khai báo xmlns:tools="http://schemas.android.com/tools".

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- removes precise location, which MapLibre declares -->
<uses-permission
    android:name="android.permission.ACCESS_FINE_LOCATION"
    tools:node="remove" />

1. Thêm phần tử tùy chỉnh vào màn hình

Trong Flow & Paywall Builder, thêm một phần tử tùy chỉnh vào màn hình flow và cấu hình cho bản đồ:

  • Type: map.
  • ID: fitness_centers.
  • Height: Giữ nguyên chiều cao mặc định Fixed. Bản đồ sẽ lấp đầy phần tử tùy chỉnh.

Đặt phần tử tùy chỉnh ngoài các container phản hồi thao tác chạm, chẳng hạn như carousel, để chỉ bản đồ phản hồi khi người dùng kéo trên nó.

Bên trong phần tử tùy chỉnh, thêm một Image với hình ảnh bản đồ. Người dùng sẽ thấy ảnh này như là nội dung dự phòng khi:

  • Phiên bản ứng dụng của họ không hiển thị được bản đồ.
  • Họ đã từ chối quyền truy cập vị trí trước khi màn hình mở ra.

Nếu người dùng chưa trả lời lời nhắc quyền truy cập vị trí, ứng dụng sẽ hiển thị lời nhắc đó khi bản đồ xuất hiện. Để cho người dùng biết tại sao ứng dụng cần vị trí của họ, hãy thêm một phần tử văn bản phía trên phần tử tùy chỉnh, ví dụ: “Tìm trung tâm thể dục gần bạn.”

2. Tạo map view

Tạo một kiểu dữ liệu cho các địa điểm của bạn và một model để truy cập vị trí:

Tạo một view với bản đồ. View này yêu cầu quyền truy cập vị trí và hiển thị một marker cho mỗi địa điểm của bạn trong phạm vi 2 km tính từ người dùng:

Nếu người dùng từ chối quyền truy cập vị trí trên màn hình, chế độ xem sẽ thay thế bản đồ bằng thông báo hướng dẫn cách cho phép truy cập trong Settings.

3. Khớp map với custom element

Trong resolver toàn app của bạn, hãy thêm các thuộc tính cho model LocationAccess và các địa điểm của bạn. Sau đó trả về map view cho Type map và ID fitness_centers. Các dòng được highlight cho thấy những gì cần thêm hoặc thay đổi. Nếu app của bạn chưa có resolver toàn app, hãy copy toàn bộ code:

SDK gọi resolver khi màn hình mở, và gọi lại mỗi khi vẽ lại phần tử tùy chỉnh trong khi màn hình đang mở. Quyền truy cập vị trí xác định những gì resolver trả về trong mỗi lần gọi:

  • Chưa trả lời: Chế độ xem bản đồ, để chế độ xem có thể yêu cầu quyền truy cập.
  • Đã cho phép: Chế độ xem bản đồ, hiển thị các địa điểm của bạn gần người dùng.
  • Đã từ chối trước khi màn hình mở: Không có chế độ xem, nên người dùng thấy fallback thay vì thông báo về Settings.
  • Đã từ chối trên màn hình: Chế độ xem bản đồ, vì chế độ xem đặt isMapOnScreen trong khi nó đang hiển thị. Nếu resolver không trả về chế độ xem ở đây, SDK sẽ thay thế thông báo về Settings bằng fallback ở lần gọi tiếp theo.

Tạo resolver với các phần tử của bạn, rồi đặt nó làm resolver toàn ứng dụng. Gọi AdaptyUI.setCustomElementsResolver một lần duy nhất, chẳng hạn khi khởi động ứng dụng:

4. Kiểm thử trên thiết bị

Flow & Paywall Builder không thể chạy mã ứng dụng của bạn, vì vậy canvas chỉ hiển thị fallback. Để xem trước bản đồ:

  1. Xuất bản flow. Để xem phiên bản đã xuất bản mới nhất thay vì phiên bản được lưu trong bộ nhớ đệm, hãy đăng ký thiết bị làm thiết bị kiểm thử.
  2. Để xem một điểm đánh dấu trên bản đồ, hãy thêm một địa điểm trong phạm vi 2 km so với vị trí của bạn vào danh sách địa điểm.
  3. Chạy bản build ứng dụng có bao gồm resolver. Mở màn hình và cho phép truy cập vị trí. Xác minh rằng bản đồ hiển thị vị trí của bạn và điểm đánh dấu cho địa điểm bạn đã thêm.

Để kiểm tra fallback, trong ứng dụng Settings, hãy tắt quyền truy cập vị trí cho ứng dụng của bạn. Mở màn hình, và nếu có hộp thoại xuất hiện, hãy từ chối quyền truy cập vị trí. Chế độ xem bản đồ sẽ hiển thị thông báo về Settings. Mở lại màn hình và kiểm tra xem paywall dự phòng có xuất hiện không.

Để tìm hiểu lý do tại sao paywall dự phòng hiển thị thay vì bản đồ, hãy làm theo hướng dẫn trong phần Kiểm tra trên thiết bị của hướng dẫn Android.