הגדרת אמצעי הבקרה של המצלמה

המשתמשים יכולים לשלוט על שינוי המרחק מהתצוגה, ההטיה, המיקום והסיבוב של המצלמה באמצעות תנועות במפה. אפשר גם להגדיר את המצלמה באופן פרוגרמטי.

מיקום המצלמה

תצוגת המפה מוגדרת כצילום ממצלמה שמכוונת לנקודה ספציפית במרחב. המיקום והכיוון של המצלמה מוגדרים על ידי קואורדינטות של קו רוחב, קו אורך וגובה (מוגדרות כ'מרכז', שבו המצלמה מכוונת), כיוון, הטיה, טווח וגלגול.

מרכז (קו רוחב, קו אורך, גובה)

המרכז מגדיר את הנקודה הספציפית במרחב התלת-ממדי שהמצלמה מתמקדת בה. המיקום מצוין באמצעות המחלקה LatLngAltitude, שמשלבת ערכים של קו רוחב, קו אורך וגובה. כך אפשר למקם במדויק את נקודת המיקוד של המצלמה בשלושה ממדים.

קו הרוחב יכול להיות בין ‎-90 ל-90 מעלות, כולל. קו האורך נע בין ‎-180 ל-180 מעלות, כולל. הגובה מצוין במטרים מעל פני הים.

כותרת

הכיוון מציין את כיוון המצפן של המפה, שנמדד במעלות בכיוון השעון מצפון אמיתי. צפון מתאים ל-0 מעלות, מזרח ל-90 מעלות, דרום ל-180 מעלות ומערב ל-270 מעלות.

הטיה

התג tilt מציין את זווית המצלמה ביחס לציר האנכי, במעלות. הטיה של 0 מעלות פירושה שהמצלמה מכוונת ישר למטה לכיוון כדור הארץ (נקודת נאדיר). הטיה של 90 מעלות פירושה שהמצלמה מכוונת אופקית בכיוון שצוין בכותרת.

טווח

הטווח מגדיר את המרחק במטרים בין המיקום של המצלמה לבין מרכז המפה. הטווח יכול לנוע מאפס מטרים (תצוגה מקרוב מאוד) ועד לשישים ושלושה מיליון מטרים, כך שאפשר לראות את התצוגה מקרוב מאוד ועד לנקודת מבט גלובלית. כך למעשה קובעים את רמת ההגדלה או ההקטנה של המפה.

הטלת קובייה

הערך roll מגדיר את זווית המצלמה ביחס לאופק, במעלות. אפשר להשתמש בפרמטר הזה כדי ליצור אפקטים כמו הטיה במהלך סימולציות של טיסה, או אפילו גלגול מלא, על ידי סיבוב המצלמה סביב ציר הצפייה שלה.

שליטה במצלמה

בדוגמת הקוד הבאה אפשר לראות איך שולטים במצלמה באופן פרוגרמטי באמצעות קריאה לשיטה setCamera. כדי להשתמש בדוגמת הקוד הזו, צריך לפעול לפי ההוראות שבקטעים הגדרה והוספת מפה תלת-ממדית לאפליקציה כדי להגדיר את פרויקט Android Studio עם מפה תלת-ממדית בסיסית. לאחר מכן, מוסיפים את הקוד הבא לקובץ 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
    }
)