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. חשוב לשים לב לסדר של קו הרוחב וקו האורך.

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 האלה. כברירת מחדל, אנחנו מעגלים את הערכים של 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]) פרמטרים:  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 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 הפונקציה מחזירה את קו האורך.

Methods
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

Methods
equals	equals(other) פרמטרים:  other:  Point ערך המוחזר:  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, בפיקסלים.

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