Coordinates

حصة LatLng

صف واحد (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" لخط الطول والعرض هذا. ويتم تقريب قيم خطوط الطول والعرض إلى 6 أماكن عشرية افتراضيًا.

واجهة LatLngLiteral

واجهة 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 غير متاحة في مكتبة 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 خط الطول والعرض للحدود القصوى للأرض. ستشمل هذه الحدود الكرة الأرضية بالكامل.
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 في واجهة برمجة التطبيقات. يتم تحويل هذه العناصر تلقائيًا إلى عناصر 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"). يمكنك الاطّلاع على المكتبات في 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)
المَعلمات: 
قيمة العرض:  boolean ما إذا كان العنصران متساويين.
دالة المقارنة.
toJSON
toJSON()
المَعلمات: لا شيء
قيمة العرض:  LatLngAltitudeLiteral تمثيل JSON لهذا الكائن.

واجهة LatLngAltitudeLiteral

واجهة google.maps.LatLngAltitudeLiteral

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

تمد هذه الواجهة 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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
Point
Point(x, y)
المَعلمات: 
  • x:  number
  • y:  number
يشير ذلك المصطلح إلى نقطة على مستوى ثنائي الأبعاد.
x
النوع:  number
الإحداثي X
y
النوع:  number
الإحداثي Y
equals
equals(other)
المَعلمات: 
قيمة الإرجاع:  boolean
مقارنة نقطتين
toString
toString()
المَعلمات: لا شيء
قيمة الإرجاع:  string
لعرض تمثيل سلسلة لهذه النقطة.

فئة الحجم

صف واحد (google.maps.Size)

يمكنك الوصول من خلال الاتصال على الرقم const {Size} = await google.maps.importLibrary("core"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
Size
Size(width, height[, widthUnit, heightUnit])
المَعلمات: 
  • width:  number
  • height:  number
  • widthUnit:  string optional
  • heightUnit:  string optional
الحجم الثنائي الأبعاد، حيث يمثل العرض المسافة على المحور س، والارتفاع هو المسافة على المحور ص.
height
النوع:  number
الارتفاع على طول المحور ص بالبكسل.
width
النوع:  number
العرض على طول المحور x بالبكسل.
equals
equals(other)
المَعلمات: 
قيمة الإرجاع:  boolean
للمقارنة بين حجمين.
toString
toString()
المَعلمات: لا شيء
قيمة الإرجاع:  string
تعرض تمثيل سلسلة لهذا المقاس.

واجهة المساحة المتروكة

واجهة google.maps.Padding

bottom optional
النوع:  number optional
المساحة السفلية بالبكسل
left optional
النوع:  number optional
المساحة المتروكة إلى اليسار بالبكسل
right optional
النوع:  number optional
المساحة المتروكة إلى اليمين بالبكسل
top optional
النوع:  number optional
المساحة المتروكة لأعلى بالبكسل

واجهة CircleLiteral

واجهة google.maps.CircleLiteral

العنصر الحرفي الذي يمثل دائرة.

تمد هذه الواجهة CircleOptions.

center
النوع:  LatLng|LatLngLiteral
تمثّل هذه السمة مركز الدائرة.
radius
النوع:  number
نصف القطر بالمتر على سطح الأرض.
مكتسَبة: clickable، draggable، editable، fillColor، fillOpacity، map، strokeColor، strokeOpacity، strokePosition، strokeWeight، visible، zIndex