Người dùng có thể điều khiển chế độ thu phóng, độ nghiêng, vị trí và hướng xoay của camera bằng cách dùng cử chỉ trên bản đồ. Bạn cũng có thể định cấu hình camera theo cách lập trình.
Vị trí camera
Chế độ xem bản đồ được mô phỏng như một camera nhìn vào một điểm cụ thể trong không gian 3D. Vị trí và hướng của camera (và do đó, việc hiển thị bản đồ) được chỉ định bằng các thuộc tính sau: tâm (vị trí vĩ độ/kinh độ/độ cao mà camera đang nhìn vào), hướng, độ nghiêng, phạm vi và độ xoay.
Tâm (Vĩ độ/Kinh độ/Độ cao)
center xác định điểm cụ thể trong không gian 3D mà camera đang quan sát.
Điều này được chỉ định bằng cách sử dụng lớp LatLngAltitude, kết hợp các giá trị cho vĩ độ, kinh độ và độ cao. Điều này cho phép định vị chính xác tiêu điểm của camera theo 3 chiều.
Vĩ độ có thể nằm trong khoảng từ -90 đến 90 độ (bao gồm cả hai). Kinh độ nằm trong khoảng từ -180 đến 180 độ. Độ cao được chỉ định bằng mét so với mực nước biển.
Hướng
Hướng của camera chỉ định hướng mà camera sẽ hướng đến, được đo bằng độ theo chiều kim đồng hồ từ hướng Bắc thực. Hướng Bắc tương ứng với 0 độ, hướng Đông tương ứng với 90 độ, hướng Nam tương ứng với 180 độ và hướng Tây tương ứng với 270 độ. Tham số này xác định hướng của camera xung quanh trục dọc của điểm trung tâm.
Độ nghiêng
Độ nghiêng chỉ định góc của camera so với trục dọc, được đo bằng độ. Độ nghiêng 0 độ có nghĩa là camera đang hướng thẳng xuống Trái Đất (điểm thiên để). Độ nghiêng 90 có nghĩa là camera được hướng theo chiều ngang theo hướng do heading chỉ định.
Phạm vi
Phạm vi xác định khoảng cách tính bằng mét giữa vị trí của camera và điểm trung tâm mà camera đang hướng đến. Phạm vi này có thể thay đổi từ 0 mét (rất gần) đến 63 triệu mét, cho phép xem từ rất gần cho đến góc nhìn toàn cầu thực sự. Điều này giúp kiểm soát hiệu quả mức độ "phóng to" hoặc "thu nhỏ" của bản đồ.
Độ xoay
Độ nghiêng đặt góc của camera so với đường chân trời, được đo bằng độ. Bạn có thể dùng tham số này để tạo các hiệu ứng như nghiêng trong mô phỏng chuyến bay hoặc thậm chí là một cú lộn vòng hoàn toàn, xoay camera quanh trục xem.
Điều khiển máy ảnh
Mã mẫu sau đây minh hoạ cách điều khiển camera theo phương thức lập trình bằng cách gọi phương thức setCamera.
Để sử dụng mã mẫu này, hãy làm theo hướng dẫn trong phần Thiết lập và Thêm bản đồ 3D vào ứng dụng để thiết lập dự án Android Studio bằng một bản đồ 3D cơ bản. Sau đó, hãy thêm mã sau vào tệp MainActivity.kt:
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )