Coordinates

המחלקה LatLng

google.maps.LatLng ספריית
הכיתות "core"

LatLng הוא נקודה בקואורדינטות גיאוגרפיות: קו רוחב וקו אורך.

• קו הרוחב נע בין 90- ל-90 מעלות, כולל. ערכים מעל או מתחת לטווח הזה יוצמדו לטווח [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
• קו האורך נע בין ‎-180 ל-180 מעלות, כולל. ערכים מעל או מתחת לטווח הזה יותאמו כך שייכללו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.

למרות שהיטל המפה שמוגדר כברירת מחדל משייך את קו האורך לקואורדינטת ה-X של המפה ואת קו הרוחב לקואורדינטת ה-Y, קואורדינטת קו הרוחב תמיד נכתבת ראשונה, ואחריה קו האורך.
שימו לב שאי אפשר לשנות את הקואורדינטות של LatLng. כדי לחשב נקודה אחרת, צריך ליצור נקודה חדשה.

רוב השיטות שמקבלות אובייקטים מסוג LatLng מקבלות גם אובייקט מסוג LatLngLiteral, כך שהאפשרויות הבאות שוות ערך:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151}); 

ה-constructor מקבל גם אובייקטים מסוג LatLngLiteral ו-LatLng. אם מופע של LatLng מועבר ל-constructor, נוצר עותק.

אלה הקריאות האפשריות ל-constructor:

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 

const {LatLng} = await google.maps.importLibrary("core");

יצרן

LatLng

LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) פרמטרים: latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng lngOrNoClampNoWrap: ‏number|boolean optional noClampNoWrap: boolean optional הפונקציה יוצרת אובייקט LatLng שמייצג נקודה גיאוגרפית. קו הרוחב מצוין במעלות בטווח [‎-90, 90]. קו האורך מצוין במעלות בטווח [‎-180, 180). כדי להפעיל ערכים מחוץ לטווח הזה, צריך להגדיר את noClampNoWrap לערך true. שימו לב לסדר של קו הרוחב וקו האורך.

Methods
equals	equals(other) פרמטרים: other: LatLng|LatLngLiteral optional ערך מוחזר: boolean פונקציית השוואה בין שני אובייקטים מסוג LatLng. הפונקציה מחזירה את הערך True אם הקואורדינטות נמצאות בטווח של 1e-9 אחת מהשנייה, ואת הערך False אם לא.
lat	lat() פרמטרים: אין ערך מוחזר: number הפונקציה מחזירה את קו הרוחב במעלות.
lng	lng() פרמטרים: אין ערך מוחזר: number הפונקציה מחזירה את קו האורך במעלות.
toJSON	toJSON() פרמטרים: אין ערך מוחזר: LatLngLiteral המרה לייצוג ב-JSON. הפונקציה הזו מיועדת לשימוש דרך JSON.stringify.
toString	toString() פרמטרים: אין ערך מוחזר: string הפונקציה ממירה את הערך לייצוג מחרוזת.
toUrlValue	toUrlValue([precision]) פרמטרים: precision: number optional ערך מוחזר: string מחזירה מחרוזת בפורמט "lat,lng" עבור LatLng הזה. כברירת מחדל, אנחנו מעגלים את ערכי קו הרוחב/קו האורך ל-6 ספרות אחרי הנקודה העשרונית.

ממשק LatLngLiteral

ממשק google.maps.LatLngLiteral

במקרים רבים, אפשר להשתמש בליטרלים של אובייקטים במקום באובייקטים מסוג LatLng. הם מומרים לאובייקטים מסוג LatLng כש-Maps API נתקל בהם.

דוגמאות:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

אין תמיכה בליטרלים של אובייקטים מסוג LatLng בספריית הגיאומטריה.

מאפיינים
lat	סוג: number קו רוחב במעלות. הערכים יוגבלו לטווח של [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
lng	סוג: number קו אורך במעלות. ערכים מחוץ לטווח [‎-180, 180] יותאמו כך שיהיו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.

המחלקה LatLngBounds

google.maps.LatLngBounds ספריית
הכיתות "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");

יצרן
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) פרמטרים: swOrLatLngBounds: LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne: LatLng|LatLngLiteral optional יוצר מלבן מהנקודות בפינות הדרום-מערבית והצפון-מזרחית שלו.

קבועים
MAX_BOUNDS	LatLngBounds לגבולות המקסימליים של כדור הארץ. הגבולות האלה יקיפו את כל העולם.

Methods
contains	contains(latLng) פרמטרים: latLng: LatLng|LatLngLiteral ערך מוחזר: boolean מחזירה את הערך true אם קו הרוחב/קו האורך הנתון נמצא בגבולות האלה.
equals	equals(other) פרמטרים: other: LatLngBounds|LatLngBoundsLiteral optional ערך מוחזר: boolean הפונקציה מחזירה את הערך true אם הגבולות האלה שווים בערך לגבולות שצוינו.
extend	extend(point) פרמטרים: point: LatLng|LatLngLiteral ערך מוחזר: LatLngBounds הרחבת הגבולות האלה כך שיכילו את הנקודה הנתונה.
getCenter	getCenter() פרמטרים: אין ערך מוחזר: LatLng מחשב את המרכז של LatLngBounds הזה
getNorthEast	getNorthEast() פרמטרים: אין ערך מוחזר: LatLng מחזירה את הפינה הצפון-מזרחית של הגבולות האלה.
getSouthWest	getSouthWest() פרמטרים: אין ערך מוחזר: LatLng מחזירה את הפינה הדרום-מערבית של הגבולות האלה.
intersects	intersects(other) פרמטרים: other: LatLngBounds|LatLngBoundsLiteral ערך מוחזר: boolean הפונקציה מחזירה true אם הגבולות האלה חולקים נקודות כלשהן עם הגבולות האחרים.
isEmpty	isEmpty() פרמטרים: אין ערך מוחזר: boolean הפונקציה מחזירה ערך אם הגבולות ריקים.
toJSON	toJSON() פרמטרים: אין ערך מוחזר: LatLngBoundsLiteral המרה לייצוג ב-JSON. הפונקציה הזו מיועדת לשימוש דרך JSON.stringify.
toSpan	toSpan() פרמטרים: אין ערך מוחזר: LatLng הפונקציה ממירה את גבולות המפה שצוינו לטווח של קווי רוחב/אורך.
toString	toString() פרמטרים: אין ערך מוחזר: string הפונקציה ממירה למחרוזת.
toUrlValue	toUrlValue([precision]) פרמטרים: precision: number optional ערך מוחזר: string הפונקציה מחזירה מחרוזת בפורמט "lat_lo,lng_lo,lat_hi,lng_hi" לגבולות האלה, כאשר "lo" תואם לפינה הדרום-מערבית של התיבה התוחמת, ו-"hi" תואם לפינה הצפון-מזרחית של התיבה הזו.
union	union(other) פרמטרים: other: LatLngBounds|LatLngBoundsLiteral ערך מוחזר: LatLngBounds הרחבת הגבולות האלה כך שיכילו את האיחוד של הגבולות האלה והגבולות הנתונים.

ממשק LatLngBoundsLiteral

ממשק google.maps.LatLngBoundsLiteral

ליטרלים של אובייקטים מתקבלים במקום אובייקטים מסוג LatLngBounds בכל ה-API. הם מומרים באופן אוטומטי לאובייקטים מסוג LatLngBounds. צריך להגדיר את כל הפרמטרים south,‏ west,‏ north ו-east, אחרת תתקבל הודעת שגיאה.

מאפיינים
east	סוג: number קו אורך מזרחי במעלות. ערכים מחוץ לטווח [‎-180, 180] יותאמו לטווח [‎-180, 180). לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.
north	סוג: number קו רוחב צפוני במעלות. הערכים יוגבלו לטווח של [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
south	סוג: number קו רוחב דרומי במעלות. הערכים יוגבלו לטווח [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
west	סוג: number קו אורך מערבי במעלות. ערכים מחוץ לטווח [‎-180, 180] יוגבלו לטווח [‎-180, 180). לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.

המחלקה LatLngAltitude

google.maps.LatLngAltitude class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

LatLngAltitude הוא נקודה תלת-ממדית בקואורדינטות גיאוגרפיות: קו רוחב, קו אורך וגובה.

• קו הרוחב נע בין 90- ל-90 מעלות, כולל. ערכים מעל או מתחת לטווח הזה יוצמדו לטווח [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
• קו האורך נע בין ‎-180 ל-180 מעלות, כולל. ערכים מעל או מתחת לטווח הזה יותאמו כך שייכללו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.
• הגובה נמדד במטרים. ערכים חיוביים מציינים גבהים מעל פני הקרקע, וערכים שליליים מציינים גבהים מתחת לפני הקרקע.

const {LatLngAltitude} = await google.maps.importLibrary("core");

יצרן
LatLngAltitude	LatLngAltitude(value[, noClampNoWrap]) פרמטרים: ‫value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral הערך הראשוני. ‫noClampNoWrap: boolean optional אם לשמור את ערכי האתחול, גם אם הם לא בהכרח ערכי קו רוחב תקינים בטווח של [-90, 90] או ערכי קו אורך תקינים בטווח של [-180, 180]. ברירת המחדל היא false, שמאפשרת הצמדה של קו הרוחב וגלישה של קו האורך.

מאפיינים
altitude readonly	סוג: number מחזירה את הגובה.
lat readonly	סוג: number מחזירה את קו הרוחב.
lng readonly	סוג: number מחזירה את קו האורך.

Methods
equals	equals(other) פרמטרים: ‫other: LatLngAltitude|LatLngAltitudeLiteral optional אובייקט LatLngAltitude אחר. ערך מוחזר: boolean אם שני האובייקטים שווים. פונקציית השוואה בין שני אובייקטים מסוג LatLngAltitude. הפונקציה מחזירה את הערך True אם הקואורדינטות נמצאות בטווח של 1e-9 אחת מהשנייה, ואת הערך False אם לא.
toJSON	toJSON([key]) פרמטרים: key: string optional ערך מוחזר: LatLngAltitudeLiteral הפונקציה ממירה לאובייקט פשוט.

ממשק LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

במקרים רבים, אפשר להשתמש בליטרלים של אובייקטים במקום באובייקטים מסוג LatLngAltitude. הם מומרים לאובייקטים מסוג LatLngAltitude כש-Maps API נתקל בהם.

מאפיינים
altitude	סוג: number המרחק (במטרים) מעל פני הקרקע. ערך שלילי מציין שהמיקום הוא מתחת לפני הקרקע.
lat	סוג: number קו רוחב במעלות. הערכים יוגבלו לטווח של [‎-90, 90]. כלומר, אם הערך שצוין קטן מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
lng	סוג: number קו אורך במעלות. ערכים מחוץ לטווח [‎-180, 180] יותאמו כך שיהיו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. הערך 190 יומר ל-170-. ההתנהגות הזו משקפת את העובדה שקווי האורך מקיפים את כדור הארץ.

מחלקה Point

google.maps.Point ספריית
הכיתות "core"

const {Point} = await google.maps.importLibrary("core");

יצרן
Point	Point(x, y) פרמטרים: x: number y: number נקודה במישור דו-ממדי.

מאפיינים
x	סוג: number קואורדינטת X
y	סוג: number קואורדינטת Y

Methods
equals	equals(other) פרמטרים: other: Point optional ערך מוחזר: boolean השוואה בין שתי נקודות
toString	toString() פרמטרים: אין ערך מוחזר: string מחזירה ייצוג מחרוזת של הנקודה הזו.

גודל הכיתה

google.maps.Size ספריית
הכיתה "core"

const {Size} = await google.maps.importLibrary("core");

יצרן
Size	Size(width, height[, widthUnit, heightUnit]) פרמטרים: width: number height: ‏number widthUnit: ‏string optional heightUnit: string optional גודל דו-ממדי, שבו הרוחב הוא המרחק בציר ה-X והגובה הוא המרחק בציר ה-Y.

מאפיינים
height	סוג: number הגובה לאורך ציר ה-Y, בפיקסלים.
width	סוג: number הרוחב לאורך ציר ה-X, בפיקסלים.

Methods
equals	equals(other) פרמטרים: other: Size optional ערך מוחזר: boolean השוואה בין שני גדלים.
toString	toString() פרמטרים: אין ערך מוחזר: string מחזירה ייצוג מחרוזת של הגודל הזה.

ממשק Padding

ממשק google.maps.Padding

מאפיינים
bottom אופציונלי	סוג: number optional המרווח הפנימי התחתון בפיקסלים.
left אופציונלי	סוג: number optional המרווח הפנימי משמאל, בפיקסלים.
right אופציונלי	סוג: number optional המרווח הפנימי מימין, בפיקסלים.
top אופציונלי	סוג: number optional המרווח הפנימי העליון בפיקסלים.

הממשק CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

ליטרל של אובייקט שמייצג עיגול.

מאפיינים
center	סוג: LatLng|LatLngLiteral מרכז המעגל.
radius	סוג: number הרדיוס במטרים על פני כדור הארץ.
‫עברו בירושה: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

המחלקה Orientation3D

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

Orientation3D הוא וקטור תלת-ממדי שמשמש לטרנספורמציות סיבוב מתמטיות סטנדרטיות לאורך הכיוון, ההטיה והגלגול.

• הכיוון הוא זווית בטווח של [0, 360) מעלות.
• ההטיה היא זווית בטווח של [0, 360) מעלות.
• ‫roll היא זווית בטווח של [0, 360) מעלות.

const {Orientation3D} = await google.maps.importLibrary("core");

יצרן
Orientation3D	Orientation3D(value) פרמטרים: ‫value: Orientation3D|Orientation3DLiteral הערך הראשוני.

מאפיינים
heading readonly	סוג: number ברירת המחדל: 0 סיבוב סביב ציר Z (מאונך לפני השטח של כדור הארץ). הערך 0 (ברירת המחדל) שווה לצפון. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר Z, והוא מצוין במעלות מ-0 עד 360. ערכים מעל או מתחת לטווח הזה יותאמו כך שייכללו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. גם הערך 530 יומר ל-170.
roll readonly	סוג: number ברירת המחדל: 0 סיבוב סביב ציר ה-Y. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר ה-Y, והוא מצוין במעלות מ-0 עד 360. ערכים מעל או מתחת לטווח הזה יותאמו כך שייכללו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. גם הערך 530 יומר ל-170.
tilt readonly	סוג: number ברירת המחדל: 0 סיבוב סביב ציר ה-X. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר ה-X, והוא מצוין במעלות מ-0 עד 360. ערכים מעל או מתחת לטווח הזה יותאמו כך שייכללו בטווח. לדוגמה, הערך ‎-190 יומר ל-170. גם הערך 530 יומר ל-170.

Methods
equals	equals(other) פרמטרים: ‫other: Orientation3D|Orientation3DLiteral optional אובייקט Orientation3D אחר. ערך מוחזר: boolean אם שני האובייקטים שווים. פונקציית השוואה.
toJSON	toJSON([key]) פרמטרים: key: string optional ערך מוחזר: Orientation3DLiteral הפונקציה ממירה לאובייקט פשוט.

ממשק Orientation3DLiteral

ממשק google.maps.Orientation3DLiteral

במקרים רבים, אפשר להשתמש בליטרלים של אובייקטים במקום באובייקטים מסוג Orientation3D. הם מומרים לאובייקטים מסוג Orientation3D כש-Maps API נתקל בהם.

מאפיינים
heading אופציונלי	סוג: number optional סיבוב סביב ציר Z (מאונך לפני השטח של כדור הארץ). הערך 0 (ברירת המחדל) שווה לצפון. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר Z, והוא מצוין במעלות מ-0 עד 360.
roll אופציונלי	סוג: number optional סיבוב סביב ציר ה-Y. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר ה-Y, והוא מצוין במעלות מ-0 עד 360.
tilt אופציונלי	סוג: number optional סיבוב סביב ציר ה-X. סיבוב חיובי הוא סיבוב בכיוון השעון סביב ציר ה-X, והוא מצוין במעלות מ-0 עד 360.

מחלקה Vector3D

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

‫Vector3D הוא וקטור תלת-ממדי שמשמש לפעולות מתמטיות רגילות, כמו שינוי קנה המידה של הגבולות של אובייקט תלת-ממדי לאורך צירי x,‏ y ו-z מקומיים.

• ‫x הוא מספר ממשי.
• ‫y הוא מספר ממשי.
• ‫z הוא מספר ממשי.

const {Vector3D} = await google.maps.importLibrary("core");

יצרן
Vector3D	Vector3D(value) פרמטרים: ‫value: Vector3D|Vector3DLiteral הערך הראשוני.

מאפיינים
x readonly	סוג: number רכיב X של הווקטור התלת-ממדי.
y readonly	סוג: number רכיב Y של הווקטור התלת-ממדי.
z readonly	סוג: number רכיב Z של הווקטור התלת-ממדי.

Methods
equals	equals(other) פרמטרים: ‫other: Vector3D|Vector3DLiteral optional אובייקט Vector3D או Vector3DLiteral אחר. ערך מוחזר: boolean פונקציית השוואה.
toJSON	toJSON([key]) פרמטרים: key: string optional ערך מוחזר: Vector3DLiteral הפונקציה ממירה לאובייקט פשוט.

ממשק Vector3DLiteral

ממשק google.maps.Vector3DLiteral

במקרים רבים, אפשר להשתמש בליטרלים של אובייקטים במקום באובייקטים מסוג Vector3D. הם מומרים לאובייקטים מסוג Vector3D כש-Maps API נתקל בהם.

מאפיינים
x	סוג: number רכיב X של הווקטור התלת-ממדי.
y	סוג: number רכיב Y של הווקטור התלת-ממדי.
z	סוג: number רכיב Z של הווקטור התלת-ממדי.