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

Maps SDK cho Android bổ sung dữ liệu Google Maps, màn hình bản đồ và phản hồi cử chỉ trên bản đồ vào các ứng dụng Android, bao gồm cả ứng dụng Wear OS. Bạn có thể thêm điểm đánh dấu, đa giác và lớp phủ để hiển thị thông tin về các vị trí trên bản đồ và hỗ trợ hoạt động tương tác của người dùng bằng Kotlin hoặc Java.

Maps SDK cho Android: thông tin chính

  • Sản phẩm: Maps SDK cho Android
  • Còn được gọi là: Google Maps Android API
  • 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ề Maps SDK cho Android
  • Phạm vi cung cấp theo khu vực: Toàn cầu. Xem trang phạm vi cung cấp của Google Maps Platform; các đường liên kết trên trang mức sử dụng và thanh toán sẽ tách riêng bảng giá toàn cầu và bảng giá tại Ấn Độ. (thông tin chi tiết về phạm vi bảo hiểm)

Maps SDK cho Android: trường hợp sử dụng

Sử dụng Maps SDK cho Android khi:

  • Bạn cần có bản đồ Google 2D tương tác trong ứng dụng Android hoặc Wear OS gốc.
  • Bạn cần thêm điểm đánh dấu, cửa sổ thông tin, hình nhiều đường, đa giác, lớp phủ mặt đất hoặc lớp phủ ô vào bản đồ trong một ứng dụng Android.
  • Bạn cần có ảnh toàn cảnh trong Chế độ xem đường phố, bản đồ ở chế độ thu gọn (bitmap) hoặc định kiểu bản đồ dựa trên đám mây có mã bản đồ trong một ứng dụng Android.
  • Bạn xây dựng bản đồ Android bằng Kotlin hoặc Java, bao gồm cả Jetpack Compose thông qua thư viện Maps Compose.

Không sử dụng Maps SDK cho Android khi:

  • Bạn cần có tính năng chỉ đường từng chặng trong ứng dụng bản đồ Android. Hãy sử dụng Navigation SDK cho Android.
  • Bạn cần có bản đồ 3D chân thực, mô hình 3D hoặc ảnh động đường đi của camera trong một ứng dụng Android. Hãy sử dụng SDK Maps 3D dành cho Android.
  • Bạn cần có bản đồ trong một ứng dụng iOS gốc. Hãy sử dụng SDK bản đồ dành cho iOS.

Maps SDK cho Android: thiết lập

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

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

Maps SDK cho Android: các lỗi thường gặp

  • Vấn đề: Kể từ SDK phiên bản 20.0.0, tệp kê khai SDK không còn chứa thư viện org.apache.http.legacy nữa. Các ứng dụng tải trình kết xuất bản đồ cũ có thể gặp sự cố với java.lang.NoClassDefFoundError. Cách khắc phục: Thêm vào bên trong thẻ của AndroidManifest.xml trong ứng dụng. Các thiết bị có Dịch vụ Google Play phiên bản 25.50.34 trở lên sẽ không bị ảnh hưởng. Hãy xem /maps/documentation/android-sdk/release-notes.
  • Vấn đề: Điểm đánh dấu nâng cao cần có trình kết xuất bản đồ đã nâng cấp. Nếu bạn thêm các tính năng này vào một ứng dụng hiện có mà không tạo lại ứng dụng, thì ứng dụng vẫn có thể sử dụng trình kết xuất cũ. Cách khắc phục: Tạo lại ứng dụng bằng SDK 18.2.0 trở lên để trình kết xuất đã nâng cấp trở thành trình kết xuất mặc định. Xem /maps/documentation/android-sdk/advanced-markers/start.
  • Vấn đề: Những thiết bị không đáp ứng yêu cầu của trình kết xuất (Android 5.0/API 21 trở lên, Dịch vụ Google Play 21.39.14 trở lên, đã bật Cửa hàng Play) sẽ quay lại trình kết xuất cũ, vì vậy, các tính năng cần trình kết xuất mới (chẳng hạn như Kiểu bản đồ dựa trên đám mây) sẽ không hoạt động trên các thiết bị đó. Cách khắc phục: Gọi MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) và kiểm tra giá trị MapsInitializer.Renderer được truyền đến OnMapsSdkInitializedCallback.onMapsSdkInitialized() hoặc kiểm tra GoogleMap.getMapCapabilities(). Nếu thiết bị sử dụng LEGACY, đừng dựa vào tính năng Định kiểu bản đồ dựa trên đám mây hoặc Điểm đánh dấu nâng cao. Xem /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Vấn đề: SDK yêu cầu Dịch vụ Google Play trên thiết bị chạy ứng dụng. Cách khắc phục: Bạn có thể gọi quy trình kiểm tra khả năng sử dụng Dịch vụ Google Play từ ứng dụng của mình. Xem /maps/documentation/android-sdk/config.

Maps SDK cho Android: các tính năng cũ và không dùng nữa

  • Trình kết xuất bản đồ cũ: Ngừng hoạt động kể từ ngày 4 tháng 3 năm 2024. Giải pháp thay thế: Trình kết xuất bản đồ đã nâng cấp (mới nhất), là trình kết xuất mặc định kể từ SDK 18.2.0. Triệu chứng: Tính năng định kiểu bản đồ dựa trên đám mây, tuỳ chỉnh hình nhiều đường nâng cao và Điểm đánh dấu nâng cao không có trong trình kết xuất cũ. Xem hướng dẫn di chuyển.

Những việc bạn có thể làm với Maps SDK 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.

Maps SDK cho Android: Định kiểu dựa trên dữ liệu cho ranh giới

Maps SDK cho Android: Định kiểu dựa trên dữ liệu cho tập dữ liệu

Maps SDK cho Android: Tập dữ liệu

Maps SDK cho Android: Bản đồ

Maps SDK cho Android: Chú thích trên bản đồ

Maps SDK cho Android: Tạo kiểu cho bản đồ

Maps SDK cho Android: Chế độ xem đường phố