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 מועבר לבנאי, נוצר עותק.

הקריאות האפשריות לבנאי נמצאות למטה:

 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({lat: -34, lng: 151}, null, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true); 

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

יצרן

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

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

שיטות
contains	contains(latLng) פרמטרים:  latLng:  LatLng|LatLngLiteral ערך החזרה:  boolean מחזירה true אם קווי הרוחב/Lng הנתונים נמצאים בגבולות אלה.
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 מרחיבה את הגבול הזה כך שהיא מכילה את האיחוד של טווח זה ושל הטווח הנתון.

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

יצרן
LatLngAltitude	LatLngAltitude(value[, noClampNoWrap]) פרמטרים:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng ערך האתחול. noClampNoWrap:  boolean optional אם לשמור את ערכי האתחול, גם אם הם לא בהכרח ערכי קו רוחב חוקיים בטווח של [99-, 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 כאשר ה-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"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

נכסים
x	סוג:  number קואורדינטת ה-X
y	סוג:  number קואורדינטת ה-Y

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

שיעור מידה

מחלקה google.maps.Size

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

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