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

הבנאי מקבל גם אובייקטים 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"). לפרטים, אפשר לעיין בקטע ספריות ב-מפות 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 הזה. כברירת מחדל, אנחנו מעגלים את ערכי קווי הרוחב/Lng ל-6 ספרות אחרי הנקודה העשרונית.

ממשק LatLngLiteral

הממשק google.maps.LatLngLiteral

לנוחיותכם, במקומות רבים אפשר להזין ליטרליות של אובייקט במקום LatLng אובייקטים. האובייקטים האלה עוברים המרה ל-LatLng אובייקטים כשממשק ה-API של מפות Google מזהה אותם.

דוגמאות:

 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"). לפרטים, אפשר לעיין בקטע ספריות ב-מפות JavaScript API.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
פרמטרים: 
יוצרת מלבן מהנקודות בפינות הדרום-מערביות ובפינות הצפון-מזרחיות שלו.
MAX_BOUNDS LatLngBounds עבור הגבולות המקסימליים של כדור הארץ. גבולות אלה יכסו את כל כדור הארץ.
contains
contains(latLng)
פרמטרים: 
הערך המוחזר:  boolean
מחזירה true אם קו הרוחב/Lng הנתון נמצא בגבולות האלה.
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-. הנתון הזה משקף את העובדה שקווי אורך מקיפים את כדור הארץ.

מחלקת LatLngAltitade

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"). לפרטים, אפשר לעיין בקטע ספריות ב-מפות 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 אובייקט LatLngAltitade נוסף.
הערך המוחזר:  boolean מציין אם שני האובייקטים שווים.
פונקציית השוואה.
toJSON
toJSON()
פרמטרים: ללא
הערך המוחזר:  LatLngAltitudeLiteral ייצוג JSON של האובייקט הזה.

ממשק LatLngAltitadeLiteral

הממשק google.maps.LatLngAltitudeLiteral

לנוחיותכם, במקומות רבים אפשר להזין ליטרליות של אובייקט במקום LatLngAltitude אובייקטים. האובייקטים האלה עוברים המרה ל-LatLngAltitude אובייקטים כשממשק ה-API של מפות Google מזהה אותם.

הממשק הזה פועל ב-LatLngLiteral.

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

מחלקת נקודה

google.maps.Point כיתה

ניתן לקבל גישה באמצעות חיוג אל const {Point} = await google.maps.importLibrary("core"). לפרטים, אפשר לעיין בקטע ספריות ב-מפות JavaScript API.

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

סיווג גודל

google.maps.Size כיתה

ניתן לקבל גישה באמצעות חיוג אל const {Size} = await google.maps.importLibrary("core"). לפרטים, אפשר לעיין בקטע ספריות ב-מפות 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
מחזירה ייצוג מחרוזת של הגודל הזה.

ממשק מרווח

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