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

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

CameraUpdate מפעל

מחלקה סופית ציבורית ציבורית CameraUpdateFactory מרחיבה את האובייקט

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

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

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

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

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

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

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

סיכום אמצעי תשלום ציבורי

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

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

מכיתה java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
תוקף סופי	notify()
תוקף סופי	notifyAll()
מחרוזת	toString()
תוקף סופי	wait(long arg0, int arg1)
תוקף סופי	wait(long arg0)
תוקף סופי	wait()

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

ציבורי סטטי CameraUpdate newCameraPosition (CameraPosition CameraPosition)

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

פרמטרים

cameraPosition

החזרות

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

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

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

פרמטרים

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

החזרות

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

ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds bounds, intwidth, int height, int מרווח)

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

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

פרמטרים

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

החזרות

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

ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds bounds, int מרווח)

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

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

פרמטרים

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

החזרות

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 (float amount, Point Focus)

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

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

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

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

פרמטרים

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

החזרות

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

ציבורי סטטי CameraUpdate zoomBy (float amount)

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

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

פרמטרים

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

החזרות

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. מגדילים את הערך כדי להגדיל את התצוגה. לא בכל האזורים יש משבצות ברמת הזום הגדולה ביותר.