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

בחירת פלטפורמה: Android iOS JavaScript

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

דיאגרמה שממחישה את מודל המצלמה התלת-ממדית

מיקום המצלמה

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

קו רוחב, קו אורך, גובה

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

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

ערכים שמעל או מתחת לטווח הזה יוצמדו לערך הקרוב ביותר בטווח. לדוגמה, אם תציינו קו רוחב של 100, הערך יוגדר ל-90.

כותרת

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

הטיה

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

טווח

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

הטלת קובייה

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

שליטה במצלמה

בדוגמת הקוד הבאה אפשר לראות איך לשלוט במצלמה באופן פרוגרמטי.

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)