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

בחירת פלטפורמה: 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)