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"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
المَعلمات: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean 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])
المَعلمات: 
  • precisionnumber optional
قيمة الإرجاع:  string
تعرض سلسلة بالصيغة "lat,lng" لخط الطول والعرض هذا. ويتم تقريب قيم خطوط الطول/العرض إلى 6 أماكن عشرية افتراضيًا.

واجهة LatLngLiteral

واجهة google.maps.LatLngLiteral

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

أمثلة:

 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"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

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

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
المَعلمات: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral القيمة المبدئية.
  • noClampNoWrapboolean 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 عندما ترصدها واجهة برمجة تطبيقات الخرائط.

تمتد هذه الواجهة من 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"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Point
Point(x, y)
المَعلمات: 
  • xnumber
  • ynumber
يشير ذلك المصطلح إلى نقطة على مستوى ثنائي الأبعاد.
x
النوع:  number
الإحداثي X
y
النوع:  number
الإحداثي Y
equals
equals(other)
المَعلمات: 
قيمة الإرجاع:  boolean
للمقارنة بين نقطتَين.
toString
toString()
المَعلمات: لا شيء
قيمة الإرجاع:  string
لعرض تمثيل سلسلة لهذه النقطة.

فئة الحجم

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

يمكنك الوصول من خلال الاتصال على الرقم const {Size} = await google.maps.importLibrary("core"). يمكنك الاطّلاع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Size
Size(width, height[, widthUnit, heightUnit])
المَعلمات: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring 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