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-. הנתון הזה משקף את העובדה שקווי האורך חוזרים על עצמם ברחבי העולם.

‫