Đâ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 pháp
liên quan đến bản đồ. Bạn không thể tạo trực tiếp đối tượng GoogleMap
mà thay vào đó, bạn phải lấy một đố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.
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 trường hợp 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 thông số như vị trí, mức thu phóng, góc nghiêng và góc phương tiện. Để biết thêm thông tin, hãy xem nội dung 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 dành cho nhà phát triển SDK Google Maps dành cho Android.
Tóm tắt các 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 tất hoặc bị huỷ. | |
giao diện | GoogleMap.InfoWindowAdapter | Cung cấp chế độ xem để hiển thị cửa sổ thông tin tuỳ chỉnh. | |
giao diện | GoogleMap.OnCameraChangeListener |
Giao diện này không được dùng nữa.
Được thay thế bằng GoogleMap.OnCameraMoveStartedListener , GoogleMap.OnCameraMoveListener và GoogleMap.OnCameraIdleListener . Phương thức 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 là không xác định.
|
|
giao diện | GoogleMap.OnCameraIdleListener | Giao diện gọi lại khi quá trình di chuyển máy ảnh kết thúc. | |
giao diện | GoogleMap.OnCameraMoveCANCELListener | Giao diện gọi lại khi máy ảnh dừng chuyển động hoặc khi máy ảnh bắt đầu chuyển vì 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 thời điểm chuyển động của máy ảnh bắt đầu. | |
giao diện | GoogleMap.OnCircleClickListener | Giao diện gọi lại khi người dùng 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 người dùng nhấp vào lớp phủ mặt đất. | |
giao diện | GoogleMap.OnIndoorStateChangeListener | Trình xử lý 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 điểm đánh dấu. | |
giao diện | GoogleMap.OnInfoWindowCloseListener | Giao diện gọi lại cho các sự kiện gần trên cửa sổ thông tin của đ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 đ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.OnMap LoadCallback | Giao diện gọi lại khi bản đồ đã hoàn tất quá trình kết xuất. | |
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 một điểm đánh dấu được nhấp hoặc nhấn. | |
giao diện | GoogleMap.OnMarkerDragListener | Giao diện gọi lại cho các sự kiện kéo trên các điểm đánh dấu. | |
giao diện | GoogleMap.OnMyLocationButtonClickListener | Giao diện gọi lại khi người dùng nhấp vào nút Vị trí của tôi. | |
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à sử dụng nguồn điện cải thiện, đồng thời sử dụng dấu chấm màu xanh dương "My Location" 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 dành cho nhà phát triển 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 thao tác nhấn POI. | |
giao diện | GoogleMap.OnọcClickListener | Giao diện gọi lại khi người dùng nhấp vào một đa giác. | |
giao diện | GoogleMap.OnPolylineClickListener | Giao diện gọi lại khi người dùng nhấp vào nhiều đường. | |
giao diện | GoogleMap.SnapshotReadyCallback | Giao diện gọi lại để thông báo thời điểm chụp ảnh nhanh. |
Bản tóm tắt không đổi
int | MAP_TYPE_HYBRID | Vệ tinh có bản đồ các đường phố lớn trong suốt. |
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 pháp công khai
Vòng tròn | |
Lớp phủ trên mặt đất | |
Điểm đánh dấu | |
Đa giác | |
Polyline | |
TileOverlay | |
void |
animateCamera(bản cập nhật của CameraUpdate)
Tạo ảnh động chuyển động của máy ảnh từ vị trí hiện tại đến vị trí đã xác định trong
bản cập nhật.
|
void |
animateCamera(cập nhật CameraUpdate, lệnh gọi lại GoogleMap.CancelableCallback)
Tạo ảnh động chuyển động của máy ảnh từ vị trí hiện tại đến vị trí đã 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 thành.
|
void |
animateCamera(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 với một ảnh động trong thời lượng đã chỉ định và gọi một lệnh gọi lại không bắt buộc khi hoàn tất.
|
void |
xoá()
Xóa tất cả các điểm đánh dấu, nhiều đường, đa giác, lớp phủ, v.v. khỏi bản đồ.
|
Vị trí máy ảnh |
getCameraPosition()
Lấy thông tin vị trí hiện tại của máy ảnh.
|
Trong nhà |
getFocused Xây dựng()
Xem toà nhà hiện đang được lấy tiêu điểm.
|
int |
getMapType()
Nhận loại bản đồ hiện đang hiển thị.
|
số thực dấu phẩy động |
getMaxZoomLevel()
Trả về mức thu phóng tối đa cho vị trí máy ảnh hiện tại.
|
số thực dấu phẩy động |
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.
hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi cung cấp tính năng tìm vị trí và sử dụng nguồn điện cải thiện, đồng thời sử dụng dấu chấm màu xanh dương "My Location" Hãy xem MyLocationDemoActivity trong thư mục
ứng dụng mẫu để xem mã mẫu hoặc Hướng dẫn
dành cho nhà phát triển vị trí.
|
Phép chiếu |
getProjection ()
Trả về đối tượng
Projection mà bạn có thể dùng để chuyển đổi giữa toạ độ màn hình và toạ độ (vĩ độ/kinh độ). |
UiSettings (Cài đặt) |
getUiSettings()
Nhận cài đặt giao diện người dùng cho bản đồ.
|
boolean |
isBuildsEnabled()
Trả về kết quả xác định lớp các toà nhà 3D đã được bật hay chưa.
|
boolean |
isIndoorEnabled()
Nhận xem bản đồ trong nhà hiện có được bật hay không.
|
boolean |
isMyLocationEnabled()
Nhận trạng thái của lớp vị trí của tôi.
|
boolean |
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)
Điều chỉnh vị trí máy ảnh theo hướng dẫn xác định trong lần cập nhật.
|
void |
resetMinMaxZoomPreferences()
Xóa bất kỳ ranh giới thu phóng trên và dưới được chỉ định trước đó.
|
void |
setBuildsEnabled(bật boolean)
Bật hoặc tắt lớp tòa nhà 3D.
|
void |
setContentDescription(Nội dung mô tả chuỗi)
Đặt contentDescription dành cho bản đồ.
|
boolean |
setIndoorEnabled(bật boolean)
Đặt xem bạn có muốn bật bản đồ trong nhà không.
|
void |
setInfoWindowAdapter(bộ chuyển đổi GoogleMap.InfoWindowAdapter)
Đặt trình kết xuất 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 sẽ không di chuyển ra ngoài những ranh giới này.
|
void | |
boolean | |
void |
setMapType(loại thông tin)
Đặt loại ô bản đồ sẽ hiển thị.
|
void |
setMaxZoomPreferences(nổi maxZoomPreference)
Đặt giới hạn trên ưa thích cho tính năng thu phóng máy ảnh.
|
void |
setMinZoomPreferences(nổi minZoomPreference)
Đặt giới hạn dưới ưa thích cho tính năng thu phóng 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.
Được 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 lệnh gọi lại được gọi khi chuyển động của máy ảnh kết thúc.
|
void |
setOnCameraMoveCANCELListener(trình nghe GoogleMap.OnCameraMovecancelledListener)
Đặt lệnh gọi lại được gọi khi một loại ảnh động mới bị ngừng hoặc làm gián đoạn chuyển động của máy ảnh.
|
void |
setOnCameraMoveListener (trình nghe GoogleMap.OnCameraMoveListener)
Đặt lệnh gọi lại được gọi nhiều lần trong khi máy ảnh 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 vòng kết nối được nhấp vào.
|
void |
setOnGroundOverlayClickListener(trình nghe GoogleMap.OnGroundOverlayClickListener)
Đặt lệnh gọi lại được gọi khi bạn nhấp vào lớp phủ mặt đất.
|
void |
setOnIndoorStateChangeListener(trình nghe GoogleMap.OnIndoorStateChangeListener)
Đặt hoặc xoá trình nghe cho các 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 đ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 là đóng.
|
void |
setOnInfoWindowLongClickListener(trình nghe GoogleMap.OnInfoWindowLongClickListener)
Đặt lệnh gọi lại được gọi khi cửa sổ thông tin điểm đánh dấu được nhấn và giữ.
|
void |
setOnMapClickListener(trình nghe GoogleMap.OnMapClickListener)
Đặt lệnh gọi lại được gọi khi bản đồ được nhấn.
|
void |
setOnMapNhậtCallback(lệnh gọi lại GoogleMap.OnMapLoadingCallback)
Đặt lệnh gọi lại được gọi khi bản đồ này hoàn tất quá trình kết xuất.
|
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 một điểm đánh dấu được nhấp vào.
|
void |
setOnMarkerDragListener(trình nghe GoogleMap.OnMarkerDragListener)
Đặt lệnh gọi lại được gọi khi một điểm đánh dấu được kéo.
|
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.
hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi cung cấp tính năng tìm vị trí và sử dụng nguồn điện cải thiện, đồng thời sử dụng dấu chấm màu xanh dương "My Location" Hãy xem MyLocationDemoActivity trong thư mục
ứng dụng mẫu để xem mã mẫu hoặc Hướng dẫn
dành cho nhà phát triển vị trí.
|
void |
setOnMyLocationClickListener(trình nghe GoogleMap.OnMyLocationClickListener)
Đặt lệnh gọi lại được gọi khi dấu 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)
Đặt 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 |
setOnOnClickClickListener(trình nghe GoogleMap.OnọcClickListener)
Đặt lệnh gọi lại được gọi khi đa giác được nhấp vào.
|
void |
setOnPolylineClickListener(trình nghe GoogleMap.OnPolylineClickListener)
Đặt lệnh gọi lại được gọi khi một hình nhiều đường được nhấp vào.
|
void |
setPadding(int left, int top, int right, int bottom)
Đặt khoảng đệm trên bản đồ.
|
void |
setTrafficEnabled(bật boolean)
Bật hoặc tắt lớp lưu lượng truy cập.
|
void | |
void | |
void |
stopAnimation()
Dừng ảnh động của máy ảnh nếu đang có ảnh động.
|
Tóm tắt phương pháp kế thừa
Các hằng số
public static final int MAP_TYPE_HYBRID
Vệ tinh có bản đồ các đường phố lớn trong suốt.
public static final in in MAP_TYPE_NONE
Không có ô bản đồ cơ sở nào.
public static final in in MAP_TYPE_NORMAL
Bản đồ cơ bản.
public static final in in MAP_TYPE_SATELLITE
Bản đồ vệ tinh không có nhãn.
public static final in in MAP_TYPE_TERRAIN
Bản đồ địa hình.
Phương thức công khai
công khai Circle addCircle (CircleOptions tùy 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 tùy chọn vòng kết nối xác định cách hiển thị Vòng kết nối |
---|
Trả về
- Đối tượng
Circle
được thêm vào bản đồ
công khai GroundOverlay addgroundOverlay (Tùy chọn GroundOverlay)
Thêm một hình ảnh vào bản đồ này.
Các tham số
tùy chọn | Đối tượng tùy chọn lớp phủ mặt đất sẽ xác định cách hiển thị lớp phủ. Các tuỳ chọn phải có một hình ảnh (AnchoredBitmap) và vị trí đã chỉ định. |
---|
Trả về
GroundOverlay
đã được thêm vào bản đồ.
Gửi
Mục ngoại lệ không hợp lệ | nếu hình ảnh hoặc vị trí không được chỉ định trong các tùy chọn. |
---|
công khai Marker addMarker (Tùy chọn Marker)
Thêm điểm đánh dấu vào bản đồ này.
Biểu tượng đánh dấu được hiển thị trên bản đồ tại vị trí Mark.position. Khi nhấp vào điểm đánh dấu, máy ảnh sẽ được căn giữa trên điểm đánh dấu. Nếu bạn đánh dấu được tiêu đề này, 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, 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 các tùy chọn điểm đánh dấu xác định cách hiển thị điểm đánh dấu. |
---|
Trả về
Marker
đã được thêm vào bản đồ.
công khai đa giác addđa (Tùy chọn đa giác)
Thêm một đa giác vào bản đồ này.
Các tham số
tùy chọn | Đối tượng tùy chọn đa giác xác định cách hiển thị Đa giác. |
---|
Trả về
- Đối tượng
Polygon
được thêm vào bản đồ.
công khai Polyline addPolyline (Tùy chọn PolylylineOptions)
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 tùy chọn đa đường xác định cách hiển thị nhiều đường kẻ. |
---|
Trả về
- Đối tượng
Polyline
đã được thêm vào bản đồ.
công khai TileOverlay addTileOverlay (TileOverlayOptions tùy 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 ý rằng không giống như các lớp phủ khác, nếu bản đồ được tạo lại, thì lớp phủ ô sẽ không tự động được 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 tùy chọn lớp phủ ô xác định cách hiển thị lớp phủ. Các tuỳ chọn phải được chỉ định TileProvider , nếu không sẽ gửi một IllegalArgumentException . |
---|
Trả về
TileOverlay
đã được thêm vào bản đồ.
Gửi
Mục ngoại lệ không hợp lệ | nếu TileProvider chưa được chỉ định trong các tùy chọn.
|
---|
public void animateCamera (CameraUpdate cập nhật)
Tạo ảnh động chuyển động của máy ảnh từ vị trí hiện tại đến vị trí đã xác định trong
bản cập nhật. Trong ảnh động, lệnh gọi đến getCameraPosition()
sẽ trả về vị trí trung gian của máy ảnh.
Hãy xem CameraUpdateFactory
để biết tập hợp các nội dung cập nhật.
Các tham số
cập nhật | Thay đổi sẽ được áp dụng cho máy ảnh. |
---|
public void animateCamera (CameraUpdate cập nhật, GoogleMap.CancelableCallback gọi lại)
Tạo ảnh động chuyển động của máy ảnh từ vị trí hiện tại đến vị trí đã 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 thành. Hãy xem CameraUpdateFactory
để biết tập hợp các nội dung cập nhật.
Trong ảnh động, lệnh gọi đến getCameraPosition()
sẽ trả về vị trí trung gian của máy ảnh.
Các tham số
cập nhật | Thay đổi sẽ được áp dụng cho máy ảnh. |
---|---|
cuộc 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 lại. 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. Không cập nhật hoặc tạo ảnh động cho máy ảnh từ trong onCancel() .
|
public void animateCamera (CameraUpdate cập nhật, int DurationM, GoogleMap.CancelableCallback gọi lại)
Di chuyển bản đồ theo nội dung cập nhật với một ảnh động trong thời lượng đã chỉ định 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 tập hợp các nội dung cập nhật.
Nếu được gọi trong ảnh động, getCameraPosition()
sẽ trả về vị trí hiện tại của máy ảnh đang chạy.
Các tham số
cập nhật | |
---|---|
DurationM | Thời lượng của ảnh động tính bằng mili giây. Điều này phải hoàn toàn là số dương, nếu không, IllegalArgumentException sẽ được gửi đi.
|
cuộc gọi lại | 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 đã hoàn tất tự nhiên, lệnh gọi lại sẽ
được thông báo bằng onFinish() . Nếu ảnh động dừng do chuyển động của máy ảnh sau đó hoặc cử chỉ của người dùng bị gián đoạn, thì 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 theo phương thức huỷ. Nếu không bắt buộc phải thực hiện lệnh gọi lại, hãy để lệnh gọi lại là null . |
public void xoá ()
Xóa tất cả các điểm đánh dấu, nhiều đường, đa giác, lớp phủ, v.v. khỏi bản đồ.
công khai CameraPosition getCameraPosition ()
Lấy thông tin 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 bài viết Máy ảnh và chế độ xem.
Trả về
- Vị trí hiện tại của Máy ảnh.
public Trong nhà getFocusedBuild ()
Xem toà nhà hiện đang được lấy tiêu điểm.
Trả về
- Toà nhà được lấy tiêu điểm hiện tại hoặc
null
nếu không có tòa nhà nào được lấy tiêu điểm.
public int getMapType ()
Nhận loại bản đồ hiện đang hiển thị. Hãy xem MAP_TYPE_NORMAL
, MAP_TYPE_SATELLITE
, MAP_TYPE_TERRAIN
để biết các giá trị có thể sử dụng.
Trả về
- Loại bản đồ.
công khai nổi getMaxZoomLevel ()
Trả về mức thu phóng tối đa cho vị trí máy ảnh hiện tại. Thao tác này sẽ xem xét loại bản đồ hiệ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ả về
- Mức thu phóng tối đa hiện có ở vị trí máy ảnh hiện tại.
công khai nổi getMinZoomLevel ()
Trả về mức thu phóng tối thiểu. Tất cả các vị trí (không giống như mức thu phóng tối đa) đều giống nhau 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ả về
- Mức thu phóng tối thiểu hiện có.
công khai getMyLocation ()
Phương thức này không được dùng nữa.
hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi cung cấp tính năng tìm vị trí và sử dụng nguồn điện cải thiện, đồng thời sử dụng dấu chấm màu xanh dương "My Location" Hãy xem MyLocationdemoActivity trong thư mục ứng dụng mẫu để xem mã mẫu hoặc Hướng dẫn cho nhà phát triển vị trí.
Trả về vị trí của người dùng hiện đang hiển thị hoặc null
nếu không có dữ liệu vị trí.
Trả về
user location
hiện đang hiển thị.
Gửi
legalStateException | nếu lớp vị trí của tôi chưa được bật. |
---|
công khai Chiếu getProjection ()
Trả về đối tượng Projection
mà bạn có thể 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 thực hiện phép chiếu một lần trên mỗi màn hình. Google Maps sử dụng phép chiếu Mercator để tạo bản đồ từ dữ liệu địa lý và chuyển đổi các điểm trên bản đồ thành các toạ độ địa lý.
Trả về
Projection
của bản đồ ở trạng thái hiện tại.
công khai UiSettings getUiSettings ()
Nhận cài đặt giao diện người dùng cho bản đồ.
Trả về
UiSettings
cho bản đồ này.
boolean công khai isBuildsEnabled ()
Trả về kết quả xác định lớp các toà nhà 3D đã được bật hay chưa.
Trả về
true
nếu đã bật các toà nhà; nếu không thìfalse
.
boolean công khai isIndoorEnabled ()
Nhận xem bản đồ trong nhà hiện có được bật hay không.
Trả về
true
nếu bản đồ trong nhà được bật;false
nếu bản đồ trong nhà bị tắt;
boolean công khai isMyLocationEnabled ()
Nhận trạng thái của lớp vị trí của tôi.
Trả về
true
nếu lớp vị trí của tôi được bật; nếu khôngfalse
.
boolean công khai isTrafficEnabled ()
Kiểm tra xem bản đồ có đang vẽ dữ liệu giao thông hay không. Tuỳ thuộc vào tính sẵn có của dữ liệu lưu lượng truy cập.
Trả về
true
nếu dữ liệu lưu lượng truy cập được bật;false
nếu không được bật.
public void moveCamera (CameraUpdate cập nhật)
Điều chỉnh vị trí máy ảnh theo hướng dẫn xác định trong lần cập nhật. Quá trình di chuyển sẽ
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
để biết tập hợp các nội dung cập nhật.
Các tham số
cập nhật | Thay đổi sẽ được áp dụng cho máy ảnh. |
---|
public void resetMinMaxZoomPreferences ()
Xóa bất kỳ ranh giới thu phóng trên và dưới được chỉ định trước đó.
public void setBuildsEnabled(boolean đã bật)
Bật hoặc tắt lớp tòa nhà 3D.
Các tham số
đã bật | true để bật lớp toà nhà 3D; false để vô hiệu hoá toà nhà 3D.
|
---|
public void setContentDescription (Mô tả chuỗi)
Đặt contentDescription dành cho bản đồ.
Kỹ thuật này dùng để cung cấp thông tin mô tả bằng giọng nói của bản đồ ở chế độ hỗ trợ tiếp cận. Giá trị mặc định là "Google Map"
Các tham số
mô tả | một chuỗi dùng làm nội dung mô tả. |
---|
boolean công khai setIndoorEnabled (boolean đã bật)
Đặt xem bạn có muốn bật bản đồ trong nhà không. Hiện tại, các 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 một 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 được bật trên một bản đồ khác, sẽ không có điều gì xảy ra và bản đồ này sẽ trả về false
. Khi trong nhà không được bật cho bản đồ, tất cả các phương thức liên quan đến trong nhà sẽ trả về giá trị null
hoặc false
.
Các tham số
đã bật | true để thử bật bản đồ trong nhà; false để tắt bản đồ trong nhà. |
---|
Trả về
- xem có thể bật bản đồ trong nhà hay không.
public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter))
Đặt trình kết xuất 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ự với bản đồ. Nếu bản đồ được tạo lại (ví dụ: do có sự thay đổi về cấu hình), bạn phải đảm bảo rằng mình gọi lại phương thức này để duy trì hoạt động tùy chỉnh.
Các tham số
bộ chuyển đổi | Bộ chuyển đổi để sử dụng cho nội dung của cửa sổ thông tin hoặc null để sử dụng tính năng hiển thị nội dung mặc định trong cửa sổ thông tin.
|
---|
public void setLatLngBoundsForCameraTarget (LatLngBounds giới hạn)
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 sẽ không di chuyển ra ngoài những ranh giới này.
Đặt thành rỗng để xóa hoàn toàn hộp giới hạn. Các giới hạn mới thay thế cho bất kỳ ranh giới giới hạn nào được 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 đó để tôn trọng các giới hạn đó nếu có thể. Xin lưu ý rằng có một số vấn đề kỹ thuật có thể khiến SDK không thể đạt được mục tiêu máy ảnh một cách nghiêm ngặt trong giới hạn. Ví dụ: lỗi làm tròn độ chính xác 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 trong đó. |
---|
public void setLocationSource (LocationSource)) ()
Thay thế nguồn vị trí của lớp vị trí của tôi.
Các tham số
nguồn | Một 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.
|
---|
boolean công khai setMapStyle (kiểu MapStyleOptions)
Thiết lập kiểu cho bản đồ cơ sở.
Khi chọn các kiểu đó, bạn có thể áp dụng kiểu tuỳ chỉnh cho các đối tượng và phần tử trên bản đồ.
Hãy xem MapStyleOptions
để biết chi tiết về định nghĩa kiểu.
Đặt thành rỗng để xóa mọi kiểu tùy chỉnh trước đó.
Các tham số
kiểu |
---|
Trả về
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 vấn đề vớiMapStyleOptions
, bao gồm, chẳng hạn như JSON không thể phân tích cú pháp kiểu, loại tính năng không nhận dạng được, loại thành phần không nhận dạng được, hoặc khóa tạo 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.
public void setMapType (int type)
Đặt loại ô bản đồ sẽ hiển thị. Các giá trị được cho 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 với đường và nhãn.MAP_TYPE_TERRAIN
: Dữ liệu địa hình.MAP_TYPE_NONE
: Không có ô bản đồ cơ sở nào.
Các tham số
loại | Loại bản đồ để hiển thị. |
---|
public void setMaxZoomPreferences (float maxZoomPreference)
Đặt giới hạn trên ưa thích cho tính năng thu phóng 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 đó để tuân theo mức tối đa đó (nếu có thể). Hãy lưu ý rằng một số yếu tố kỹ thuật cần cân nhắc có thể khiến SDK không cho phép người dùng phóng to quá mức 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 so với ô bản đồ cơ sở.
SDK sẽ giải quyết mọi xung đột trong các giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu cao hơn mức tối đa hiện tại, thì SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thấp hơn mức tối thiểu, thì SDK sẽ sử dụng giá trị tối đa mới cho cả giá trị 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à mức tối đa là 14. Sau đó, bạn đặt mức thu phóng tối đa là 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ố
maxZoomPreferences | Giới hạn trên được ưu tiên. |
---|
public void setMinZoomPreferences (float minZoomPreference))
Đặt giới hạn dưới ưa thích cho tính năng thu phóng 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 đó để tuân theo mức tối thiểu đó (nếu có thể). Xin lưu ý rằng có một số vấn đề kỹ thuật có thể khiến SDK không cho phép người dùng thu phóng quá thấp.
SDK sẽ giải quyết mọi xung đột trong các giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu cao hơn mức tối đa hiện tại, thì SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thấp hơn mức tối thiểu, thì SDK sẽ sử dụng giá trị tối đa mới cho cả giá trị 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à mức tối đa là 14. Sau đó, bạn đặt mức thu phóng tối thiểu là 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 được ưu tiên. |
---|
public void setMyLocationEnabled (boolean đã bật)
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 sẽ liên tục vẽ chỉ báo về vị trí hiện tại và góc phương vị của người dùng, đồng thời hiển thị các tuỳ chọn đ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 vị trí và góc phương vị của máy ảnh).
Để sử dụng tính năng lớp địa điểm của tôi, bạn cần yêu cầu quyền cho ACCESS_COARSE_LOCATION
hoặc ACCESS_FINE_LOCATION
trừ khi bạn đã đặt nguồn nguồn vị trí tùy chỉnh.
Nếu bạn đặt một nguồn vị trí tùy chỉnh thông qua setLocationSource(LocationSource)
, thì SDK Google Maps
dành cho Android sẽ không kiểm tra xem những quyền trên có được cấp hay không. 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 cho nguồn vị trí tùy chỉnh của bạn.
Các tham số
đã bật | true để bật; false để tắt. |
---|
Gửi
Trường hợp ngoại lệ về bảo mật | nếu quyền truy cập thông tin vị trí không được cấp. |
---|
public void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener trình nghe)
Phương thức này không còn được dùng nữa.
Được thay thế bằng setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)
, setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)
, setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)
và setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)
.
Đặ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 gọi khi máy ảnh thay đổi. Để huỷ lệnh gọi lại, hãy sử dụng null . |
---|
public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener trình nghe)
Đặt lệnh gọi lại được gọi khi chuyển động của máy ảnh kết thúc.
Các tham số
trình nghe | Lệnh gọi lại đã gọi. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnCameraMovecancelledListener (GoogleMap.OnCameraMovecancelledListener trình nghe)
Đặt lệnh gọi lại được gọi khi một loại ảnh động mới bị ngừng hoặc làm gián đoạn chuyển động của máy ảnh.
Các tham số
trình nghe | Lệnh gọi lại đã gọi. Để huỷ lệnh gọi lại, hãy sử dụng null . Đừng
cập nhật hoặc tạo ảnh động cho máy ảnh từ trong onCameraMoveCanceled() .
|
---|
public void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener trình nghe)
Đặt lệnh gọi lại được gọi nhiều lần trong khi máy ảnh chuyển động. Lệnh gọi lại có thể được gọi thường xuyên một lần trong mỗi khung và không nên 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 đã gọi. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener trình nghe)
Đặ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 đã gọi. Để huỷ lệnh gọi lại, hãy sử dụng null . Đừng
cập nhật hoặc tạo ảnh động cho máy ảnh từ trong onCameraMoveStarted() .
|
---|
public void setOnCircleClickListener (Trình nghe GoogleMap.OnCircleClickListener)
Đặt lệnh gọi lại được gọi khi vòng kết nối được nhấp vào.
Các tham số
trình nghe | Lệnh gọi lại được gọi khi vòng kết nối được nhấp vào. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnGroundOverlayClickListener (Trình nghe GoogleMap.OnGroundOverlayClickListener)
Đặt lệnh gọi lại được gọi khi bạn nhấp vào lớp phủ mặt đất.
Các tham số
trình nghe | Lệnh gọi lại được gọi khi lớp phủ mặt đất được nhấp vào. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener trình nghe)
Đặt hoặc xoá trình nghe cho các sự kiện trong nhà. Chỉ có thể thiết lập một trình nghe. Việc thiết lập một trình nghe mới sẽ xoá trình nghe trước đó.
Các tham số
trình nghe | trình nghe cho các sự kiện trong nhà nếu không có giá trị rỗng; nếu không, trình nghe sẽ xoá |
---|
public void setOnInfoWindowClickListener (Trình nghe GoogleMap.OnInfoWindowClickListener)
Đặt lệnh gọi lại được gọi khi cửa sổ thông tin đ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 người dùng nhấp vào cửa sổ thông tin điểm đánh dấu. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnInfoWindowClosedListener (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 là đó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ỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnInfoWindowLongClickListener (Trình nghe GoogleGoogle.OnInfoWindowLongClickListener)
Đặt lệnh gọi lại được gọi khi cửa sổ thông tin điểm đánh dấu được nhấn và giữ.
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ữ cửa sổ thông tin của một điểm đánh dấu. Để
huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnMapClickListener (Trình nghe GoogleMap.OnMapClickListener)
Đặt lệnh gọi lại được gọi khi bản đồ được nhấn.
Các tham số
trình nghe | Lệnh gọi lại được gọi khi bản đồ được nhấn. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnMapLoadingCallback (GoogleMap.OnMaploadingCallback)
Đặt lệnh gọi lại được gọi khi bản đồ này hoàn tất quá trình kết xuất. 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 đồ đã được 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 đề kết nối hoặc nếu bản đồ liên tục thay đổi và không bao giờ tải xong do người dùng liên tục tương tác với bản đồ.
Các tham số
cuộc gọi lại | Lệnh gọi lại được gọi khi bản đồ hoàn tất quá trình kết xuất. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnMapLongClickListener (Trình nghe GoogleMap.OnMapLongClickListener)
Đặ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 nhấn và giữ bản đồ. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnMarkerClickListener (Trình nghe GoogleMap.OnMarkerClickListener)
Đặt lệnh gọi lại được gọi khi một đ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 một điểm đánh dấu được nhấp vào. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener trình nghe)
Đặt lệnh gọi lại được gọi khi một điểm đánh dấu được kéo.
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 đánh dấu. Để huỷ lệnh gọi lại, hãy sử 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ẽ xảy ra (tức là máy ảnh di chuyển sao cho được căn giữa vào 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 nút Vị trí của tôi được nhấp vào. |
---|
public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener người nghe)
Phương thức này không được dùng nữa.
hãy sử dụng com.google.android.gms.location.FusedLocationProviderApi.
FusedLocationProviderApi cung cấp tính năng tìm vị trí và sử dụng nguồn điện cải thiện, đồng thời sử dụng dấu chấm màu xanh dương "My Location" Hãy xem MyLocationdemoActivity trong thư mục ứng dụng mẫu để xem mã mẫu hoặc Hướng dẫn cho nhà phát triển vị trí.
Đặt lệnh gọi lại được gọi khi dấu 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 Vị trí của tôi thay đổi. |
---|
public void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener trình nghe)
Đặt lệnh gọi lại được gọi khi dấu 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. |
---|
public void setOnPoiClickListener (Trình nghe GoogleMap.OnPoiClickListener)
Đặt 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.
Chuyển null
để xoá trình nghe.
Các tham số
trình nghe |
---|
public void setOnMultipleClickListener (Trình nghe GoogleMap.OnMultipleClickListener)
Đặt lệnh gọi lại được gọi khi đa giác được nhấp vào.
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 đa giác. Để huỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setOnPolylineClickListener (Trình nghe GoogleGoogle.OnPolylineClickListener)
Đặt lệnh gọi lại được gọi khi một hình nhiều đường được nhấp vào.
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ỷ lệnh gọi lại, hãy sử dụng null .
|
---|
public void setPadding (int left, int top, int right, int bottom)
Đặt khoảng đệm trên bản đồ.
Phương pháp này cho phép bạn xác định một vùng hiển thị trên bản đồ để báo hiệu cho bản đồ rằng các phần của bản đồ xung quanh các cạnh có thể bị che khuất bằng cách đặt khoảng đệm trên mỗi cạnh trong số bốn cạnh của bản đồ. Các hàm bản đồ 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 Google sẽ được di chuyển cho vừa với vùng đã xác định, các 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ố
left | số lượng pixel đệm cần thêm vào bên trái bản đồ. |
---|---|
đầu | số lượng pixel đệm cần thêm vào đầu bản đồ. |
phải | số pixel khoảng đệm cần thêm vào bên phải bản đồ. |
dưới cùng | số lượng pixel đệm cần thêm vào cuối bản đồ. |
public void setTrafficEnabled (boolean đã bật)
Bật hoặc tắt lớp lưu lượng truy cập.
Các tham số
đã bật |
---|
public void snapshot (GoogleMap.SnapshotReadyCallback))
Chụp ảnh nhanh bản đồ.
Bạn có thể sử dụng ảnh chụp nhanh trong ứng dụng khi không thể hoặc không thể sử dụng bản đồ tương tác. Ví dụ: hình ảnh được tạo bằng phương thức snapshot()
có thể được dùng để hiển thị hình thu nhỏ của bản đồ trong ứng dụng hoặc hiển thị ảnh chụp nhanh trong trung tâm thông báo.
Lưu ý: Không được truyền hình ảnh bản đồ đến máy chủ của bạn hoặc sử dụng 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ố
cuộc gọi lại | Phương thức gọi lại được gọi khi chụp ảnh nhanh. |
---|
public void snapshot (GoogleMap.SnapshotReadyCallback, Bitmap bitmap)
Chụp ảnh nhanh 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 đồ, một bitmap khác sẽ được phân bổ cho 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 được chuyển qua phương thức gọi lại 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 chế độ xem đã thay đổi theo thời gian thực hiện ảnh chụp nhanh). Do đó, bạn chỉ nên tin tưởng nội dung của bitmap được phương thức gọi lại chuyển đến.
Các tham số
cuộc gọi lại | Phương thức gọi lại được gọi khi chụp ảnh nhanh. |
---|---|
bitmap | bitmap được phân bổ trước. Nếu null , hoạt động như snapshot(SnapshotReadyCallback) .
|
public void stopAnimation ()
Dừng ảnh động của máy ảnh nếu đang có ảnh động. Khi phương thức này được gọi, máy ảnh sẽ dừng di chuyển ngay lập tức và giữ nguyên vị trí.