Coordinates

LatLng class

google.maps.LatLng class

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});

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

אלה הקריאות האפשריות ל-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])
פרמטרים: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
הפונקציה יוצרת אובייקט LatLng שמייצג נקודה גיאוגרפית. קו הרוחב מצוין במעלות בטווח [‎-90, 90]. קו האורך מצוין במעלות בטווח [‎-180, 180). כדי לאפשר ערכים מחוץ לטווח הזה, צריך להגדיר את noClampNoWrap ל-true. שימו לב לסדר של קו הרוחב וקו האורך.
equals
equals(other)
פרמטרים: 
ערך מוחזר:  boolean
פונקציית השוואה.
lat
lat()
פרמטרים:  אין
ערך מוחזר:  number
הפונקציה מחזירה את קו הרוחב במעלות.
lng
lng()
פרמטרים:  אין
ערך מוחזר:  number
הפונקציה מחזירה את קו האורך במעלות.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  LatLngLiteral
ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.
toString
toString()
פרמטרים:  אין
ערך מוחזר:  string
הפונקציה ממירה לייצוג מחרוזת.
toUrlValue
toUrlValue([precision])
פרמטרים: 
  • precisionnumber optional
ערך מוחזר:  string
מחזירה מחרוזת מהצורה 'lat,lng' עבור LatLng הזה. כברירת מחדל, אנחנו מעגלים את ערכי קווי הרוחב והאורך ל-6 מקומות עשרוניים.

LatLngLiteral interface

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 object literals בספריית הגיאומטריה.

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

LatLngBounds class

google.maps.LatLngBounds class

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

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

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
פרמטרים: 
יוצר מלבן מהנקודות בפינות הדרום-מערבית והצפון-מזרחית שלו.
MAX_BOUNDS LatLngBounds לגבולות המקסימליים של כדור הארץ. הגבולות האלה יכללו את כל העולם.
contains
contains(latLng)
פרמטרים: 
ערך מוחזר:  boolean
הפונקציה מחזירה את הערך true אם קו הרוחב וקו האורך שצוינו נמצאים בטווח הזה.
equals
equals(other)
פרמטרים: 
ערך מוחזר:  boolean
הפונקציה מחזירה את הערך true אם הגבולות האלה שווים בקירוב לגבולות הנתונים.
extend
extend(point)
פרמטרים: 
ערך מוחזר:  LatLngBounds
מרחיב את הגבולות כך שיכילו את הנקודה שצוינה.
getCenter
getCenter()
פרמטרים:  אין
ערך מוחזר:  LatLng
מחשבת את המרכז של LatLngBounds
getNorthEast
getNorthEast()
פרמטרים:  אין
ערך מוחזר:  LatLng
מחזירה את הפינה הצפון-מזרחית של הגבולות האלה.
getSouthWest
getSouthWest()
פרמטרים:  אין
ערך מוחזר:  LatLng
מחזירה את הפינה הדרום-מערבית של הגבולות האלה.
intersects
intersects(other)
פרמטרים: 
ערך מוחזר:  boolean
הפונקציה מחזירה true אם הגבולות האלה חולקים נקודות עם הגבולות האחרים.
isEmpty
isEmpty()
פרמטרים:  אין
ערך מוחזר:  boolean
הפונקציה מחזירה אם הגבולות ריקים.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  LatLngBoundsLiteral
ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.
toSpan
toSpan()
פרמטרים:  אין
ערך מוחזר:  LatLng
הפונקציה ממירה את גבולות המפה הנתונים לטווח של קווי רוחב ואורך.
toString
toString()
פרמטרים:  אין
ערך מוחזר:  string
הפונקציה ממירה למחרוזת.
toUrlValue
toUrlValue([precision])
פרמטרים: 
  • precisionnumber optional
ערך מוחזר:  string
הפונקציה מחזירה מחרוזת מהצורה 'lat_lo,lng_lo,lat_hi,lng_hi' לגבולות האלה, כאשר 'lo' מתאים לפינה הדרום-מערבית של התיבה התוחמת, ו-'hi' מתאים לפינה הצפון-מזרחית של התיבה הזו.
union
union(other)
פרמטרים: 
ערך מוחזר:  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 class

google.maps.LatLngAltitude class

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])
פרמטרים: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral ערך ההגדרה הראשונית.
  • noClampNoWrapboolean optional האם לשמור את ערכי ההגדרה הראשוניים, גם אם הם לא בהכרח ערכי קו רוחב חוקיים בטווח [90-, 90] או ערכי קו אורך חוקיים בטווח [180-, 180]. ברירת המחדל היא false, שמאפשרת הצמדה של קו הרוחב וגלישה של קו האורך.
altitude
סוג:  number
מחזירה את הגובה.
lat
סוג:  number
מחזירה את קו הרוחב.
lng
סוג:  number
הפונקציה מחזירה את קו האורך.
equals
equals(other)
פרמטרים: 
  • otherLatLngAltitude optional אובייקט נוסף מסוג LatLngAltitude.
ערך ההחזרה:  boolean האם שני האובייקטים שווים.
פונקציית השוואה.
toJSON
toJSON()
פרמטרים:  אין
ערך ההחזרה:  LatLngAltitudeLiteral ייצוג JSON של האובייקט הזה.

LatLngAltitudeLiteral interface

google.maps.LatLngAltitudeLiteral ממשק

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

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

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

Point class

google.maps.Point class

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

Point
Point(x, y)
פרמטרים: 
  • xnumber
  • ynumber
נקודה במישור דו-ממדי.
x
סוג:  number
הקואורדינטה X
y
סוג:  number
קואורדינטת ה-Y
equals
equals(other)
פרמטרים: 
  • otherPoint optional
ערך מוחזר:  boolean
השוואה בין שתי נקודות
toString
toString()
פרמטרים:  אין
ערך מוחזר:  string
מחזירה ייצוג מחרוזתי של הנקודה הזו.

Size class

google.maps.Size class

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

Size
Size(width, height[, widthUnit, heightUnit])
פרמטרים: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
גודל דו-ממדי, שבו הרוחב הוא המרחק בציר ה-x והגובה הוא המרחק בציר ה-y.
height
סוג:  number
הגובה לאורך ציר ה-y, בפיקסלים.
width
סוג:  number
הרוחב לאורך ציר ה-X, בפיקסלים.
equals
equals(other)
פרמטרים: 
ערך מוחזר:  boolean
השוואה בין שני גדלים.
toString
toString()
פרמטרים:  אין
ערך מוחזר:  string
מחזירה ייצוג מחרוזתי של האובייקט Size.

ממשק Padding

google.maps.Padding ממשק

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

CircleLiteral interface

google.maps.CircleLiteral ממשק

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

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

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

Orientation3D class

google.maps.Orientation3D class

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

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

במחלקה הזו מיושם Orientation3DLiteral.

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

Orientation3D
Orientation3D(value)
פרמטרים: 
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.
equals
equals(other)
פרמטרים: 
ערך ההחזרה:  boolean האם שני האובייקטים שווים.
פונקציית השוואה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Orientation3DLiteral
ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

Orientation3DLiteral interface

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 class

google.maps.Vector3D class

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

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

במחלקה הזו מיושם Vector3DLiteral.

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

Vector3D
Vector3D(value)
פרמטרים: 
x
סוג:  number
רכיב ה-X של הווקטור התלת-ממדי.
y
סוג:  number
רכיב ה-Y של הווקטור התלת-ממדי.
z
סוג:  number
רכיב ה-Z של הווקטור התלת-ממדי.
equals
equals(other)
פרמטרים: 
ערך מוחזר:  boolean
פונקציית השוואה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Vector3DLiteral
ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

Vector3DLiteral interface

google.maps.Vector3DLiteral ממשק

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

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