Mengonfigurasi kontrol kamera

Pilih platform: Android iOS JavaScript

Pengguna dapat mengontrol zoom, kemiringan, posisi, dan rotasi kamera menggunakan gestur di peta. Anda juga dapat mengonfigurasi kamera secara terprogram.

Diagram yang menggambarkan model kamera 3D

Posisi Kamera

Tampilan peta ini dimodelkan sebagai kamera yang sedang melihat titik tertentu di ruang. Posisi dan orientasi kamera ditentukan oleh koordinat lintang/bujur/ketinggian, arah, kemiringan, rentang, dan putaran.

Lintang, bujur, ketinggian

Posisi awal kamera ditentukan dengan menetapkan garis lintang, bujur, dan ketinggian. Nilai ini digabungkan untuk menentukan posisi kamera, bukan arah kamera, atau titik tengah kamera.

Garis lintang berkisar antara -90 dan 90 derajat, inklusif. Rentang bujur antara -180 dan 180 derajat, inklusif. Ketinggian ditentukan dalam meter di atas permukaan laut.

Nilai di atas atau di bawah rentang ini akan dibulatkan ke nilai terdekat dalam rentang ini. Misalnya, menetapkan garis lintang 100 akan menyetel nilainya ke 90.

Arah

Heading menentukan arah kompas peta, yang diukur dalam derajat searah jarum jam dari Utara sejati. Utara sesuai dengan 0 derajat, Timur sesuai dengan 90 derajat, Selatan sesuai dengan 180 derajat, dan Barat sesuai dengan 270 derajat.

Kemiringan

Kemiringan menentukan sudut kamera terhadap sumbu vertikal, yang diukur dalam derajat. Kemiringan 0 derajat berarti kamera mengarah lurus ke bawah menuju Bumi (titik nadir). Kemiringan 90 derajat berarti kamera diarahkan secara horizontal ke arah yang ditentukan oleh arah.

Rentang

Rentang menentukan jarak dalam meter antara posisi kamera itu sendiri dan pusat peta. Rentang ini dapat bervariasi dari nol meter (sangat dekat) hingga enam puluh tiga juta meter, sehingga memungkinkan tampilan dari sangat dekat hingga perspektif global yang sebenarnya. Hal ini secara efektif mengontrol seberapa "diperbesar" atau "diperkecil" tampilan peta.

Putar

Roll menetapkan sudut kamera terhadap cakrawala, yang diukur dalam derajat. Parameter ini dapat digunakan untuk membuat efek seperti kemiringan saat simulasi penerbangan atau bahkan putaran penuh, memutar kamera di sekitar sumbu tampilan.

Mengontrol kamera

Contoh kode berikut menunjukkan cara mengontrol kamera secara terprogram.

Swift


public static var sanFrancisco: Camera = .init(
  latitude: 37.7845812,
  longitude: -122.3660241,
  altitude: 585,
  heading: 288.0,
  tilt: 75.0,
  roll: 0.0,
  range: 100)