Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Bản đồ của Google

lớp cuối cùng công khai GoogleMap mở rộng Đối tượng

Đây là lớp chính của SDK Google Maps dành cho Android và là điểm truy cập cho tất cả các phương thức liên quan đến bản đồ. Bạn không thể trực tiếp tạo thực thể cho đối tượng GoogleMap, thay vào đó, bạn phải lấy đối tượng từ phương thức getMapAsync() trên MapFragment hoặc MapView mà bạn đã thêm vào ứng dụng của mình.

Lưu ý: Tương tự như đối tượng View, bạn chỉ có thể đọc và sửa đổi GoogleMap từ luồng giao diện người dùng Android. Việc gọi các phương thức GoogleMap từ một chuỗi khác sẽ dẫn đến một ngoại lệ.

Bạn có thể điều chỉnh điểm nhìn của bản đồ bằng cách thay đổi vị trí của máy ảnh (thay vì di chuyển bản đồ). Bạn có thể sử dụng máy ảnh của bản đồ để đặt các tham số như vị trí, mức thu phóng, góc nghiêng và góc phương vị. Để biết thêm thông tin, hãy xem bài viết Máy ảnh và chế độ xem.

Hướng dẫn cho nhà phát triển

Để bắt đầu, hãy đọc hướng dẫn cho nhà phát triển SDK Google Maps dành cho Android .

Tóm tắt lớp lồng ghép

giao diện	GoogleMap.CancelableCallback	Giao diện gọi lại để báo cáo khi một việc cần làm đã hoàn thành hoặc bị huỷ.
giao diện	GoogleMap.InfoWindowAdapter	Cung cấp các chế độ xem để hiển thị tuỳ chỉnh các cửa sổ thông tin.
giao diện	GoogleMap.OnCameraChangeListener	Giao diện này không được dùng nữa. Thay thế bằng `GoogleMap.OnCameraMoveStartedListener`, `GoogleMap.OnCameraMoveListener` và `GoogleMap.OnCameraIdleListener`. Chưa thể xác định thứ tự gọi phương thức `onCameraChange` không dùng nữa liên quan đến các phương thức trong trình nghe thay đổi máy ảnh mới.
giao diện	GoogleMap.OnCameraIdleListener	Giao diện gọi lại khi chuyển động của máy ảnh đã kết thúc.
giao diện	GoogleMap.OnCameraMoveCanceledListener	Giao diện gọi lại khi chuyển động của máy ảnh đã bị dừng hoặc khi máy ảnh bắt đầu di chuyển vì một lý do mới.
giao diện	GoogleMap.OnCameraMoveListener	Giao diện gọi lại khi máy ảnh thay đổi vị trí.
giao diện	GoogleMap.OnCameraMoveStartedListener	Giao diện gọi lại khi chuyển động máy ảnh bắt đầu.
giao diện	GoogleMap.OnCircleClickListener	Giao diện gọi lại khi nhấp vào một vòng kết nối.
giao diện	GoogleMap.OnGroundOverlayClickListener	Giao diện gọi lại khi nhấp vào lớp phủ mặt đất.
giao diện	GoogleMap.OnIndoorStateChangeListener	Trình nghe khi trạng thái trong nhà thay đổi.
giao diện	GoogleMap.OnInfoWindowClickListener	Giao diện gọi lại cho các sự kiện nhấp/nhấn trên cửa sổ thông tin của một điểm đánh dấu.
giao diện	GoogleMap.OnInfoWindowCloseListener	Giao diện gọi lại cho các sự kiện đóng trên cửa sổ thông tin của một điểm đánh dấu.
giao diện	GoogleMap.OnInfoWindowLongClickListener	Giao diện gọi lại khi người dùng nhấn và giữ cửa sổ thông tin của một điểm đánh dấu.
giao diện	GoogleMap.OnMapClickListener	Giao diện gọi lại khi người dùng nhấn vào bản đồ.
giao diện	GoogleMap.OnMapLoadedCallback	Giao diện gọi lại khi bản đồ đã hiển thị xong.
giao diện	GoogleMap.OnMapLongClickListener	Giao diện gọi lại khi người dùng nhấn và giữ trên bản đồ.
giao diện	GoogleMap.OnMarkerClickListener	Xác định chữ ký cho các phương thức được gọi khi người dùng nhấp hoặc nhấn vào một điểm đánh dấu.
giao diện	GoogleMap.OnMarkerDragListener	Giao diện gọi lại cho các sự kiện kéo trên điểm đánh dấu.
giao diện	GoogleMap.OnMyLocationButtonClickListener	Giao diện gọi lại khi nút Vị trí của tôi được nhấp vào.
giao diện	GoogleMap.OnMyLocationChangeListener	Giao diện này không được dùng nữa. Thay vào đó, hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi cung cấp tính năng tìm vị trí và mức sử dụng năng lượng đã cải tiến, đồng thời được sử dụng bởi chấm màu xanh dương "Vị trí của tôi". Xem hướng dẫn Chọn địa điểm hiện tại (có sử dụng FusedLocationProviderApi) hoặc Hướng dẫn cho nhà phát triển về vị trí.
giao diện	GoogleMap.OnMyLocationClickListener	Giao diện gọi lại khi dấu chấm Vị trí của tôi (biểu thị vị trí của người dùng) được nhấp vào.
giao diện	GoogleMap.OnPoiClickListener	Trình nghe cho thao tác nhấn vào POI.
giao diện	GoogleMap.OnPolygonClickListener	Giao diện gọi lại khi một đa giác được nhấp vào.
giao diện	GoogleMap.OnPolylineClickListener	Giao diện gọi lại khi một hình nhiều đường được nhấp vào.
giao diện	GoogleMap.SnapshotReadyCallback	Giao diện gọi lại để thông báo khi đã chụp ảnh nhanh.

Tóm tắt hằng số

int	MAP_TYPE_HYBRID	Bản đồ vệ tinh với một lớp trong suốt của các đường phố chính.
int	MAP_TYPE_NONE	Không có ô bản đồ cơ sở nào.
int	MAP_TYPE_NORMAL	Bản đồ cơ bản.
int	MAP_TYPE_SATELLITE	Bản đồ vệ tinh không có nhãn.
int	MAP_TYPE_TERRAIN	Bản đồ địa hình.

Tóm tắt phương thức công khai

Vòng kết nối	addCircle(các lựa chọn CircleOptions) Thêm một vòng tròn vào bản đồ này.
GroundOverlay	addGroundOverlay(Tuỳ chọn GroundOverlayOptions) Thêm hình ảnh vào bản đồ này.
Điểm đánh dấu	addMarker(tuỳ chọn MarkerOptions) Thêm một điểm đánh dấu vào bản đồ này.
Đa giác	addPolygon(các lựa chọn PolygonOptions) Thêm một đa giác vào bản đồ này.
Polyline	addPolyline(các lựa chọn PolylineOptions) Thêm một hình nhiều đường vào bản đồ này.
TileOverlay	addTileOverlay(các lựa chọn TileOverlayOptions) Thêm lớp phủ ô vào bản đồ này.
void	animateCamera(bản cập nhật CameraUpdate) Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật.
void	animateCamera(bản cập nhật CameraUpdate, lệnh gọi lại GoogleMap.CancelableCallback) Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật và gọi một lệnh gọi lại không bắt buộc khi hoàn tất.
void	animateCamera(bản cập nhật CameraUpdate, int durationMs, lệnh gọi lại GoogleMap.CancelableCallback) Di chuyển bản đồ theo nội dung cập nhật bằng ảnh động trong một khoảng thời gian cụ thể và gọi một lệnh gọi lại không bắt buộc khi hoàn tất.
void	clear() Xóa tất cả các điểm đánh dấu, hình nhiều đường, đa giác, lớp phủ, v.v. khỏi bản đồ.
CameraPosition	getCameraPosition() Lấy vị trí hiện tại của máy ảnh.
IndoorBuilding	getFocusedBuilding() Lấy toà nhà hiện được đặt tiêu điểm.
int	getMapType() Lấy loại bản đồ đang được hiển thị.
float	getMaxZoomLevel() Trả về mức thu phóng tối đa cho vị trí hiện tại của máy ảnh.
float	getMinZoomLevel() Trả về mức thu phóng tối thiểu.
Vị trí	getMyLocation() Phương thức này không được dùng nữa. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi cung cấp tính năng tìm vị trí và mức sử dụng năng lượng đã cải tiến, đồng thời được sử dụng bởi chấm màu xanh dương "Vị trí của tôi". Hãy xem MyLocationdemoActivity trong thư mục ứng dụng mẫu để tham khảo mã ví dụ hoặc Hướng dẫn cho nhà phát triển về vị trí.
Phép chiếu	getProjection() Trả về đối tượng `Projection` mà bạn có thể sử dụng để chuyển đổi giữa toạ độ màn hình và toạ độ vĩ độ/kinh độ.
UiSettings	getUiSettings() Lấy chế độ cài đặt giao diện người dùng của bản đồ.
boolean	Hàm isBuildingsEnabled() Trả về xem có bật lớp toà nhà 3D hay không.
boolean	Hàm isIndoorEnabled() Xem bản đồ trong nhà có đang bật hay không.
boolean	Hàm isMyLocationEnabled() Nhận trạng thái của lớp vị trí của tôi.
boolean	Hàm isTrafficEnabled() Kiểm tra xem bản đồ có đang vẽ dữ liệu giao thông hay không.
void	moveCamera(bản cập nhật CameraUpdate) Đặt lại vị trí camera theo hướng dẫn được xác định trong bản cập nhật.
void	resetMinMaxZoomPreference() Xoá mọi giới hạn thu phóng trên và dưới được chỉ định trước đó.
void	setBuildingsEnabled(đã bật boolean) Bật hoặc tắt lớp Toà nhà 3D.
void	setContentDescription(Mô tả chuỗi) Đặt contentDescription cho bản đồ.
boolean	setIndoorEnabled(đã bật boolean) Đặt có nên bật bản đồ trong nhà hay không.
void	setInfoWindowAdapter(bộ chuyển đổi GoogleMap.InfoWindowAdapter) Đặt một trình kết xuất đồ hoạ tuỳ chỉnh cho nội dung của cửa sổ thông tin.
void	setLatLngBoundsForCameraTarget(giới hạn LatLngBounds) Chỉ định một LatLngBounds để ràng buộc mục tiêu máy ảnh để khi người dùng cuộn và xoay bản đồ, mục tiêu máy ảnh không di chuyển ra ngoài các giới hạn này.
void	setLocationSource(nguồn LocationSource) Thay thế nguồn vị trí của lớp vị trí của tôi.
boolean	setMapStyle(kiểu MapStyleOptions) Thiết lập kiểu của bản đồ cơ sở.
void	setMapType(loại int) Đặt loại ô bản đồ sẽ được hiển thị.
void	setMaxZoomPreference(số thực maxZoomPreference) Thiết lập giới hạn trên ưu tiên cho mức thu phóng của máy ảnh.
void	setMinZoomPreference(float minZoomPreference) Thiết lập giới hạn dưới ưu tiên cho mức thu phóng của máy ảnh.
void	setMyLocationEnabled(đã bật boolean) Bật hoặc tắt lớp vị trí của tôi.
void	setOnCameraChangeListener(trình nghe GoogleMap.OnCameraChangeListener) Phương thức này không được dùng nữa. Thay thế bằng `setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)`, `setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)`, `setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)` và `setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)`.
void	setOnCameraIdleListener(trình nghe GoogleMap.OnCameraIdleListener) Đặt một lệnh gọi lại được gọi khi chuyển động của camera kết thúc.
void	setOnCameraMoveCanceledListener(trình nghe GoogleMap.OnCameraMoveCanceledListener) Đặt lệnh gọi lại được gọi khi chuyển động của máy ảnh bị một loại ảnh động mới dừng hoặc gián đoạn.
void	setOnCameraMoveListener(trình nghe GoogleMap.OnCameraMoveListener) Đặt lệnh gọi lại được gọi nhiều lần khi camera đang chuyển động.
void	setOnCameraMoveStartedListener(trình nghe GoogleMap.OnCameraMoveStartedListener) Đặt lệnh gọi lại được gọi khi máy ảnh bắt đầu di chuyển hoặc lý do chuyển động của máy ảnh thay đổi.
void	setOnCircleClickListener(trình nghe GoogleMap.OnCircleClickListener) Đặt lệnh gọi lại được gọi khi nhấp vào một vòng kết nối.
void	setOnGroundOverlayClickListener(trình nghe GoogleMap.OnGroundOverlayClickListener) Đặt lệnh gọi lại được gọi khi nhấp vào lớp mặt đất.
void	setOnIndoorStateChangeListener(trình nghe GoogleMap.OnIndoorStateChangeListener) Thiết lập hoặc xoá trình nghe cho sự kiện trong nhà.
void	setOnInfoWindowClickListener(trình nghe GoogleMap.OnInfoWindowClickListener) Đặt lệnh gọi lại được gọi khi cửa sổ thông tin về điểm đánh dấu được nhấp vào.
void	setOnInfoWindowCloseListener(trình nghe GoogleMap.OnInfoWindowCloseListener) Đặt lệnh gọi lại được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng.
void	setOnInfoWindowLongClickListener(trình nghe GoogleMap.OnInfoWindowLongClickListener) Đặt lệnh gọi lại được gọi khi bạn nhấn và giữ cửa sổ thông tin của điểm đánh dấu.
void	setOnMapClickListener(trình nghe GoogleMap.OnMapClickListener) Đặt một lệnh gọi lại được gọi khi người dùng nhấn vào bản đồ.
void	setOnMapLoadedCallback(lệnh gọi lại GoogleMap.OnMapLoadedCallback) Đặt lệnh gọi lại được gọi khi bản đồ này kết xuất xong.
void	setOnMapLongClickListener(trình nghe GoogleMap.OnMapLongClickListener) Đặt lệnh gọi lại được gọi khi nhấn và giữ bản đồ.
void	setOnMarkerClickListener(trình nghe GoogleMap.OnMarkerClickListener) Đặt lệnh gọi lại được gọi khi nhấp vào một điểm đánh dấu.
void	setOnMarkerDragListener(trình nghe GoogleMap.OnMarkerDragListener) Đặt lệnh gọi lại được gọi khi bạn kéo một điểm đánh dấu.
void	setOnMyLocationButtonClickListener(trình nghe GoogleMap.OnMyLocationButtonClickListener) Đặt lệnh gọi lại được gọi khi nút vị trí của tôi được nhấp vào.
void	setOnMyLocationChangeListener(trình nghe GoogleMap.OnMyLocationChangeListener) Phương thức này không được dùng nữa. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi cung cấp tính năng tìm vị trí và mức sử dụng năng lượng đã cải tiến, đồng thời được sử dụng bởi chấm màu xanh dương "Vị trí của tôi". Hãy xem MyLocationdemoActivity trong thư mục ứng dụng mẫu để tham khảo mã ví dụ hoặc Hướng dẫn cho nhà phát triển về vị trí.
void	setOnMyLocationClickListener(trình nghe GoogleMap.OnMyLocationClickListener) Đặt lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi (biểu thị vị trí của người dùng) được nhấp vào.
void	setOnPoiClickListener(trình nghe GoogleMap.OnPoiClickListener) Thiết lập trình nghe sẽ được kích hoạt khi người dùng nhấp hoặc nhấn vào một POI.
void	setOnPolygonClickListener(trình nghe GoogleMap.OnPolygonClickListener) Đặt lệnh gọi lại được gọi khi nhấp vào đa giác.
void	setOnPolylineClickListener(trình nghe GoogleMap.OnPolylineClickListener) Đặt lệnh gọi lại được gọi khi nhấp vào một hình nhiều đường.
void	setPadding(int trái, số nguyên trên cùng, số nguyên bên phải, số nguyên dưới cùng) Đặt khoảng đệm trên bản đồ.
void	setTrafficEnabled(đã bật boolean) Bật hoặc tắt lớp giao thông.
void	snapshot(lệnh gọi lại GoogleMap.SnapshotReadyCallback) Chụp ảnh nhanh về bản đồ.
void	snapshot(lệnh gọi lại GoogleMap.SnapshotReadyCallback, bitmap Bitmap) Chụp ảnh nhanh về bản đồ.
void	Hàm stopAnimation() Dừng ảnh động của máy ảnh nếu có một ảnh đang diễn ra.

Tóm tắt phương thức kế thừa

Trong lớp java.lang.Object

boolean	bằng(Đối tượng arg0)
lớp cuối cùng<?>	getClass()
int	hashCode()
khoảng trống cuối cùng	notify()
khoảng trống cuối cùng	notifyAll()
Chuỗi	toString()
khoảng trống cuối cùng	chờ(long arg0, int arg1)
khoảng trống cuối cùng	chờ(long arg0)
khoảng trống cuối cùng	wait()

Hằng số

public static cuối cùng int MAP_TYPE_HYBRID

Bản đồ vệ tinh với một lớp trong suốt của các đường phố chính.

Giá trị không đổi: 4

public static cuối cùng int MAP_TYPE_NONE

Không có ô bản đồ cơ sở nào.

Giá trị không đổi: 0

công khai tĩnh cuối cùng int MAP_TYPE_NORMAL

Bản đồ cơ bản.

Giá trị không đổi: 1

public static cuối cùng int MAP_TYPE_SATELLITE

Bản đồ vệ tinh không có nhãn.

Giá trị không đổi: 2

công khai tĩnh cuối cùng int MAP_TYPE_TERRAIN

Bản đồ địa hình.

Giá trị không đổi: 3

Phương thức công khai

công khai Vòng kết nối addCircle (CircleOptions tuỳ chọn)

Thêm một vòng tròn vào bản đồ này.

Các tham số

tùy chọn	Đối tượng tuỳ chọn vòng kết nối xác định cách hiển thị Vòng kết nối

Trả bóng

Đối tượng Circle được thêm vào bản đồ

công khai GroundOverlay addGroundOverlay (GroundOverlayOptions)

Thêm hình ảnh vào bản đồ này.

Các tham số

tùy chọn	Đối tượng tuỳ chọn lớp phủ trên mặt đất xác định cách hiển thị lớp phủ. Tuỳ chọn phải có một hình ảnh (AnchoredBitmap) và vị trí được chỉ định.

Trả bóng

GroundOverlay đã được thêm vào bản đồ.

Gửi

IllegalArgumentException	nếu hình ảnh hoặc vị trí chưa được chỉ định trong các tuỳ chọn.

công khai Marker addMarker (MarkerOptions)

Thêm một điểm đánh dấu vào bản đồ này.

Biểu tượng của điểm đánh dấu được hiển thị trên bản đồ tại vị trí Marker.position. Thao tác nhấp vào điểm đánh dấu sẽ căn giữa máy ảnh trên điểm đánh dấu. Nếu xác định Marker.title, bản đồ sẽ hiển thị một hộp thông tin có tiêu đề và đoạn trích của điểm đánh dấu. Nếu điểm đánh dấu có thể kéo, hãy nhấp và giữ, sau đó kéo điểm đánh dấu sẽ di chuyển điểm đánh dấu đó.

Các tham số

tùy chọn	Đối tượng tuỳ chọn điểm đánh dấu xác định cách hiển thị điểm đánh dấu.

Trả bóng

Marker đã được thêm vào bản đồ.

công khai Polygon addPolygon (PolygonOptions lựa chọn)

Thêm một đa giác vào bản đồ này.

Các tham số

tùy chọn	Một đối tượng đa giác có các tuỳ chọn giúp xác định cách kết xuất Đa giác.

Trả bóng

Đối tượng Polygon được thêm vào bản đồ.

công khai Polyline addPolyline (PolylineOptions lựa chọn)

Thêm một hình nhiều đường vào bản đồ này.

Các tham số

tùy chọn	Đối tượng tuỳ chọn nhiều đường xác định cách kết xuất hình nhiều đường.

Trả bóng

Đối tượng Polyline đã được thêm vào bản đồ.

công khai TileOverlay addTileOverlay (TileOverlayOptions tuỳ chọn)

Thêm lớp phủ ô vào bản đồ này. Vui lòng xem TileOverlay để biết thêm thông tin.

Lưu ý không giống như các lớp phủ khác, nếu bản đồ được tạo lại, thì các lớp phủ ô sẽ không được tự động khôi phục và phải được thêm lại theo cách thủ công.

Các tham số

tùy chọn	Đối tượng tuỳ chọn lớp phủ ô xác định cách hiển thị lớp phủ. Các tuỳ chọn phải chỉ định `TileProvider`, nếu không, hệ thống sẽ gửi `IllegalArgumentException`.

Trả bóng

TileOverlay đã được thêm vào bản đồ.

Gửi

IllegalArgumentException	nếu bạn chưa chỉ định `TileProvider` trong các tuỳ chọn.

công khai khoảng trống animateCamera (CameraUpdate cập nhật)

Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật. Trong quá trình tạo ảnh động, lệnh gọi đến getCameraPosition() sẽ trả về một vị trí trung gian của máy ảnh.

Hãy xem CameraUpdateFactory để biết các nội dung cập nhật.

Các tham số

cập nhật	Thay đổi cần áp dụng cho máy ảnh.

công khai khoảng trống animateCamera (CameraUpdate cập nhật, GoogleMap.CancelableCallback gọi lại)

Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật và gọi một lệnh gọi lại không bắt buộc khi hoàn tất. Hãy xem CameraUpdateFactory để nắm được các nội dung cập nhật.

Trong quá trình tạo ảnh động, lệnh gọi đến getCameraPosition() sẽ trả về một vị trí trung gian của máy ảnh.

Các tham số

cập nhật	Thay đổi cần áp dụng cho máy ảnh.
số gọi lại	Lệnh gọi lại để gọi từ luồng giao diện người dùng Android khi ảnh động dừng. Nếu ảnh động hoàn tất bình thường, `onFinish()` sẽ được gọi; nếu không, `onCancel()` sẽ được gọi. Đừng cập nhật hoặc tạo ảnh động cho máy ảnh từ trong `onCancel()`.

public void animateCamera (CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback)

Di chuyển bản đồ theo nội dung cập nhật bằng ảnh động trong một khoảng thời gian cụ thể và gọi một lệnh gọi lại không bắt buộc khi hoàn tất. Hãy xem CameraUpdateFactory để biết các nội dung cập nhật.

Nếu getCameraPosition() được gọi trong quá trình tạo ảnh động, thì giá trị này sẽ trả về vị trí hiện tại của máy ảnh đang bay.

Các tham số

cập nhật
durationMs	Thời lượng của ảnh động tính bằng mili giây. Giá trị này phải hoàn toàn đảm bảo dương, nếu không, hệ thống sẽ gửi `IllegalArgumentException`.
số gọi lại	Một lệnh gọi lại (không bắt buộc) để nhận thông báo từ luồng giao diện người dùng Android khi ảnh động dừng. Nếu ảnh động dừng do quá trình hoàn tất tự nhiên, thì lệnh gọi lại sẽ được thông báo bằng `onFinish()`. Nếu ảnh động dừng do gián đoạn bởi một chuyển động của máy ảnh sau đó hoặc một cử chỉ của người dùng, `onCancel()` sẽ được gọi. Lệnh gọi lại không được cố gắng di chuyển hoặc tạo ảnh động cho máy ảnh trong phương thức huỷ. Nếu không cần gọi lại, hãy để giá trị là `null`.

công khai khoảng trống xoá ()

Xóa tất cả các điểm đánh dấu, hình nhiều đường, đa giác, lớp phủ, v.v. khỏi bản đồ.

công khai CameraPosition getCameraPosition ()

Lấy vị trí hiện tại của máy ảnh.

CameraPosition được trả về là ảnh chụp nhanh của vị trí hiện tại và sẽ không tự động cập nhật khi máy ảnh di chuyển.

Để biết thêm thông tin về cách thay đổi vị trí của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Trả bóng

Vị trí hiện tại của Camera.

công khai IndoorBuilding getFocusedBuilding ()

Lấy toà nhà hiện được đặt tiêu điểm.

Trả bóng

Toà nhà hiện được đặt tiêu điểm hoặc null nếu không có toà nhà nào được làm tâm điểm.

public int getMapType ()

Lấy loại bản đồ đang được hiển thị. Hãy xem MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN để biết các giá trị có thể có.

Trả bóng

Loại bản đồ.

công khai float getMaxZoomLevel ()

Trả về mức thu phóng tối đa cho vị trí hiện tại của máy ảnh. Điều này xem xét loại bản đồ đang được sử dụng, ví dụ: vệ tinh hoặc địa hình có thể có mức thu phóng tối đa thấp hơn so với ô bản đồ cơ sở.

Để biết thêm thông tin về cách thay đổi mức thu phóng của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Trả bóng

Mức thu phóng tối đa có sẵn ở vị trí hiện tại của máy ảnh.

public float getMinZoomLevel ()

Trả về mức thu phóng tối thiểu. Điều này là giống nhau cho mọi vị trí (không giống như mức thu phóng tối đa) nhưng có thể khác nhau giữa các thiết bị và kích thước bản đồ.

Để biết thêm thông tin về cách thay đổi mức thu phóng của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Trả bóng

Mức thu phóng tối thiểu hiện có.

công khai Vị trí getMyLocation ()

Phương thức này không còn được dùng nữa.
hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi thay thế. FusedLocationProviderApi cung cấp tính năng tìm vị trí và mức sử dụng năng lượng đã cải tiến, đồng thời được sử dụng bởi chấm màu xanh dương "Vị trí của tôi". Hãy xem MyLocationdemoActivity trong thư mục ứng dụng mẫu để xem mã ví dụ hoặc Hướng dẫn cho nhà phát triển về vị trí.

Trả về vị trí đang hiển thị của người dùng, hoặc null nếu không có dữ liệu vị trí.

Trả bóng

user location đang hiển thị.

Gửi

IllegalStateException	nếu lớp vị trí của tôi không được bật.

công khai Phép chiếu getProjection ()

Trả về đối tượng Projection mà bạn có thể sử dụng để chuyển đổi giữa toạ độ màn hình và toạ độ vĩ độ/kinh độ.

Projection được trả về là ảnh chụp nhanh của phép chiếu hiện tại và sẽ không tự động cập nhật khi máy ảnh di chuyển. Vì thao tác này tốn kém nên bạn chỉ nên chiếu một lần cho mỗi màn hình. Google Maps sử dụng phép chiếu AndroidX để tạo bản đồ của nó từ dữ liệu địa lý và chuyển đổi các điểm trên bản đồ thành toạ độ địa lý.

Trả bóng

Projection của bản đồ ở trạng thái hiện tại.

công khai UiSettings getUiSettings ()

Lấy chế độ cài đặt giao diện người dùng của bản đồ.

Trả bóng

UiSettings cho bản đồ này.

boolean công khai isBuildingsEnabled ()

Trả về xem có bật lớp toà nhà 3D hay không.

Trả bóng

true nếu toà nhà được bật; nếu không thì false.

boolean công khai isIndoorEnabled ()

Xem bản đồ trong nhà có đang bật hay không.

Trả bóng

true nếu bản đồ trong nhà đang bật; false nếu bản đồ trong nhà đang tắt;

boolean công khai isMyLocationEnabled ()

Nhận trạng thái của lớp vị trí của tôi.

Trả bóng

true nếu lớp vị trí của tôi được bật; nếu không thì là false.

boolean công khai isTrafficEnabled ()

Kiểm tra xem bản đồ có đang vẽ dữ liệu giao thông hay không. Việc này tuỳ thuộc vào tình trạng sẵn có của dữ liệu về lưu lượng truy cập.

Trả bóng

true nếu dữ liệu giao thông được bật; nếu không thì false.

công khai khoảng trống moveCamera (CameraUpdate cập nhật)

Đặt lại vị trí camera theo hướng dẫn được xác định trong bản cập nhật. Quá trình di chuyển diễn ra ngay lập tức và getCameraPosition() tiếp theo sẽ phản ánh vị trí mới. Hãy xem CameraUpdateFactory để nắm được các thông tin cập nhật.

Các tham số

cập nhật	Thay đổi cần áp dụng cho máy ảnh.

công khai khoảng trống resetMinMaxZoomPreference ()

Xoá mọi giới hạn thu phóng trên và dưới được chỉ định trước đó.

công khai khoảng trống setBuildingsEnabled (boolean enabled)

Bật hoặc tắt lớp Toà nhà 3D.

Các tham số

đang bật	`true` để bật lớp toà nhà 3D; `false` để tắt toà nhà 3D.

public void setContentDescription (Mô tả chuỗi)

Đặt contentDescription cho bản đồ.

Tính năng này được dùng để cung cấp nội dung mô tả bằng giọng nói về bản đồ ở chế độ hỗ trợ tiếp cận. Giá trị mặc định là "Google Map"

Các tham số

description	chuỗi để sử dụng làm mô tả.

công khai boolean setIndoorEnabled (boolean enabled)

Đặt có nên bật bản đồ trong nhà hay không. Hiện tại, bản đồ trong nhà chỉ có thể hiển thị trên một bản đồ tại một thời điểm và theo mặc định, đây là bản đồ đầu tiên được thêm vào ứng dụng của bạn. Để bật bản đồ trong nhà trên bản đồ khác, trước tiên, bạn phải tắt bản đồ trong nhà trên bản đồ gốc. Nếu bạn cố gắng bật bản đồ trong nhà khi tính năng này được bật trên một bản đồ khác, thì sẽ không có gì xảy ra và thao tác này sẽ trả về false. Khi trong nhà không được bật cho bản đồ, mọi phương thức liên quan đến chế độ trong nhà sẽ trả về null hoặc false.

Các tham số

đang bật	`true` để cố bật bản đồ trong nhà; `false` để tắt bản đồ trong nhà.

Trả bóng

có thể bật bản đồ trong nhà hay không.

công khai khoảng trống setInfoWindowAdapter (GoogleMap.InfoWindowAdapter)

Đặt một trình kết xuất đồ hoạ tuỳ chỉnh cho nội dung của cửa sổ thông tin.

Giống như trình nghe sự kiện của bản đồ, trạng thái này không được chuyển đổi tuần tự cùng với bản đồ. Nếu bản đồ được tạo lại (ví dụ: do thay đổi về cấu hình), bạn phải đảm bảo gọi lại phương thức này để duy trì chế độ tuỳ chỉnh.

Các tham số

bộ chuyển đổi	Trình chuyển đổi để dùng cho nội dung trong cửa sổ thông tin hoặc `null` để dùng chế độ kết xuất nội dung mặc định trong cửa sổ thông tin.

công khai khoảng trống setLatLngBoundsForCameraTarget (LatLngBounds)

Chỉ định một LatLngBounds để ràng buộc mục tiêu máy ảnh để khi người dùng cuộn và xoay bản đồ, mục tiêu máy ảnh không di chuyển ra ngoài các giới hạn này.

Đặt thành rỗng để xoá hoàn toàn hộp giới hạn. Các giới hạn mới sẽ thay thế mọi hộp giới hạn đã chỉ định trước đó.

Khi LatLngBounds thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo các giới hạn đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể khiến SDK không thể giữ máy ảnh nhắm mục tiêu hoàn toàn trong giới hạn. Ví dụ: lỗi làm tròn độ chính xác của dấu phẩy động hoặc mức thu phóng rất thấp.

Các tham số

ranh giới	Các giới hạn để ràng buộc mục tiêu máy ảnh bên trong.

công khai khoảng trống setLocationSource (nguồn LocationSource)

Thay thế nguồn vị trí của lớp vị trí của tôi.

Các tham số

source	Nguồn vị trí để sử dụng trong lớp vị trí của tôi. Hãy đặt thành `null` để sử dụng nguồn vị trí mặc định.

công khai boolean setMapStyle (kiểu MapStyleOptions)

Thiết lập kiểu của bản đồ cơ sở.

Khi sử dụng các lựa chọn kiểu, bạn có thể áp dụng kiểu tuỳ chỉnh cho các đối tượng và thành phần trên bản đồ. Xem MapStyleOptions để biết thông tin chi tiết về định nghĩa kiểu.

Đặt thành rỗng để xoá mọi kiểu tuỳ chỉnh trước đó.

Các tham số

kiểu

Trả bóng

true nếu kiểu được phân tích cú pháp thành công; false nếu phát hiện thấy MapStyleOptions có sự cố, bao gồm: JSON không thể phân tích cú pháp định kiểu, loại tính năng không nhận dạng được, loại phần tử không nhận dạng được hoặc khoá trình định kiểu không hợp lệ. Nếu giá trị trả về là false, thì kiểu hiện tại sẽ không thay đổi.

công khai khoảng trống setMapType (loại int)

Đặt loại ô bản đồ sẽ được hiển thị. Các giá trị được phép là:

MAP_TYPE_NORMAL: Bản đồ cơ bản.
MAP_TYPE_SATELLITE: Hình ảnh vệ tinh.
MAP_TYPE_HYBRID: Hình ảnh vệ tinh có đường và nhãn.
MAP_TYPE_TERRAIN: Dữ liệu địa hình.
MAP_TYPE_NONE: Không có ô bản đồ cơ sở.

Các tham số

loại	Loại bản đồ để hiển thị.

công khai khoảng trống setMaxZoomPreference (float maxZoomPreference)

Thiết lập giới hạn trên ưu tiên cho mức thu phóng của máy ảnh.

Khi mức thu phóng tối đa thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo mức tối đa đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể ngăn SDK cho phép người dùng thu phóng quá sâu vào bản đồ. Ví dụ: vệ tinh hoặc địa hình có thể có mức thu phóng tối đa thấp hơn ô bản đồ cơ sở.

SDK giải quyết mọi xung đột về giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu thành mức thu phóng cao hơn mức tối đa hiện tại, SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức thu phóng tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thành mức thu phóng thấp hơn mức tối thiểu, SDK sẽ sử dụng giá trị tối đa mới cho cả mức thu phóng tối thiểu và tối đa. Ví dụ: Giả sử mức thu phóng tối thiểu hiện tại là 8 và tối đa là 14. Sau đó, bạn đặt mức thu phóng tối đa thành 6. SDK sử dụng mức thu phóng tối thiểu là 6 và mức thu phóng tối đa là 6.

Các tham số

maxZoomPreference	Giới hạn trên ưu tiên.

công khai khoảng trống setMinZoomPreference (float minZoomPreference)

Thiết lập giới hạn dưới ưu tiên cho mức thu phóng của máy ảnh.

Khi mức thu phóng tối thiểu thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo mức tối thiểu đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể ngăn SDK cho phép người dùng thu phóng quá thấp.

SDK giải quyết mọi xung đột về giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu thành mức thu phóng cao hơn mức tối đa hiện tại, SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức thu phóng tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thành mức thu phóng thấp hơn mức tối thiểu, SDK sẽ sử dụng giá trị tối đa mới cho cả mức thu phóng tối thiểu và tối đa. Ví dụ: Giả sử mức thu phóng tối thiểu hiện tại là 8 và tối đa là 14. Sau đó, bạn đặt mức thu phóng tối thiểu thành 16. SDK sử dụng mức thu phóng tối thiểu là 16 và mức thu phóng tối đa là 16.

Các tham số

minZoomPreference	Giới hạn dưới ưu tiên.

public void setMyLocationEnabled (boolean enabled)

Bật hoặc tắt lớp vị trí của tôi.

Khi được bật và có thông tin vị trí, lớp vị trí của tôi liên tục vẽ chỉ báo về vị trí và góc phương tiện hiện tại của người dùng, đồng thời hiển thị các chế độ điều khiển trên giao diện người dùng cho phép người dùng tương tác với vị trí của họ (ví dụ: bật hoặc tắt tính năng theo dõi của máy ảnh về vị trí và góc phương vị).

Để sử dụng tính năng lớp vị trí của tôi, bạn cần yêu cầu cấp quyền cho ACCESS_COARSE_LOCATION hoặc ACCESS_FINE_LOCATION trừ phi bạn đã đặt nguồn vị trí tuỳ chỉnh.

Nếu bạn đã đặt nguồn vị trí tùy chỉnh thông qua setLocationSource(LocationSource), SDK Google Maps dành cho Android sẽ không kiểm tra xem các quyền ở trên đã được cấp hay chưa. Tuy nhiên, bạn vẫn cần đảm bảo rằng người dùng đã cấp tất cả các quyền cần thiết đối với nguồn vị trí tuỳ chỉnh.

Các tham số

đang bật	`true` để bật; `false` để tắt.

Gửi

SecurityException	nếu quyền truy cập thông tin vị trí chưa được cấp.

công khai khoảng trống setOnCameraChangeListener (GoogleMap.OnCameraChangeListener)

Phương thức này không còn được dùng nữa.
Thay thế bằng setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) và setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Đặt một lệnh gọi lại được gọi khi máy ảnh thay đổi.

Các tham số

trình nghe	Lệnh gọi lại được bật khi camera thay đổi. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener)

Đặt một lệnh gọi lại được gọi khi chuyển động của camera kết thúc.

Các tham số

trình nghe	Lệnh gọi lại đã được kích hoạt. Để bỏ đặt lệnh gọi lại, hãy dùng `null`.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener)

Đặt lệnh gọi lại được gọi khi chuyển động của máy ảnh bị một loại ảnh động mới dừng hoặc gián đoạn.

Các tham số

trình nghe	Lệnh gọi lại đã được kích hoạt. Để bỏ đặt lệnh gọi lại, hãy dùng `null`. Đừng cập nhật hoặc tạo ảnh động cho máy ảnh từ trong `onCameraMoveCanceled()`.

công khai khoảng trống setOnCameraMoveListener (GoogleMap.OnCameraMoveListener)

Đặt lệnh gọi lại được gọi nhiều lần khi camera đang chuyển động. Lệnh gọi lại có thể được gọi thường xuyên như một lần trong mỗi khung hình và không phải thực hiện các thao tác tốn kém.

Các tham số

trình nghe	Lệnh gọi lại đã được kích hoạt. Để bỏ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)

Đặt lệnh gọi lại được gọi khi máy ảnh bắt đầu di chuyển hoặc lý do chuyển động của máy ảnh thay đổi.

Các tham số

trình nghe	Lệnh gọi lại đã được kích hoạt. Để bỏ đặt lệnh gọi lại, hãy dùng `null`. Đừng cập nhật hoặc tạo ảnh động cho máy ảnh từ trong `onCameraMoveStarted()`.

public void setOnCircleClickListener (GoogleMap.OnCircleClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nhấp vào một vòng kết nối.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi người dùng nhấp vào một vòng kết nối. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai khoảng trống setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nhấp vào lớp mặt đất.

Các tham số

trình nghe	Lệnh gọi lại được bật khi có lớp phủ mặt đất được nhấp vào. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)

Thiết lập hoặc xoá trình nghe cho sự kiện trong nhà. Bạn chỉ có thể thiết lập một trình nghe. Việc thiết lập trình nghe mới sẽ xoá trình nghe trước đó.

Các tham số

trình nghe	trình nghe các sự kiện trong nhà nếu giá trị không rỗng; nếu không, sẽ xoá trình nghe

public void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi cửa sổ thông tin về điểm đánh dấu được nhấp vào.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi cửa sổ thông tin về điểm đánh dấu được nhấp vào. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener trình nghe)

Đặt lệnh gọi lại được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

public void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi bạn nhấn và giữ cửa sổ thông tin của điểm đánh dấu.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi bạn nhấn và giữ cửa sổ thông tin của một điểm đánh dấu. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnMapClickListener (GoogleMap.OnMapClickListener trình nghe)

Đặt một lệnh gọi lại được gọi khi người dùng nhấn vào bản đồ.

Các tham số

trình nghe	Lệnh gọi lại được bật khi người dùng nhấn vào bản đồ. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback gọi lại)

Đặt lệnh gọi lại được gọi khi bản đồ này kết xuất xong. Lệnh gọi lại sẽ chỉ được gọi một lần.

Nếu phương thức này được gọi khi bản đồ hiển thị hoàn toàn, thì lệnh gọi lại sẽ được gọi ngay lập tức. Sự kiện này sẽ không kích hoạt nếu bản đồ không bao giờ tải do vấn đề về kết nối, hoặc nếu bản đồ liên tục thay đổi và không bao giờ hoàn tất việc tải do người dùng liên tục tương tác với bản đồ.

Các tham số

số gọi lại	Lệnh gọi lại được bật khi bản đồ kết xuất xong. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nhấn và giữ bản đồ.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi người dùng nhấn và giữ bản đồ. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng trống setOnMarkerClickListener (GoogleMap.OnMarkerClickListener)

Đặt lệnh gọi lại được gọi khi nhấp vào một điểm đánh dấu.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi có một điểm đánh dấu được nhấp vào. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai khoảng trống setOnMarkerDragListener (GoogleMap.OnMarkerDragListener)

Đặt lệnh gọi lại được gọi khi bạn kéo một điểm đánh dấu.

Các tham số

trình nghe	Lệnh gọi lại đã được gọi trên các sự kiện kéo điểm đánh dấu. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nút vị trí của tôi được nhấp vào.

Nếu listener trả về true, sự kiện sẽ được sử dụng và hành vi mặc định sẽ không xảy ra. Nếu trả về false, hành vi mặc định sẽ diễn ra (tức là máy ảnh di chuyển sao cho nằm giữa vị trí của người dùng).

Các tham số

trình nghe	Lệnh gọi lại được gọi khi nhấp vào nút Vị trí của tôi.

công khai khoảng trống setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)

Đặt lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi thay đổi vị trí.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi thay đổi.

công khai khoảng trống setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener)

Đặt lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi (biểu thị vị trí của người dùng) được nhấp vào.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi được nhấp vào.

công khai khoảng trống setOnPoiClickListener (GoogleMap.OnPoiClickListener)

Thiết lập trình nghe sẽ được kích hoạt khi người dùng nhấp hoặc nhấn vào một POI.

Truyền null để xoá trình nghe.

Các tham số

trình nghe

công khai khoảng trống setOnPolygonClickListener (GoogleMap.OnPolygonClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nhấp vào đa giác.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi nhấp vào một đa giác. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai khoảng trống setOnPolylineClickListener (GoogleMap.OnPolylineClickListener trình nghe)

Đặt lệnh gọi lại được gọi khi nhấp vào một hình nhiều đường.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi một hình nhiều đường được nhấp vào. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai khoảng trống setPadding (int left, int top, int right, int bottom)

Đặt khoảng đệm trên bản đồ.

Phương thức này cho phép bạn xác định một khu vực nhìn thấy trên bản đồ, để báo hiệu cho bản đồ rằng các phần của bản đồ xung quanh cạnh có thể bị che khuất bằng cách đặt khoảng đệm ở một trong 4 cạnh của bản đồ. Hàm ánh xạ sẽ được điều chỉnh cho phù hợp với khoảng đệm. Ví dụ: các nút điều khiển thu phóng, la bàn, thông báo bản quyền và biểu trưng của Google sẽ được di chuyển cho vừa với khu vực đã xác định, chuyển động của máy ảnh sẽ tương ứng với trung tâm của khu vực hiển thị, v.v.

Các tham số

trái	số pixel đệm được thêm vào bên trái bản đồ.
nửa đầu lượt đấu	số pixel đệm được thêm vào trên đầu bản đồ.
phải	số pixel đệm được thêm vào bên phải bản đồ.
nửa sau lượt đấu	số pixel khoảng đệm cần được thêm vào cuối bản đồ.

public void setTrafficEnabled (boolean enabled)

Bật hoặc tắt lớp giao thông.

Các tham số

đang bật

công khai khoảng trống snapshot (GoogleMap.SnapshotReadyCallback)

Chụp ảnh nhanh về bản đồ.

Bạn có thể sử dụng ảnh chụp nhanh trong ứng dụng khi bản đồ tương tác gặp khó khăn hoặc không thể sử dụng. Ví dụ: bạn có thể sử dụng hình ảnh tạo bằng phương thức snapshot() để hiển thị hình thu nhỏ của bản đồ trong ứng dụng hoặc ảnh chụp nhanh trong trung tâm thông báo.

Lưu ý: Không được truyền hình ảnh của bản đồ đến máy chủ của bạn hoặc sử dụng hình ảnh bên ngoài ứng dụng. Nếu bạn cần gửi bản đồ cho một ứng dụng hoặc người dùng khác, hãy gửi dữ liệu cho phép họ tạo lại bản đồ cho người dùng mới thay vì ảnh chụp nhanh.

Các tham số

số gọi lại	Phương thức gọi lại được gọi khi chụp nhanh.

công khai khoảng trống ảnh chụp nhanh (GoogleMap.SnapshotReadyCallback, bitmap Bitmap)

Chụp ảnh nhanh về bản đồ.

Phương thức này tương đương với snapshot(SnapshotReadyCallback) nhưng cho phép bạn cung cấp Bitmap được phân bổ trước. Nếu bitmap không khớp với kích thước hiện tại của bản đồ, thì một bitmap khác sẽ được phân bổ phù hợp với kích thước của bản đồ.

Mặc dù trong hầu hết các trường hợp, đối tượng mà phương thức gọi lại truyền đều giống với đối tượng được cung cấp trong thông số cho phương thức này, nhưng trong một số trường hợp, đối tượng được trả về có thể khác (ví dụ: nếu kích thước của khung hiển thị đã thay đổi trước thời điểm thực sự chụp ảnh chụp nhanh). Do đó, bạn chỉ nên tin tưởng nội dung của bitmap được truyền bằng phương thức gọi lại.

Các tham số

số gọi lại	Phương thức gọi lại được gọi khi chụp nhanh.
bitmap	Một bitmap được phân bổ trước. Nếu `null`, sẽ hoạt động như `snapshot(SnapshotReadyCallback)`.

public void stopAnimation ()

Dừng ảnh động của máy ảnh nếu có một ảnh đang diễn ra. Khi phương thức này được gọi, máy ảnh sẽ ngừng di chuyển ngay lập tức và vẫn ở vị trí đó.