Coordinates

فئة LatLng

google.maps.LatLng صف
مكتبة "core"

‫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");

الشركة المصنِّعة

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|LatLngLiteral optional القيمة المعروضة: boolean دالة مقارنة بين عنصرَي LatLng. تعرض هذه الدالة القيمة "صحيح" إذا كانت الإحداثيات ضمن نطاق 1e-9 من بعضها البعض، و"خطأ" في الحالات الأخرى.
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 صف
مكتبة "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");

الشركة المصنِّعة
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 class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

‫LatLngAltitude هي نقطة ثلاثية الأبعاد في الإحداثيات الجغرافية: خط العرض وخط الطول والارتفاع.

• يتراوح خط العرض بين -90 و90 درجة، بما في ذلك هذين الرقمين. سيتم تقريب أي قيم أعلى أو أقل من هذا النطاق إلى النطاق [-90, 90]. وهذا يعني أنّه إذا كانت القيمة المحدّدة أقل من ‎-90، سيتم ضبطها على ‎-90. وإذا كانت القيمة أكبر من 90، سيتم ضبطها على 90.
• يتراوح خط الطول بين ‎-180 و180 درجة، شاملةً هذين الرقمين. سيتم التفاف القيم التي تقع فوق هذا النطاق أو تحته لتقع ضمن النطاق. على سبيل المثال، سيتم تحويل القيمة ‎-190 إلى 170. سيتم تحويل القيمة 190 إلى ‎-170. ويعكس ذلك حقيقة أنّ خطوط الطول تلتف حول الكرة الأرضية.
• يتم قياس الارتفاع بالمتر. تشير القيم الموجبة إلى الارتفاعات فوق مستوى سطح الأرض، وتشير القيم السالبة إلى الارتفاعات تحت سطح الأرض.

const {LatLngAltitude} = await google.maps.importLibrary("core");

الشركة المصنِّعة
LatLngAltitude	LatLngAltitude(value[, noClampNoWrap]) المَعلمات: ‫value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral القيمة الأولية ‫noClampNoWrap: boolean optional لتحديد ما إذا كان سيتم الاحتفاظ بقيم الإعداد الأولي، حتى إذا لم تكن بالضرورة قيمًا صالحة لخط العرض في النطاق [-90, 90] أو قيمًا صالحة لخط الطول في النطاق [-180, 180]. الإعداد التلقائي هو false الذي يتيح تثبيت خط العرض والتفاف خط الطول.

الخصائص
altitude readonly	النوع: number تعرض الارتفاع.
lat readonly	النوع: number تعرض خط العرض.
lng readonly	النوع: number تعرض هذه الدالة خط الطول.

الطُرق
equals	equals(other) المَعلمات: ‫other: LatLngAltitude|LatLngAltitudeLiteral optional عنصر LatLngAltitude آخر القيمة المعروضة: boolean ما إذا كان العنصران متساويَين دالة مقارنة بين LatLngAltitudes. تعرض هذه الدالة القيمة "صحيح" إذا كانت الإحداثيات ضمن نطاق 1e-9 من بعضها البعض، و"خطأ" في الحالات الأخرى.
toJSON	toJSON([key]) المَعلمات: key: string optional القيمة المعروضة: LatLngAltitudeLiteral يتم تحويله إلى عنصر عادي.

واجهة LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

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

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

فئة Point

google.maps.Point صف
مكتبة "core"

const {Point} = await google.maps.importLibrary("core");

الشركة المصنِّعة
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 صف
مكتبة "core"

const {Size} = await google.maps.importLibrary("core");

الشركة المصنِّعة
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 اختياري	النوع: number optional المساحة المتروكة للأسفل بالبكسل
left اختياري	النوع: number optional المساحة المتروكة لليسار بالبكسل
right اختياري	النوع: number optional المساحة المتروكة لليمين بالبكسل
top اختياري	النوع: number optional المساحة المتروكة للأعلى بالبكسل

واجهة CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

كائن حرفي يمثّل دائرة

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

فئة Orientation3D

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

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

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

const {Orientation3D} = await google.maps.importLibrary("core");

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

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

الطُرق
equals	equals(other) المَعلمات: ‫other: Orientation3D|Orientation3DLiteral optional عنصر Orientation3D آخر القيمة المعروضة: boolean ما إذا كان العنصران متساويَين دالة المقارنة
toJSON	toJSON([key]) المَعلمات: key: string optional القيمة المعروضة: Orientation3DLiteral يتم تحويله إلى عنصر عادي.

Orientation3DLiteral interface

واجهة google.maps.Orientation3DLiteral

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

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

فئة Vector3D

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

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

• ‫x هو عدد حقيقي.
• ‫y هو عدد حقيقي.
• ‫z هو عدد حقيقي.

const {Vector3D} = await google.maps.importLibrary("core");

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

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

الطُرق
equals	equals(other) المَعلمات: ‫other: Vector3D|Vector3DLiteral optional كائن Vector3D أو Vector3DLiteral آخر القيمة المعروضة: boolean دالة المقارنة
toJSON	toJSON([key]) المَعلمات: key: string optional القيمة المعروضة: Vector3DLiteral يتم تحويله إلى عنصر عادي.

Vector3DLiteral interface

واجهة google.maps.Vector3DLiteral

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

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