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])
المَعلمات: 
  • 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" لهذا العنصر 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()
المَعلمات:  بدون
قيمة العائد:  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])
المَعلمات: 
  • precisionnumber optional
قيمة العائد:  string
تعرض هذه السمة سلسلة بالتنسيق "lat_lo,lng_lo,lat_hi,lng_hi" لهذه الحدود، حيث يشير "lo" إلى الزاوية الجنوبية الغربية للمربّع المحيط، بينما يشير "hi" إلى الزاوية الشمالية الشرقية لهذا المربّع.
union
union(other)
المَعلمات: 
قيمة العائد:  LatLngBounds
توسّع هذه الحدود لتشمل اتحاد هذه الحدود والحدود المحدّدة.

LatLngBoundsLiteral interface

google.maps.LatLngBoundsLiteral interface

يتم قبول القيم الحرفية للعناصر بدلاً من عناصر 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])
المَعلمات: 
  • 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 interface

google.maps.LatLngAltitudeLiteral interface

يتم قبول القيم الحرفية للعناصر بدلاً من عناصر 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)
المَعلمات: 
  • xnumber
  • ynumber
نقطة على مستوى ثنائي الأبعاد
x
النوع:  number
الإحداثي X
y
النوع:  number
الإحداثي Y
equals
equals(other)
المَعلمات: 
  • otherPoint optional
قيمة العائد:  boolean
مقارنة بين نقطتَين
toString
toString()
المَعلمات:  بدون
قيمة العائد:  string
تعرض هذه الدالة تمثيلاً كسلسلة من Point.

فئة الحجم

google.maps.Size صف

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Size} = await google.maps.importLibrary("core").
اطّلِع على المكتبات في Maps JavaScript API.

Size
Size(width, height[, widthUnit, heightUnit])
المَعلمات: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
الحجم الثنائي الأبعاد، حيث يمثّل العرض المسافة على المحور x، ويمثّل الارتفاع المسافة على المحور y.
height
النوع:  number
تمثّل هذه السمة الارتفاع على طول المحور y، بالبكسل.
width
النوع:  number
تمثّل هذه السمة العرض على طول المحور x، بوحدة البكسل.
equals
equals(other)
المَعلمات: 
قيمة العائد:  boolean
تقارن هذه الدالة بين حجمَين.
toString
toString()
المَعلمات:  بدون
قيمة العائد:  string
تعرض هذه الدالة تمثيلاً على شكل سلسلة لهذا الحجم.

واجهة Padding

google.maps.Padding interface

bottom optional
النوع:  number optional
المساحة المتروكة للأسفل، بالبكسل
left optional
النوع:  number optional
تمثّل هذه السمة المساحة المتروكة لليسار بوحدة البكسل.
right optional
النوع:  number optional
المساحة المتروكة لليمين بالبكسل
top optional
النوع:  number optional
تمثّل هذه السمة المساحة المتروكة للأعلى بوحدة البكسل.

واجهة CircleLiteral

google.maps.CircleLiteral interface

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

توسّع هذه الواجهة CircleOptions.

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

فئة Orientation3D

google.maps.Orientation3D صف

Orientation3D هي متّجه ثلاثي الأبعاد يُستخدم في عمليات التحويل الرياضية القياسية للدوران على طول الاتجاه والميل والدوران.

  • تمثّل قيمة العنوان زاوية ضمن النطاق [0, 360) درجة.
  • الإمالة هي زاوية في النطاق [0, 360) درجة.
  • roll هي زاوية في النطاق [0, 360) درجة.

تنفّذ هذه الفئة Orientation3DLiteral.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Orientation3D} = await google.maps.importLibrary("core").
اطّلِع على المكتبات في Maps JavaScript API.

Orientation3D
Orientation3D(value)
المَعلمات: 
heading
النوع:  number
القيمة التلقائية: 0
الدوران حول المحور z (العمودي على سطح الأرض) القيمة 0 (القيمة التلقائية) تساوي الشمال. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170.
roll
النوع:  number
القيمة التلقائية: 0
التدوير حول المحور y يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور y ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170.
tilt
النوع:  number
القيمة التلقائية: 0
الدوران حول المحور x يكون الدوران الموجب في اتجاه عقارب الساعة حول المحور x ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170.
equals
equals(other)
المَعلمات: 
القيمة المعروضة:  boolean ما إذا كان العنصران متساويين.
دالة المقارنة
toJSON
toJSON()
المَعلمات:  بدون
قيمة العائد:  Orientation3DLiteral
تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify.

واجهة Orientation3DLiteral

google.maps.Orientation3DLiteral interface

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

heading optional
النوع:  number optional
الدوران حول المحور z (العمودي على سطح الأرض) القيمة 0 (القيمة التلقائية) تساوي الشمال. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360.
roll optional
النوع:  number optional
التدوير حول المحور y يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور y ويتم تحديده بالدرجات من 0 إلى 360.
tilt optional
النوع:  number optional
الدوران حول المحور x يكون الدوران الموجب في اتجاه عقارب الساعة حول المحور x ويتم تحديده بالدرجات من 0 إلى 360.

فئة Vector3D

google.maps.Vector3D صف

Vector3D هي متّجه ثلاثي الأبعاد يُستخدم في العمليات الرياضية العادية، مثل تغيير حجم حدود كائن ثلاثي الأبعاد على طول المحاور x وy وz المحلية.

  • x هو عدد حقيقي.
  • حيث يمثل y عددًا حقيقيًا.
  • z هو عدد حقيقي.

تنفّذ هذه الفئة Vector3DLiteral.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Vector3D} = await google.maps.importLibrary("core").
اطّلِع على المكتبات في Maps JavaScript API.

Vector3D
Vector3D(value)
المَعلمات: 
x
النوع:  number
تمثّل هذه السمة المكوّن X للخط المتّجه الثلاثي الأبعاد.
y
النوع:  number
تمثّل هذه السمة المكوّن Y للخط المتجه الثلاثي الأبعاد.
z
النوع:  number
المكوّن Z للخط المتجه الثلاثي الأبعاد.
equals
equals(other)
المَعلمات: 
قيمة العائد:  boolean
دالة المقارنة
toJSON
toJSON()
المَعلمات:  بدون
قيمة العائد:  Vector3DLiteral
تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify.

واجهة Vector3DLiteral

google.maps.Vector3DLiteral interface

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

x
النوع:  number
تمثّل هذه السمة المكوّن X للخط المتّجه الثلاثي الأبعاد.
y
النوع:  number
تمثّل هذه السمة المكوّن Y للخط المتجه الثلاثي الأبعاد.
z
النوع:  number
المكوّن Z للخط المتجه الثلاثي الأبعاد.