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ế độ
ROADMAPtrong 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
- Dịch vụ cần bật:
mapsandroid.googleapis.com - Xác thực: Khoá API
- Bắt đầu: Thiết lập SDK Maps 3D dành cho Android
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Maps 3D dành cho Android
- Giá: Mức sử dụng và thông tin thanh toán cho SDK Maps 3D dành cho Android
- Chính sách: Chính sách về SDK Maps 3D dành cho Android
- Ghi chú phát hành: Ghi chú phát hành SDK Maps 3D dành cho Android
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: sản phẩm có liên quan
- Thường dùng với: Places SDK for Android
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,HYBRIDhoặcROADMAP) trong tệp XML bố cục (map3d:mapMode) hoặc bằngsetMapMode/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ộtMap3DViewđang hoạt động; gọionDestroy()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 quaGoogleMap3D. 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ề
truetừonMap3DClicktrongOnMap3DClickListenerđể 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.
- Thêm bản đồ 3D chân thực và có tính tương tác vào trang web.
- Thêm điểm đánh dấu vào bản đồ 3D chân thực.
- Tuỳ chỉnh điểm đánh dấu trên bản đồ 3D chân thực.
- Thêm mô hình 3D vào bản đồ 3D chân thực.
- Thêm hình nhiều đường 3D vào bản đồ 3D chân thực.
- Thêm đa giác 3D vào bản đồ 3D chân thực.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trên bản đồ 3D chân thực.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ 3D chân thực.
- Kiểm soát đường đi của camera và ảnh động trên bản đồ 3D chân thực.
- Kiểm soát các quy định hạn chế về camera trên bản đồ 3D chân thực.