Coordinates

המחלקה LatLng

מחלקה google.maps.LatLng

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").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

יצרן

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 ערך מוחזר:  boolean פונקציית השוואה.
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

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

כדי לקבל גישה, צריך לקרוא ל: const {LatLngBounds} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

יצרן
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

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

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

המחלקה הזו מטמיעה את LatLngAltitudeLiteral.

המחלקה הזו מטמיעה את LatLngLiteral.

כדי לקבל גישה, צריך לקרוא ל: const {LatLngAltitude} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

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

Methods
equals	equals(other) פרמטרים:  ‫other:  LatLngAltitude optional אובייקט LatLngAltitude אחר. ערך מוחזר:  boolean אם שני האובייקטים שווים. פונקציית השוואה.
toJSON	toJSON() פרמטרים:  אין ערך החזרה:  LatLngAltitudeLiteral ייצוג ב-JSON של האובייקט הזה.

ממשק LatLngAltitudeLiteral

ממשק google.maps.LatLngAltitudeLiteral

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

הממשק הזה מרחיב את LatLngLiteral.

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

מחלקה Point

מחלקה google.maps.Point

כדי לקבל גישה, צריך לקרוא ל: const {Point} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

יצרן
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

כדי לקבל גישה, צריך לקרוא ל: const {Size} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

יצרן
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 optional	סוג:  number optional המרווח הפנימי התחתון בפיקסלים.
left optional	סוג:  number optional המרווח הפנימי משמאל, בפיקסלים.
right optional	סוג:  number optional המרווח הפנימי מימין, בפיקסלים.
top optional	סוג:  number optional המרווח הפנימי העליון בפיקסלים.

הממשק CircleLiteral

ממשק google.maps.CircleLiteral

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

הממשק הזה מרחיב את CircleOptions.

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

המחלקה Orientation3D

מחלקה google.maps.Orientation3D

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

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

המחלקה הזו מטמיעה את Orientation3DLiteral.

כדי לקבל גישה, צריך לקרוא ל: const {Orientation3D} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

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

Methods
equals	equals(other) פרמטרים:  ‫other:  Orientation3D|Orientation3DLiteral optional אובייקט Orientation3D אחר. ערך מוחזר:  boolean אם שני האובייקטים שווים. פונקציית השוואה.
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Orientation3DLiteral המרה לייצוג ב-JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

ממשק Orientation3DLiteral

ממשק google.maps.Orientation3DLiteral

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

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

מחלקה Vector3D

מחלקה google.maps.Vector3D

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

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

המחלקה הזו מטמיעה את Vector3DLiteral.

כדי לקבל גישה, צריך לקרוא ל: const {Vector3D} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

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

Methods
equals	equals(other) פרמטרים:  ‫other:  Vector3D|Vector3DLiteral optional אובייקט Vector3D או Vector3DLiteral אחר. ערך מוחזר:  boolean פונקציית השוואה.
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Vector3DLiteral המרה לייצוג ב-JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

ממשק Vector3DLiteral

ממשק google.maps.Vector3DLiteral

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

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