ผู้ใช้สามารถควบคุมการซูม การเอียง ตำแหน่ง และการหมุนของกล้องได้โดยใช้ท่าทางสัมผัสบนแผนที่ นอกจากนี้ คุณยังกำหนดค่ากล้องแบบเป็นโปรแกรมได้ด้วย
ตำแหน่งกล้อง
มุมมองแผนที่จะจำลองเป็นกล้องที่มองไปยังจุดหนึ่งๆ ในพื้นที่ 3 มิติ ตำแหน่งและการวางแนวของกล้อง (และการแสดงผลแผนที่) จะกำหนดโดยพร็อพเพอร์ตี้ต่อไปนี้ center (ตำแหน่งละติจูด/ลองจิจูด/ระดับความสูงที่กล้องมอง อยู่), heading, tilt, range และ roll
กึ่งกลาง (ละติจูด/ลองจิจูด/ระดับความสูง)
กึ่งกลางกำหนดจุดที่เฉพาะเจาะจงในพื้นที่ 3 มิติที่กล้องกำลังสังเกต
โดยระบุโดยใช้คลาส LatLngAltitude
ซึ่งรวมค่าสำหรับละติจูด ลองจิจูด และระดับความสูง ซึ่งช่วยให้กำหนดตำแหน่งจุดโฟกัสของกล้องได้อย่างแม่นยำใน 3 มิติ
ละติจูดต้องอยู่ระหว่าง -90 ถึง 90 องศา ลองจิจูด อยู่ระหว่าง -180 ถึง 180 องศา (รวม) โดยจะระบุระดับความสูงเป็นเมตรเหนือ ระดับน้ำทะเล
ส่วนหัว
Heading ของกล้องจะระบุทิศทางที่กล้องจะหันไป โดยวัดเป็นองศาตามเข็มนาฬิกาจากทิศเหนือจริง ทิศเหนือสอดคล้องกับ 0 องศา ทิศตะวันออกกับ 90 องศา ทิศใต้กับ 180 องศา และทิศตะวันตกกับ 270 องศา ซึ่งจะเป็นตัวกำหนดการวางแนวของกล้องรอบแกนแนวตั้งของจุดกึ่งกลาง
เอียง
การเอียงจะระบุมุมของกล้องเทียบกับแกนแนวตั้ง โดยวัดเป็นองศา การเอียง 0 องศาหมายความว่ากล้องกำลังชี้ลงมายัง โลก (จุดใต้เท้า) โดยตรง การเอียง 90 องศาหมายความว่ากล้องหันไปในแนวนอนในทิศทางที่ ระบุโดยส่วนหัว
ช่วง
ช่วงจะกำหนดระยะทางเป็นเมตรระหว่างตำแหน่งของกล้องเองกับจุดกึ่งกลางที่กล้องกำลังมอง โดยระยะทางอาจแตกต่างกันตั้งแต่ 0 เมตร (ใกล้มาก) ไปจนถึง 63 ล้านเมตร ซึ่งช่วยให้คุณดูได้ตั้งแต่ระยะใกล้มากไปจนถึงมุมมองระดับโลกอย่างแท้จริง ซึ่งจะควบคุมลักษณะที่แผนที่จะปรากฏได้ว่า "ซูมเข้า" หรือ "ซูมออก"
หมุน
การหมุนจะกำหนดมุมของกล้องเทียบกับขอบฟ้า โดยวัดเป็นองศา พารามิเตอร์นี้ใช้เพื่อสร้างเอฟเฟกต์ต่างๆ เช่น การเอียงระหว่างการจำลองการบิน หรือแม้แต่การหมุนแบบม้วนตัวเต็มรอบ โดยหมุนกล้องรอบแกนการดู
การควบคุมกล้องถ่ายรูป
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีควบคุมกล้อง
แบบเป็นโปรแกรมโดยการเรียกใช้เมธอด
setCamera
หากต้องการใช้ตัวอย่างโค้ดนี้ ให้ทําตามวิธีการใน
การตั้งค่าและ
เพิ่มแผนที่ 3 มิติลงในแอปเพื่อตั้งค่า
โปรเจ็กต์ Android Studio ด้วยแผนที่ 3 มิติพื้นฐาน จากนั้นเพิ่มโค้ดต่อไปนี้
ลงในไฟล์
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 } )