Coordinates

LatLng class

google.maps.LatLng صف

LatLng هي نقطة في الإحداثيات الجغرافية: خط العرض وخط الطول.

  • يتراوح خط العرض بين 90- و90 درجة، بما في ذلك هذان الرقمَان. سيتم تقريب القيم الأعلى أو الأقل من هذا النطاق إلى النطاق [-90, 90]. هذا يعني أنّه إذا كانت القيمة المحدّدة أقل من -90، سيتم ضبطها على -90. وإذا كانت القيمة أكبر من 90، سيتم ضبطها على 90.
  • يتراوح خط الطول بين 180- و180 درجة، ضِمنًا. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم تحويل القيمة 190 إلى -170. ويعكس ذلك حقيقة أنّ خطوط الطول تمتد حول الكرة الأرضية.
على الرغم من أنّ إسقاط الخريطة التلقائي يربط خط الطول بالإحداثي السيني للخريطة، وخط العرض بالإحداثي الصادي، يتم دائمًا كتابة إحداثي خط العرض أولاً، يليه خط الطول.
يُرجى العِلم أنّه لا يمكنك تعديل إحداثيات LatLng. إذا أردت احتساب نقطة أخرى، عليك إنشاء نقطة جديدة.

تقبل معظم الطرق التي تقبل كائنات LatLng أيضًا كائن LatLngLiteral، وبالتالي يكون ما يلي متساويًا: 

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

تقبل الدالة الإنشائية أيضًا الكائنَين 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").
اطّلِع على المكتبات في 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

google.maps.LatLngLiteral interface

يتم قبول القيم الحرفية للعناصر بدلاً من عناصر LatLng، وذلك لتسهيل الاستخدام، في العديد من الأماكن. ويتم تحويلها إلى عناصر LatLng عندما تصادفها واجهة برمجة التطبيقات Maps API.

أمثلة: 

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

لا تتوافق القيم الحرفية لعناصر LatLng مع مكتبة Geometry.
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])
المَعلمات: 
تنشئ هذه الدالة مستطيلاً من النقاط الواقعة في الزاويتين الجنوبية الغربية والشمالية الشرقية.
MAX_BOUNDS LatLngBounds للحدود القصوى للأرض ستشمل هذه الحدود الكرة الأرضية بأكملها.
contains
contains(latLng)
المَعلمات: 
قيمة العائد:  boolean
تعرِض true إذا كانت خطوط الطول والعرض المحدّدة ضمن هذه الحدود.
equals
equals(other)
المَعلمات: 
قيمة العائد:  boolean
تعرض true إذا كانت هذه الحدود تساوي الحدود المحدّدة تقريبًا.
extend
extend(point)
المَعلمات: 
قيمة العائد:  LatLngBounds
توسّع هذه الحدود لتشمل النقطة المحدّدة.
getCenter
getCenter()
المَعلمات:  بدون
قيمة العائد: