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

ה-constructor מקבל גם את האובייקטים 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"). ראה ספריות ב-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) פרמטרים:  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 הזה. כברירת מחדל, אנחנו נעגל את ערכי קווי הרוחב/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"). ראה ספריות ב-Maps JavaScript API.

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

קבועים
MAX_BOUNDS	נתיבי LatLngBounds עבור הגבולות המקסימליים של כדור הארץ. גבולות אלה יכסו את כדור הארץ כולו.

שיטות
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 סיווג

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 אובייקט LatLngAltitud נוסף. ערך מוחזר:  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"). ראה ספריות ב-Maps JavaScript API.

יצרן
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"). ראה ספריות ב-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) פרמטרים:  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