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

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 chọ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 chọ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
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 chọ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 chọ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 chọ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 chọ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
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
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

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à:

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)

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í.

Đặ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í đó.