Coordinates

שיעור אמריקה הלטינית

כיתה google.maps.LatLng

LatLng הוא נקודה בקואורדינטות גיאוגרפיות: קו רוחב וקו אורך.

• קו הרוחב נע בין 90- ל-90 מעלות, כולל. ערכים מעל או מתחת לטווח זה יוצמדו לטווח [-90, 90]. כלומר, אם הערך שצוין נמוך מ-90-, הוא יהיה מוגדר ל-90-. אם הערך גדול מ-90, הערך יוגדר ל-90.
• טווחי האורך בין 180- ל-180 מעלות, כולל. ערכים מעל או מתחת לטווח הזה יעטפו כדי שהם יהיו בטווח. לדוגמה, ערך של -190 יומר ל-170. ערך של 190 יומר ל-170-. הנתון הזה משקף את העובדה שקווי האורך מקיפים את כדור הארץ.

אמנם היטל ברירת המחדל של המפה משייך את קו האורך לקואורדינטת ה-X של המפה, ואת קו הרוחב עם קואורדינטת ה-y, אבל קואורדינטת קו הרוחב תמיד נכתבת first ואז קו האורך.
שימו לב שלא ניתן לשנות את הקואורדינטות של LatLng. כדי לחשב נקודה אחרת, צריך ליצור נקודה חדשה.

רוב השיטות שמקבלות אובייקטים של LatLng מקבלות גם אובייקט LatLngLiteral, כך שהפעולות הבאות מקבילות:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151}); 

ה-constructor מקבלת גם אובייקטים 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(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), 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}); 

אובייקטים מסוג 'ליטרים של אובייקטים' אינם נתמכים בספריית הגיאומטריה.

מאפיינים
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|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 כאשר ה-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 מרווח פנימי עליון, בפיקסלים.

מחיקת מעגל

ממשק google.maps.CircleLiteral

ליטרל של אובייקט שמייצג עיגול.

הממשק הזה כבר פועל CircleOptions.

מאפיינים
center	סוג:  LatLng|LatLngLiteral מרכז המעגל.
radius	סוג:  number הרדיוס במטרים על פני השטח של כדור הארץ.
הועבר בירושה: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex