Coordinates

‫LatLng class

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

הקונסטרקטור מקבל גם אובייקטים מסוג LatLngLiteral ו-LatLng. אם מועבר מופע של 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. שימו לב לסדר של קו הרוחב וקו האורך.
equals
equals(other)
פרמטרים: 
ערך מוחזר:  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 interface

google.maps.LatLngLiteral ממשק

במקומות רבים, אפשר להשתמש במקום באובייקטים מסוג LatLng במילולי אובייקטים, כדי שיהיה לכם נוח יותר. הם מומרים לאובייקטים של LatLng כשהם מזוהים על ידי Maps API.

דוגמאות: 

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

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

‫LatLngBounds class

google.maps.LatLngBounds class

מופע של LatLngBounds מייצג מלבן בקואורדינטות גיאוגרפיות, כולל מלבן שחוצה את קו האורך 180 מעלות.

אפשר להתקשר אל const {LatLngBounds} = await google.maps.importLibrary("core") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
פרמטרים: 
יוצר מלבן מהנקודות בפינות הדרום-מערבית והצפון-מזרחית שלו.
MAX_BOUNDS LatLngBounds לגבולות המקסימליים של כדור הארץ. הגבולות האלה יכללו את כל העולם.
contains
contains(latLng)
פרמטרים: 
ערך מוחזר:  boolean
הפונקציה מחזירה את הערך true אם קו הרוחב וקו האורך שצוינו נמצאים בטווח הזה.
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])
פרמטרים: 
  • precision:  number 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-. הנתון הזה משקף את העובדה שקווי האורך חוזרים על עצמם ברחבי העולם.

‫LatLngAltitude class

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

‪