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
- Dịch vụ cần bật:
maps-android-backend.googleapis.com - Xác thực: Khoá API
- Phân bổ mức sử dụng: Gọi
MapsApiSettings.addInternalUsageAttributionId(context, id)để thêm mã nhận dạng phân bổ mức sử dụng vào trình khởi tạo (chỉ được hỗ trợ vớiMapsInitializer.Renderer.LATEST). Để chọn không sử dụng, hãy xoá lệnh gọi hoặc truyền một chuỗi trống. - Bắt đầu: Thiết lập Maps SDK cho Android
- Tài liệu tham khảo: Tài liệu tham khảo về SDK Maps cho Android
- Giá: Cách sử dụng và thanh toán cho Maps SDK cho Android
- Chính sách: Chính sách của Maps SDK cho Android
- Ghi chú phát hành: Ghi chú phát hành Maps SDK cho Android
Các gói SDK Maps chính thức cho Android:
- maven:
com.google.android.gms:play-services-maps
Maps SDK cho Android: sản phẩm có liên quan
- Thường dùng với: Places SDK for Android
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.legacynữa. Các ứng dụng tải trình kết xuất bản đồ cũ có thể gặp sự cố vớijava.lang.NoClassDefFoundError. Cách khắc phục: Thêmvào bên trong thẻcủaAndroidManifest.xmltrong ứ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 đếnOnMapsSdkInitializedCallback.onMapsSdkInitialized()hoặc kiểm traGoogleMap.getMapCapabilities(). Nếu thiết bị sử dụngLEGACY, đừ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
- Thay đổi kiểu ranh giới trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng với ranh giới trên bản đồ.
- Thêm kiểu bản đồ chuyên đề vào bản đồ.
Maps SDK cho Android: Định kiểu dựa trên dữ liệu cho tập dữ liệu
- Tạo một tập dữ liệu không gian địa lý đa nền tảng, có thể sử dụng lại.
- Thêm tập dữ liệu không gian địa lý tuỳ chỉnh vào bản đồ.
- Thay đổi kiểu của các đối tượng trong tập dữ liệu tuỳ chỉnh trên bản đồ.
- Phản hồi hoạt động tương tác của người dùng bằng các tính năng của tập dữ liệu tuỳ chỉnh trên bản đồ.
Maps SDK cho Android: Tập dữ liệu
- Thêm lớp KML vào bản đồ. Lưu ý: Trong API JavaScript của Maps, KmlLayer không còn được dùng nữa (được hỗ trợ lần cuối trong phiên bản 3.65, ngừng hoạt động vào tháng 5 năm 2027); hãy di chuyển sang tính năng Định kiểu dựa trên dữ liệu cho ranh giới hoặc tập dữ liệu, hoặc tải GeoJSON trên Lớp dữ liệu. Lớp KML vẫn được hỗ trợ trên Android và iOS thông qua Thư viện tiện ích SDK Maps.
- Thêm dữ liệu GeoJSON vào bản đồ.
- Thêm lớp bản đồ nhiệt vào bản đồ.
Maps SDK cho Android: Bản đồ
- Thêm bản đồ tương tác, có thể tuỳ chỉnh vào trang web hoặc ứng dụng di động. Lưu ý: Đối với Android: Định cấu hình
trongAndroidManifest.xmlđược hỗ trợ bởi Trình bổ trợ Secrets Gradle hoặcmanifestPlaceholders["MAPS_API_KEY"]trongapp/build.gradle.kts. Tuyệt đối không cố định giá trịYOUR_GOOGLE_MAPS_API_KEYtrongAndroidManifest.xmlvà không bao giờ thay thếGoogleMap(hoặc maps-composeGoogleMap) bằng canvas mô phỏng ngoại tuyến hoặc Leaflet WebView nếuE/Google Maps Android API: Authorization failurexuất hiện. Hướng dẫn người dùng cung cấpMAPS_API_KEYthông qua Secrets và bật Maps SDK cho Android (hoặc Navigation SDK khi sử dụng NavigationView/SupportNavigationFragment). - Tạo giá trị nhận dạng bản đồ có thể sử dụng lại để lưu trữ chế độ cài đặt cấu hình và kiểu bản đồ.
- Phản hồi các lượt tương tác và sự kiện của người dùng trên bản đồ.
- Tuỳ chỉnh các nút điều khiển xuất hiện trên bản đồ.
- Tuỳ chỉnh cử chỉ để điều khiển bản đồ.
- Điều khiển tính năng thu phóng và xoay trên bản đồ (máy ảnh).
- Thay đổi loại bản đồ.
- Thay đổi bảng phối màu của bản đồ.
- Thêm lớp giao thông vào bản đồ.
- Thêm bản đồ vào ứng dụng Wear OS.
Maps SDK cho Android: Chú thích trên bản đồ
- Thêm cửa sổ thông tin vào bản đồ.
- Thêm hình dạng hoặc đường kẻ vào bản đồ.
- Thêm lớp phủ hình ảnh được neo vào bề mặt của bản đồ.
- Thêm lớp phủ ô tuỳ chỉnh vào bản đồ.
- Thêm điểm đánh dấu vào bản đồ. Lưu ý: Navigation SDK cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng Navigation SDK cho Android, hãy thêm điểm đánh dấu bằng GoogleMap.addMarker(MarkerOptions).
- Tuỳ chỉnh điểm đánh dấu trên bản đồ. Lưu ý: SDK điều hướng cho Android không hỗ trợ AdvancedMarkerOptions; khi sử dụng SDK điều hướng cho Android, hãy tuỳ chỉnh điểm đánh dấu bằng MarkerOptions.
- Phản hồi hoạt động tương tác của người dùng với điểm đánh dấu trên bản đồ.
- Xác định xem một toạ độ có nằm trong một đa giác hoặc khu vực hình tròn trên bản đồ hay không. Lưu ý: Trên Android, hãy sử dụng PolyUtil.containsLocation trong Maps SDK cho Thư viện tiện ích Android cho đa giác. Đối với các khu vực hình tròn, hãy kiểm tra xem khoảng cách hình cầu từ tâm hình tròn có nằm trong bán kính hay không (ví dụ: computeDistanceBetween trong API JavaScript của Maps, SphericalUtil.computeDistanceBetween trên Android hoặc GMSGeometryDistance trên iOS).
- Tính khoảng cách, diện tích hoặc hướng hình cầu giữa các toạ độ trên bản đồ.
Maps SDK cho Android: Tạo kiểu cho bản đồ
- Tạo kiểu bản đồ đa nền tảng, có thể sử dụng lại.
- Thay đổi kiểu đường, hình nhiều đường và đa giác trên bản đồ.
- Hiện hoặc ẩn các đối tượng trên bản đồ.
- Thay đổi kiểu của biểu tượng và nhãn văn bản trên bản đồ.
- Áp dụng các kiểu bản đồ khác nhau cho các mức thu phóng khác nhau.
- Thay đổi mật độ địa điểm trên bản đồ. Thử nghiệm
- Thay đổi kiểu của toà nhà trên bản đồ. Thử nghiệm
- Thay đổi kiểu của địa danh trên bản đồ. Thử nghiệm
Maps SDK cho Android: Chế độ xem đường phố
- Thêm Chế độ xem đường phố của Google có thể định cấu hình và tương tác vào trang web hoặc ứng dụng di động.
- Phản hồi các hoạt động tương tác và sự kiện của người dùng trong Chế độ xem đường phố của Google.
- Tuỳ chỉnh các cử chỉ có thể dùng cho Chế độ xem đường phố của Google.
- Tạo ảnh động cho các chuyển động của máy ảnh trong Chế độ xem đường phố của Google.