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

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

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 عندما تصادفها API.

أمثلة:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

لا تتوافق العناصر الحرفية لعناصر LatLNG في مكتبة الهندسة الهندسية.

أماكن إقامة
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]) المعلّمات:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional إنشاء مستطيل من النقاط الواقعة في الزوايا الجنوبية الغربية والشمالية الشرقية.

الطُرق
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 تمديد هذه الحدود لتتضمّن اتحاد هذا الحد والحدود المعيّنة.

ثوابت
MAX_BOUNDS	LatLungBounds لمعرفة الحدود القصوى للأرض. ستشمل هذه الحدود الكرة الأرضية بالكامل.

واجهة LatLungBoundsLiteral

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

الشركة المصنِّعة
Point	Point(x, y) المعلّمات:  x:  number y:  number نقطة على مستوى ثنائي الأبعاد

أماكن إقامة
x	النوع:  number الإحداثيات X
y	النوع:  number المعادلة Y

الطُرق
equals	equals(other) المعلّمات:  other:  Point قيمة العرض:  boolean مقارنة نقطتين
toString	toString() المعلّمات: بدون قيمة العرض:  string تعرض تمثيلاً لسلسلة لهذه النقطة.

Size class

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

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

الشركة المصنِّعة
Size	Size(width, height[, widthUnit, heightUnit]) المعلّمات:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional حجم ثنائي الأبعاد، حيث يكون العرض هو المسافة على المحور س، والارتفاع هو المسافة على المحور ص.

أماكن إقامة
height	النوع:  number الارتفاع على طول المحور الصادي بالبكسل.
width	النوع:  number العرض على طول المحور "س"، بالبكسل.

الطُرق
equals	equals(other) المعلّمات:  other:  Size قيمة العرض:  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