Coordinates

فئة LatLng

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 إلى المُنشئ، يتم إنشاء نسخة.

في ما يلي المكالمات المحتمَلة إلى المنشئ:

 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" لـ LatLng هذا. يتم تقريب قيم خط الطول/العرض إلى 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 class

يمثّل مثيل LatLngBounds مستطيلاً في الإحداثيات الجغرافية، بما في ذلك مستطيل يمرّ بخط الطول 180 درجة.

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

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
المَعلمات: 
تُنشئ مستطيلاً من النقاط في الزاويتَين الجنوبية الغربية والشمالية الشرقية.
MAX_BOUNDS LatLngBounds للحدود القصوى للأرض ستتضمّن هذه الحدود الكرة الأرضية بأكملها.
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 class

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 عند عثور واجهة برمجة التطبيقات 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 class

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

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

الفئة حسب المقاس

google.maps.Size class

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

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
لعرض تمثيل سلسلة لهذا الحجم.

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

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

فئة Orientation3D

google.maps.Orientation3D class

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

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

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

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

Orientation3D
Orientation3D(value)
المَعلمات: 
heading
النوع:  number
القيمة التلقائية: 0
الدوران حول محور z (عمودي على سطح الأرض) القيمة 0 (التلقائية) تساوي "شمال". يكون الدوران الموجب في اتجاه عقارب الساعة حول محور z ويتم تحديده بالدرجات من 0 إلى 360. سيتم لفّ القيم فوق هذا النطاق أو تحته لكي تقع ضمن النطاق. على سبيل المثال، سيتم تحويل القيمة -190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170.
roll
النوع:  number
القيمة التلقائية: 0
التدوير حول المحور الصادي يكون التدوير الموجب في اتجاه عقارب الساعة حول محور 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 واجهة

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

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

فئة Vector3D

google.maps.Vector3D class

Vector3D هو متجه ثلاثي الأبعاد يُستخدَم لإجراء العمليات الحسابية العادية، مثل تغيير حجم حدود الجسم الثلاثي الأبعاد على طول المحاور المحلية x وy وz.

  • س هو عدد حقيقي.
  • y هو عدد حقيقي.
  • z هو عدد حقيقي.

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

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

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 واجهة

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

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