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])
פרמטרים: 
  • latOrLatLngOrLatLngLiteralnumber|