Tài liệu tham khảo nhanh về SDK Maps 3D dành cho Android

SDK Maps 3D dành cho Android cho phép các ứng dụng Android hiển thị bản đồ 3D tương tác được tạo từ hình ảnh 3D của Google. Thư viện này cung cấp điểm đánh dấu, cửa sổ bật lên, hình nhiều đường, đa giác, mô hình 3D glTF, ảnh động đường đi của camera và các chế độ điều khiển cho hoạt động tương tác của người dùng và chuyển động của camera.

SDK Maps 3D dành cho Android: thông tin chính

  • Sản phẩm: SDK Maps 3D dành cho Android
  • Còn gọi là: SDK Android Maps 3D
  • Danh mục: Maps
  • Nền tảng: Android
  • Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về SDK Maps 3D dành cho Android
  • Phạm vi cung cấp theo khu vực: Có giới hạn. Phạm vi cung cấp thay đổi tuỳ theo quốc gia và khu vực; hãy xem cột Maps 3D (JavaScript, Android, iOS) trên trang phạm vi cung cấp của Google Maps Platform. (thông tin chi tiết về phạm vi bảo hiểm)

SDK Maps 3D dành cho Android: trường hợp nên sử dụng

Sử dụng SDK Maps 3D cho Android khi:

  • Bạn cần hiển thị bản đồ 3D tương tác, chân thực về các vị trí trong thế giới thực trong một ứng dụng Android.
  • Bạn cần có điểm đánh dấu, cửa sổ bật lên, hình nhiều đường, đa giác hoặc mô hình 3D glTF được đặt trên bản đồ 3D trong một ứng dụng Android.
  • Bạn cần có ảnh động camera được xác định trước (bay đến, bay xung quanh) để hướng dẫn người dùng giữa các điểm trên bản đồ 3D.
  • Bạn cần kiểm soát những thao tác di chuyển camera và thành phần điều khiển trên giao diện người dùng mà người dùng có thể sử dụng trên bản đồ 3D trong một ứng dụng Android.

Không sử dụng SDK Maps 3D dành cho Android khi:

  • Bạn đang xây dựng một ứng dụng web cần có bản đồ 3D. Thay vào đó, hãy sử dụng Maps JavaScript API.
  • Bạn đang xây dựng một ứng dụng iOS cần có bản đồ 3D. Hãy sử dụng SDK Maps 3D dành cho iOS.
  • Bạn cần có một bản đồ đường phố 2D tiêu chuẩn, sẵn sàng cho môi trường thực tế trong một ứng dụng Android (chế độ ROADMAP trong SDK này đang ở giai đoạn Thử nghiệm). Hãy sử dụng Maps SDK cho Android.

SDK Maps 3D dành cho Android: thiết lập

Các gói SDK Maps 3D chính thức dành cho Android:

  • maven: com.google.android.gms:play-services-maps3d

SDK Maps 3D dành cho Android: các lỗi thường gặp

  • Vấn đề: Nếu bạn không chỉ định chế độ bản đồ khi tải bản đồ, thì bản đồ sẽ không tải được. Cách khắc phục: Luôn đặt Map3DMode (SATELLITE, HYBRID hoặc ROADMAP) trong tệp XML bố cục (map3d:mapMode) hoặc bằng setMapMode/Map3DInitConfig. Xem /maps/documentation/maps-3d/android-sdk/map-modes.
  • Vấn đề: Trình theo dõi lượt nhấp (lượt nhấp vào bản đồ và điểm đánh dấu) không chạy trên Luồng giao diện người dùng chính, vì vậy, các bản cập nhật giao diện người dùng trực tiếp từ trình xử lý sẽ không thành công. Cách khắc phục: Chuyển sang luồng chính trước khi cập nhật giao diện người dùng, ví dụ: bằng lifecycleScope.launch(Dispatchers.Main). Xem /maps/documentation/maps-3d/android-sdk/add-a-marker.
  • Vấn đề: Trạng thái bản đồ được chia sẻ trên các thực thể Map3DView, vì vậy, điểm đánh dấu, lớp phủ và vị trí camera từ chế độ xem cũ sẽ chuyển sang chế độ xem mới. Cách khắc phục: Chỉ giữ lại một Map3DView đang hoạt động; gọi onDestroy() trên thực thể cũ và xoá điểm đánh dấu, lớp phủ theo cách thủ công, đồng thời đặt lại camera thông qua GoogleMap3D. Xem /maps/documentation/maps-3d/android-sdk/add-a-3d-map.
  • Vấn đề: Theo mặc định, khi bạn nhấn vào một địa điểm yêu thích trên bản đồ cơ sở, tiện ích giao diện người dùng của Địa điểm sẽ xuất hiện. Tiện ích này cũng yêu cầu phần phụ thuộc SDK Địa điểm. Cách khắc phục: Thêm phần phụ thuộc SDK Địa điểm cho Android và trả về true từ onMap3DClick trong OnMap3DClickListener để loại bỏ tiện ích mặc định nếu bạn không muốn. Xem /maps/documentation/maps-3d/android-sdk/points-of-interest.

Những việc bạn có thể làm với SDK Maps 3D dành cho Android

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.