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

דף זה תורגם על ידי Cloud Translation API.

CameraUpdate מפעל

שיעור סיום ציבורי CameraUpdateFactory מרחיב את אובייקט

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

לדוגמה, כדי להגדיל את התצוגה במפה, אפשר להשתמש בקוד הבא:

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

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

צריך להמתין עד ש-GoogleMap יהיה זמין מ-MapFragment או MapView שהוספת לאפליקציה. אפשר לקבל את GoogleMap למשל באמצעות קריאה חוזרת (getMapAsync()) והמתנה לקריאה החוזרת של onMapReady(GoogleMap map).
התקשרו אל initialize(Context). כל עוד לא זורקים GooglePlayServicesNotAvailableException, הכיתה הזו תצוין כמו שצריך. אותחל.

מדריך למפתחים

מידע נוסף זמין בקטע מצלמה ותצוגה. המדריך למפתחים.

סיכום השיטה הציבורית

סטטי CameraUpdate	newCameraPosition(CameraPosition של המצלמה) הפונקציה מחזירה ערך `CameraUpdate` שמעביר את המצלמה ל-`CameraPosition` שצוין.
סטטי CameraUpdate	newLatLng(LatLng latLng) הפונקציה מחזירה ערך `CameraUpdate` שמעביר את מרכז המסך לקו רוחב וקו אורך שצוין על ידי אובייקט `LatLng`.
סטטי CameraUpdate	newLatLngBounds(LatLngBounds גבולות, רוחב int, גובה int, מרווח פנימי) הפונקציה מחזירה את הערך `CameraUpdate` שמשנה את המצלמה כך שהערכים שצוינו קווי אורך ורוחב ממורכזים על המסך בתוך תיבה תוחמת של מימדים שצוינו ברמת הזום הגבוהה ביותר האפשרית.
סטטי CameraUpdate	newLatLngBounds(גבולות של LatLngBounds, מרווח פנימי פנימי) הפונקציה מחזירה את הערך `CameraUpdate` שמשנה את המצלמה כך שהערכים שצוינו קווי האורך והרוחב ממורכזים במסך ברמת הזום הגבוהה ביותר האפשרית.
סטטי CameraUpdate	newLatLngZoom(LatLng latLng, זום צף) הפונקציה מחזירה ערך `CameraUpdate` שמעביר את מרכז המסך לקו רוחב וקו אורך שצוין על ידי אובייקט `LatLng`, ועובר לרמת הזום הנתונה.
סטטי CameraUpdate	scrollBy(מספר צף ב-xPixel, yPixel צף) הפונקציה מחזירה ערך `CameraUpdate` שגולל את המצלמה על המפה ומשנה את המרכז של תצוגה לפי מספר הפיקסלים שצוין בכיוונים x ו-y.
סטטי CameraUpdate	zoomBy(מספר ממשי (float), פוקוס נקודה) הפונקציה מחזירה ערך `CameraUpdate` שמשנה את מרחק התצוגה של נקודת המבט הנוכחית של המצלמה.
סטטי CameraUpdate	zoomBy(סכום צף) הפונקציה מחזירה ערך `CameraUpdate` שמשנה את מרחק התצוגה של נקודת המבט הנוכחית של המצלמה.
סטטי CameraUpdate	zoomIn() הפונקציה מחזירה ערך `CameraUpdate` שמגדיל את התצוגה במפה על ידי קירוב הגובה של נקודת המבט לפני כדור הארץ.
סטטי CameraUpdate	zoomOut() הפונקציה מחזירה ערך `CameraUpdate` שמקטין את התצוגה במפה על ידי הזזת הגובה של נקודת המבט רחוקים יותר מפני כדור הארץ.
סטטי CameraUpdate	zoomTo(זום צף) הפונקציה מחזירה ערך `CameraUpdate` שמעביר את נקודת המבט של המצלמה לרמת זום מסוימת.

סיכום השיטות שעברו בירושה

מהכיתה JavaScript.lang.Object

בוליאני	equals(אובייקט arg0)
סופי כיתה<?>	getClass()
int	hashCode()
סופי ריק	notify()
סופי ריק	notifyAll()
מחרוזת	toString()
סופי ריק	wait(long arg0, int arg1)
סופי ריק	wait(ארוך arg0)
סופי ריק	wait()

שיטות ציבוריות

ציבורי סטטי CameraUpdate newCameraPosition (CameraPosition מיקום מצלמה)

הפונקציה מחזירה ערך CameraUpdate שמעביר את המצלמה ל-CameraPosition שצוין. לחשבון האפקט הזה יוצר טרנספורמציה מקו הרוחב של האובייקט CameraPosition, קו אורך, רמת הזום, נשיאה והטיה.

פרמטרים

cameraPosition

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate newLatLng (LatLng latLng)

הפונקציה מחזירה ערך CameraUpdate שמעביר את מרכז המסך לקו רוחב וקו אורך שצוין על ידי אובייקט LatLng. המצלמה מתמקמת מעל לאובייקט LatLng.

פרמטרים

latLng	אובייקט `LatLng` שמכיל את קו הרוחב וקו האורך הרצויים.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds גבולות, רוחב פנימי, גובה int, מרווח פנימי פנימי)

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

בניגוד ל-newLatLngBounds(LatLngBounds, int), אפשר להשתמש ב-CameraUpdate שהוחזרו בשיטה הזו כדי לשנות את המצלמה לפני שלב הפריסה במפה, כי ארגומנטים מציינים את הגודל הרצוי של התיבה התוחמת.

פרמטרים

גבולות	האזור שמתאים לתיבה התוחמת
רוחב	רוחב של תיבה תוחמת (bounding box) בפיקסלים (px)
גובה	גובה של תיבה תוחמת (bounding box) בפיקסלים (px)
padding	מגבלת גודל נוספת (ב-px) של התיבה התוחמת

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds, מרווח פנימי פנימי)

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

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

פרמטרים

גבולות	אזור להתאמה במסך
padding	רווח (ב-px) כדי להשאיר בין הקצוות של התיבה התוחמת לבין קצוות התצוגה. הזה הערך מוחל על כל ארבעת הצדדים של התיבה התוחמת.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate newLatLngZoom (LatLng latLng, זום צף)

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

פרמטרים

latLng	אובייקט `LatLng` שמכיל את קו הרוחב וקו האורך הרצויים.
זום, zoom	את רמת הזום הרצויה, בטווח של 2.0 עד 21.0. הערכים מתחת לטווח הזה הם מוגדר ל-2.0, והערכים שמעליו מוגדרים ל-21.0. כדי להגדיל את התצוגה, צריך להגדיל את הערך. לא הכול כוללים משבצות ברמות הזום הגדולות ביותר.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate scrollBy (float xPixel, float yPixel)

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

דוגמאות:

אם xPixel = 5 ו-yPixel = 0, המערכת גוללת ימינה על ידי הזזת המצלמה כך נראה שהמפה זזה 5 פיקסלים שמאלה.
אם xPixel = 0 ו-yPixel = 5, המערכת גוללת למטה על ידי הזזת המצלמה כך נראה שהמפה זזה 5 פיקסלים למעלה.

הגלילה מתבצעת ביחס לכיוון הנוכחי של המצלמה. לדוגמה, אם המצלמה 90 מעלות, והמזרח הוא 'למעלה' וגלילה ימינה תזיז את המצלמה דרומה.

פרמטרים

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

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate zoomBy (כמות ציפה, פוקוס נקודה)

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

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

השיטה הזו שונה מ-zoomTo(float) מבחינת הזום הזה ביחס לנוכחי מצלמה.

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

פרמטרים

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

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate zoomBy (סכום צף)

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

השיטה הזו שונה מ-zoomTo(float) מבחינת הזום הזה ביחס לנוכחי מצלמה.

פרמטרים

סכום	כדי לשנות את רמת הזום. ערכים חיוביים מציינים את ההתקרבות של כדור הארץ, בעוד שערכים שליליים מצביעים על התרחקות מפני השטח של Google Earth.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate zoomIn ()

הפונקציה מחזירה ערך CameraUpdate שמגדיל את התצוגה במפה על ידי קירוב הגובה של נקודת המבט לפני כדור הארץ. הגדלת הזום היא 1.0.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate zoomOut ()

הפונקציה מחזירה ערך CameraUpdate שמקטין את התצוגה במפה על ידי הזזת הגובה של נקודת המבט רחוקים יותר מפני כדור הארץ. הגדלת הזום היא -1.0.

החזרות

CameraUpdate שמכיל את הטרנספורמציה.

ציבורי סטטי CameraUpdate zoomTo (זום צף)

הפונקציה מחזירה ערך CameraUpdate שמעביר את נקודת המבט של המצלמה לרמת זום מסוימת.

פרמטרים

זום, zoom	את רמת הזום הרצויה, בטווח של 2.0 עד 21.0. הערכים מתחת לטווח הזה הם מוגדר ל-2.0, והערכים שמעליו מוגדרים ל-21.0. כדי להגדיל את התצוגה, צריך להגדיל את הערך. לא הכול כוללים משבצות ברמות הזום הגדולות ביותר.