Thiết lập các chế độ điều khiển máy ảnh

Người dùng có thể điều khiển chế độ thu phóng, độ nghiêng, vị trí và độ xoay của camera bằng cử chỉ trên bản đồ. Bạn cũng có thể định cấu hình camera theo phương thức lập trình.

Vị trí của 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. Vị trí và hướng của camera được xác định bằng toạ độ vĩ độ/kinh độ/độ cao (được xác định là "tâm", nơi camera đang hướng đến), hướng, độ nghiêng, phạm vi và độ xoay.

Tâm (vĩ độ, kinh độ, độ cao)

Tâm xác định điểm cụ thể trong không gian 3D mà camera đang quan sát. Điểm 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 trong không gian ba chiều.

Vĩ độ có thể nằm trong khoảng từ -90 đến 90 độ, bao gồm cả hai đầu. Kinh độ nằm trong khoảng từ -180 đến 180 độ, bao gồm cả hai đầu. Độ cao được chỉ định bằng mét so với mực nước biển.

Hướng

Hướng chỉ định hướng la bàn của bả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 độ.

Độ 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 đang hướng theo chiều ngang theo hướng được chỉ định bởi hướng.

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à tâm của bản đồ. Phạm vi 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 đế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 độ "thu phóng" hoặc "thu nhỏ" của bản đồ.

Độ xoay

Độ xoay đặt góc của camera so với đường chân trời, được đo bằng độ. Bạn có thể sử dụng tham số này để tạo các hiệu ứng như nghiêng khi mô phỏng chuyến bay hoặc thậm chí là xoay tròn hoàn toàn, xoay camera quanh trục xem.

Điều khiển camera

// 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
    }
)