Coordinates

فئة LatLng

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

‫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").
يُرجى الاطّلاع على المكتبات في 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) المَعلمات:  other:  LatLng القيمة المعروضة:  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

يتم قبول الكائنات الحرفية بدلاً من كائنات 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]) المَعلمات:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional تنشئ هذه الدالة مستطيلاً من النقاط في الزاويتَين الجنوبية الغربية والشمالية الشرقية.

الثوابت
MAX_BOUNDS	‫LatLngBounds للحدود القصوى للأرض ستشمل هذه الحدود العالم بأكمله.

الطُرق
contains	contains(latLng) المَعلمات:  latLng:  LatLng|LatLngLiteral القيمة المعروضة:  boolean تعرض هذه الدالة القيمة true إذا كان خط العرض/خط الطول المحدّد يقع ضمن هذه الحدود.
equals	equals(other) المَعلمات:  other:  LatLngBounds|LatLngBoundsLiteral optional القيمة المعروضة:  boolean تعرض هذه الدالة القيمة true إذا كانت هذه الحدود تساوي تقريبًا الحدود المحدّدة.
extend	extend(point) المَعلمات:  point:  LatLng|LatLngLiteral القيمة المعروضة:  LatLngBounds يوسّع هذه الحدود لتشمل النقطة المحدّدة.
getCenter	getCenter() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  LatLng تحسب مركز LatLngBounds هذا
getNorthEast	getNorthEast() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  LatLng تعرض هذه السمة الزاوية الشمالية الشرقية لهذه الحدود.
getSouthWest	getSouthWest() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  LatLng لعرض الزاوية الجنوبية الغربية لهذه الحدود
intersects	intersects(other) المَعلمات:  other:  LatLngBounds|LatLngBoundsLiteral القيمة المعروضة:  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) المَعلمات:  other:  LatLngBounds|LatLngBoundsLiteral القيمة المعروضة:  LatLngBounds يوسّع هذه الحدود لتشمل اتحاد هذه الحدود والحدود المحدّدة.

LatLngBoundsLiteral interface

واجهة 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) المَعلمات:  ‫other:  LatLngAltitude optional عنصر LatLngAltitude آخر القيمة المعروضة:  boolean ما إذا كان الكائنان متساويين. دالة المقارنة
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  LatLngAltitudeLiteral تمثيل JSON لهذا العنصر

واجهة LatLngAltitudeLiteral

واجهة google.maps.LatLngAltitudeLiteral

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

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

الخصائص
lat	النوع:  number خط العرض بالدرجات سيتم تقريب القيم إلى النطاق [-90, 90]. وهذا يعني أنّه إذا كانت القيمة المحدّدة أقل من ‎-90، سيتم ضبطها على ‎-90. وإذا كانت القيمة أكبر من 90، سيتم ضبطها على 90.
lng	النوع:  number خط الطول بالدرجات سيتم التفاف القيم خارج النطاق [-180, 180] لتقع ضمن النطاق. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم تحويل القيمة 190 إلى ‎-170. ويعكس ذلك حقيقة أنّ خطوط الطول تلتف حول الكرة الأرضية.
altitude optional	النوع:  number optional القيمة التلقائية: 0 المسافة (بالأمتار) فوق سطح الأرض وتعني القيمة السالبة تحت سطح الأرض.

فئة Point

صف واحد (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) المَعلمات:  other:  Point optional القيمة المعروضة:  boolean لمقارنة نقطتَين
toString	toString() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  string تعرض هذه الدالة تمثيل سلسلة لهذه النقطة.

Size class

صف واحد (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 حجم ثنائي الأبعاد، حيث يمثّل العرض المسافة على المحور x، ويمثّل الارتفاع المسافة على المحور y.

الخصائص
height	النوع:  number الارتفاع على طول المحور ص، بالبكسل
width	النوع:  number العرض على طول المحور س، بالبكسل

الطُرق
equals	equals(other) المَعلمات:  other:  Size optional القيمة المعروضة:  boolean لمقارنة حجمَين
toString	toString() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  string تعرض هذه الدالة تمثيل سلسلة لهذا الحجم.

واجهة Padding

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

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

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

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

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

الشركة المصنِّعة
Orientation3D	Orientation3D(value) المَعلمات:  ‫value:  Orientation3D|Orientation3DLiteral قيمة الإعداد الأولي

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

الطُرق
equals	equals(other) المَعلمات:  ‫other:  Orientation3D|Orientation3DLiteral optional عنصر Orientation3D آخر القيمة المعروضة:  boolean ما إذا كان الكائنان متساويين. دالة المقارنة
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Orientation3DLiteral يتم التحويل إلى تمثيل JSON. هذه الدالة مخصّصة للاستخدام من خلال JSON.stringify.

Orientation3DLiteral interface

واجهة google.maps.Orientation3DLiteral

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

الخصائص
heading optional	النوع:  number optional الدوران حول المحور z (عمودي على سطح الأرض) وتساوي القيمة 0 (القيمة التلقائية) الشمال. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360.
roll optional	النوع:  number optional تمثّل هذه السمة التدوير حول المحور الصادي. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور الصادي ويتم تحديده بالدرجات من 0 إلى 360.
tilt optional	النوع:  number optional تمثّل هذه السمة التدوير حول المحور 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) المَعلمات:  ‫value:  Vector3D|Vector3DLiteral قيمة الإعداد الأولي

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

الطُرق
equals	equals(other) المَعلمات:  ‫other:  Vector3D|Vector3DLiteral optional كائن Vector3D أو Vector3DLiteral آخر القيمة المعروضة:  boolean دالة المقارنة
toJSON	toJSON() المَعلمات:  لا تتوفّر أي مَعلمات القيمة المعروضة:  Vector3DLiteral يتم التحويل إلى تمثيل JSON. هذه الدالة مخصّصة للاستخدام من خلال JSON.stringify.

Vector3DLiteral interface

واجهة google.maps.Vector3DLiteral

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

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