Coordinates

הכיתה LatLng

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

ה-constructor מקבל גם אובייקטים מסוג LatLngLiteral ו-LatLng. אם מעבירים למבנה ה-constructor מופע של 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])
פרמטרים: 
  • latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap:  number|boolean optional
  • noClampNoWrap:  boolean 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])
פרמטרים: 
  • precision:  number optional
ערך המוחזר:  string
הפונקציה מחזירה מחרוזת בפורמט 'lat,lng' עבור קואורדינטות ה-LatLng האלה. כברירת מחדל, אנחנו מעגלים את הערכים של lat/lng ל-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});

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

הכיתה LatLngBounds

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])
פרמטרים: 
  • precision:  number 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

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

הממשק LatLngAltitudeLiteral

ממשק 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

google.maps.Point class

אפשר לגשת אליו באמצעות חיוג למספר const {Point} = await google.maps.importLibrary("core"). ספריות ב-Maps JavaScript API
Point
Point(x, y)
פרמטרים: 
  • x:  number
  • y:  number
נקודה במישור דו-מימדי.
x
סוג:  number
הקואורדינטה X
y
סוג:  number
הקואורדינטה Y
equals
equals(other)
פרמטרים: 
  • other:  Point optional
ערך המוחזר:  boolean
השוואה בין שני נקודות
toString
toString()
פרמטרים:  ללא
ערך המוחזר:  string
הפונקציה מחזירה ייצוג מחרוזת של הנקודה הזו.

הכיתה Size

google.maps.Size class

אפשר לגשת אליו באמצעות חיוג למספר 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, בפיקסלים.
equals
equals(other)
פרמטרים: 
ערך המוחזר:  boolean
האופרטור משווה בין שני ערכים של Sizes.
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
מרכז המעגל.
radius
סוג:  number
הרדיוס במטרים על פני כדור הארץ.
עוברים בירושה: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

הכיתה Orientation3D

google.maps.Orientation3D class

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

  • heading היא זווית בטווח [0, 360) מעלות.
  • tilt היא זווית בטווח [0, 360) מעלות.
  • roll היא זווית בטווח [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

ממשק 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 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

ממשק google.maps.Vector3DLiteral

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