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.

CameraUpdateFactory

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

Một lớp chứa các phương thức tạo đối tượng CameraUpdate thay đổi máy ảnh của bản đồ. Để sửa đổi máy ảnh của bản đồ, hãy gọi animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) hoặc moveCamera(CameraUpdate) bằng cách sử dụng đối tượng CameraUpdate được tạo với lớp này.

Ví dụ: để phóng to bản đồ, bạn có thể sử dụng mã sau:

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

Trước khi sử dụng bất kỳ phương thức nào từ lớp này, bạn phải thực hiện một trong những cách sau để đảm bảo rằng lớp này đã được khởi tạo:

Chờ GoogleMap xuất hiện trên MapFragment hoặc MapView mà bạn đã thêm vào đơn đăng ký. Bạn có thể nhận GoogleMap bằng cách gọi getMapAsync() và chờ lệnh gọi lại onMapReady(GoogleMap map).
Gọi cho initialize(Context). Chỉ cần GooglePlayServicesNotAvailableException không được gửi, lớp này sẽ được hiển thị chính xác đã khởi chạy.

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

Để biết thêm thông tin, hãy đọc bài viết Máy ảnh và chế độ xem hướng dẫn cho nhà phát triển.

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

tĩnh CameraUpdate	newCameraPosition(CameraPosition cameraPosition) Trả về `CameraUpdate` di chuyển camera đến `CameraPosition` được chỉ định.
tĩnh CameraUpdate	newLatLng(LatLng latLng) Trả về `CameraUpdate` giúp di chuyển phần giữa màn hình đến vĩ độ và kinh độ do đối tượng `LatLng` chỉ định.
tĩnh CameraUpdate	newLatLngBounds(giới hạn LatLngBounds, chiều rộng int, chiều cao int, khoảng đệm int) Trả về `CameraUpdate` biến đổi camera sao cho giới hạn vĩ độ/kinh độ được căn giữa trên màn hình trong hộp giới hạn có kích thước được chỉ định ở mức thu phóng lớn nhất có thể.
tĩnh CameraUpdate	newLatLngBounds(giới hạn LatLngBounds, khoảng đệm int) Trả về `CameraUpdate` biến đổi camera sao cho giới hạn vĩ độ/kinh độ được căn giữa trên màn hình ở mức thu phóng lớn nhất có thể.
tĩnh CameraUpdate	newLatLngZoom(latLng LatLng latLng, thu phóng nổi) Trả về `CameraUpdate` giúp di chuyển phần giữa màn hình đến vĩ độ và kinh độ do đối tượng `LatLng` chỉ định và chuyển tới mức thu phóng đã cho.
tĩnh CameraUpdate	scrollBy(float xPixel; float yPixel) Trả về `CameraUpdate` cuộn máy ảnh qua bản đồ, dịch chuyển trọng tâm của xem theo số pixel được chỉ định theo hướng x và y.
tĩnh CameraUpdate	zoomBy(số lượng dấu phẩy động, Tiêu điểm điểm) Trả về `CameraUpdate` thay đổi mức thu phóng của điểm nhìn hiện tại của máy ảnh.
tĩnh CameraUpdate	zoomBy(số tiền nổi) Trả về `CameraUpdate` thay đổi mức thu phóng của điểm nhìn hiện tại của máy ảnh.
tĩnh CameraUpdate	zoomIn() Trả về `CameraUpdate` để phóng to trên bản đồ bằng cách di chuyển chiều cao của điểm quan sát lại gần hơn đến bề mặt Trái Đất.
tĩnh CameraUpdate	zoomOut() Trả về `CameraUpdate` thu nhỏ trên bản đồ bằng cách di chuyển chiều cao của điểm quan sát cách xa bề mặt Trái Đất hơn.
tĩnh CameraUpdate	zoomTo(thu phóng nổi) Trả về `CameraUpdate` di chuyển điểm quan sát của máy ảnh đến một mức thu phóng cụ thể.

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

Của lớp học java.lang.Object

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

Phương thức công khai

công khai tĩnh CameraUpdate newCameraPosition (CameraPosition)

Trả về CameraUpdate di chuyển camera đến CameraPosition được chỉ định. Trong thì điều này tạo ra sự biến đổi so với vĩ độ của đối tượng CameraPosition, kinh độ, mức thu phóng, góc phương vị và độ nghiêng.

Tham số

cameraPosition

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate newLatLng (LatLng vĩ độ)

Trả về CameraUpdate giúp di chuyển phần giữa màn hình đến vĩ độ và kinh độ do đối tượng LatLng chỉ định. Thao tác này sẽ căn giữa camera vào đối tượng LatLng.

Tham số

latLng	đối tượng `LatLng` chứa vĩ độ và kinh độ mong muốn.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate newLatLngBounds (LatLngBounds, chiều rộng int, chiều cao int, khoảng đệm int)

Trả về CameraUpdate biến đổi camera sao cho giới hạn vĩ độ/kinh độ được căn giữa trên màn hình trong hộp giới hạn có kích thước được chỉ định ở mức thu phóng lớn nhất có thể. Bạn có thể chỉ định khoảng đệm bổ sung để hạn chế hơn nữa kích thước của hộp giới hạn. CameraUpdate được trả về có góc phương diện là 0 và độ nghiêng trong số 0.

Không giống như newLatLngBounds(LatLngBounds, int), bạn có thể sử dụng CameraUpdate mà phương thức này trả về để thay đổi máy ảnh trước giai đoạn bố cục của bản đồ, vì đối số chỉ định kích thước mong muốn của hộp giới hạn.

Tham số

ranh giới	vùng cho vừa với hộp giới hạn
chiều rộng	chiều rộng hộp giới hạn tính bằng pixel (px)
độ cao	chiều cao hộp giới hạn tính bằng pixel (px)
padding	giới hạn kích thước bổ sung (tính bằng px) của hộp giới hạn

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate newLatLngBounds (LatLngBounds, khoảng đệm int)

Trả về CameraUpdate biến đổi camera sao cho giới hạn vĩ độ/kinh độ được căn giữa trên màn hình ở mức thu phóng lớn nhất có thể. Bạn có thể chỉ định khoảng đệm, để lồng hộp giới hạn từ các cạnh của chế độ xem bản đồ. Được trả về CameraUpdate có góc nằm 0 và độ nghiêng 0.

Không thay đổi máy ảnh bằng bản cập nhật máy ảnh này cho đến khi bản đồ đã được thiết lập bố cục (trong để phương pháp này xác định chính xác hộp giới hạn và mức thu phóng thích hợp, bản đồ phải có kích thước). Nếu không, hệ thống sẽ gửi IllegalStateException. KHÔNG PHẢI đủ để có sẵn bản đồ; chế độ xem chứa bản đồ cũng phải trải qua để xác định kích thước của bố cục. Nếu bạn không thể chắc chắn rằng ứng dụng này có đã xảy ra, hãy sử dụng newLatLngBounds(LatLngBounds, int, int, int) để thay thế và cung cấp của bản đồ theo cách thủ công.

Tham số

ranh giới	khu vực vừa với màn hình
padding	khoảng trắng (tính bằng px) để chừa ra giữa các cạnh hộp giới hạn và các cạnh của chế độ xem. Chiến dịch này sẽ được áp dụng cho cả bốn cạnh của hộp giới hạn.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate newLatLngZoom (LatLng vĩ độ và vĩ độ, độ thu phóng nổi)

Trả về CameraUpdate giúp di chuyển phần giữa màn hình đến vĩ độ và kinh độ do đối tượng LatLng chỉ định và chuyển tới mức thu phóng đã cho.

Tham số

latLng	đối tượng `LatLng` chứa vĩ độ và kinh độ mong muốn.
thu phóng	mức độ thu phóng mong muốn, trong khoảng từ 2,0 đến 21,0. Các giá trị dưới phạm vi này là được đặt thành 2.0 và các giá trị ở trên nó được đặt thành 21.0. Tăng giá trị để phóng to. Không phải tất cả các khu vực có ô ở mức thu phóng lớn nhất.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate scrollBy (nổi xPixel, yPixel nổi)

Trả về CameraUpdate cuộn máy ảnh qua bản đồ, dịch chuyển trọng tâm của xem theo số pixel được chỉ định theo hướng x và y.

Ví dụ:

Nếu xPixel = 5 và yPixel = 0, hệ thống sẽ cuộn sang phải bằng cách di chuyển camera sao cho bản đồ dường như đã dịch chuyển 5 pixel sang trái.
Nếu xPixel = 0 và yPixel = 5, hệ thống sẽ cuộn xuống bằng cách di chuyển camera để bản đồ dường như đã dịch chuyển 5 pixel lên trên.

Thao tác cuộn tương ứng với hướng hiện tại của máy ảnh. Ví dụ: nếu camera đang góc nghiêng 90 độ, sau đó hướng Đông là "lên" còn di chuyển camera sang phải sẽ di chuyển camera xuống phía nam.

Tham số

xPixel	số lượng pixel cần cuộn theo chiều ngang. Giá trị dương di chuyển camera đến bên phải, so với hướng hiện tại của hình ảnh đó. Giá trị âm di chuyển camera đến ở bên trái, so với hướng hiện tại của hình ảnh đó.
yPixel	số lượng pixel cần cuộn theo chiều dọc. Giá trị dương di chuyển camera hướng xuống dưới so với hướng hiện tại. Một giá trị âm làm di chuyển camera hướng lên trên so với hướng hiện tại của hình ảnh đó.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate zoomBy (số lượng dấu phẩy động, tiêu điểm của điểm)

Trả về CameraUpdate thay đổi mức thu phóng của điểm nhìn hiện tại của máy ảnh.

Một điểm được chỉ định bởi tiêu điểm sẽ vẫn cố định (tức là nó tương ứng với cùng một vĩ độ/kinh độ cả hai trước và sau quá trình thu phóng).

Phương thức này khác với zoomTo(float) ở chỗ mức thu phóng tương ứng với phương thức hiện tại máy ảnh.

Ví dụ: nếu LatLng (11,11, 22,22) hiện đang ở vị trí màn hình (23, 45). Sau khi gọi phương thức này với mức thu phóng và LatLng này, vị trí màn hình của LatLng này sẽ vẫn là (23, 45).

Tham số

số tiền	để thay đổi mức thu phóng. Giá trị dương cho biết thu phóng gần hơn với bề mặt Trái Đất trong khi các giá trị âm biểu thị việc thu nhỏ khỏi bề mặt của Trái Đất Earth.
tiêu điểm	vị trí pixel trên màn hình và cần được sửa sau quá trình thu phóng. Vĩ độ/kinh độ tại vị trí pixel đó trước khi máy ảnh di chuyển sẽ giữ nguyên sau khi camera đã di chuyển.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate zoomBy (số tiền thực)

Trả về CameraUpdate thay đổi mức thu phóng của điểm nhìn hiện tại của máy ảnh.

Phương thức này khác với zoomTo(float) ở chỗ mức thu phóng tương ứng với phương thức hiện tại máy ảnh.

Tham số

số tiền	để thay đổi mức thu phóng. Giá trị dương cho biết thu phóng gần hơn với bề mặt Trái Đất trong khi các giá trị âm biểu thị việc thu nhỏ khỏi bề mặt của Trái Đất Earth.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate zoomIn ()

Trả về CameraUpdate để phóng to trên bản đồ bằng cách di chuyển chiều cao của điểm quan sát lại gần hơn đến bề mặt Trái Đất. Mức tăng thu phóng là 1,0.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate zoomOut ()

Trả về CameraUpdate thu nhỏ trên bản đồ bằng cách di chuyển chiều cao của điểm quan sát cách xa bề mặt Trái Đất hơn. Mức tăng thu phóng là -1,0.

Giá trị trả về

CameraUpdate chứa phép biến đổi.

công khai tĩnh CameraUpdate zoomTo (thu phóng nổi)

Trả về CameraUpdate di chuyển điểm quan sát của máy ảnh đến một mức thu phóng cụ thể.

Tham số

thu phóng	mức độ thu phóng mong muốn, trong khoảng từ 2,0 đến 21,0. Các giá trị dưới phạm vi này là được đặt thành 2.0 và các giá trị ở trên nó được đặt thành 21.0. Tăng giá trị để phóng to. Không phải tất cả các khu vực có ô ở mức thu phóng lớn nhất.