Coordinates

خط الطول والعرض

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({lat: -34, lng: 151}, null, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, 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 قيمة الإرجاع:  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" لخط الطول والعرض هذا. ويتم تقريب قيم خطوط الطول/دوائر العرض إلى 6 أرقام عشرية بشكل تلقائي.

LatLngLiteral واجهة

واجهة google.maps.LatLngLiteral

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

أمثلة:

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

الشركة المصنِّعة
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	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 الصف الدراسي

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

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

ينفِّذ هذا الصف LatLngAltitudeLiteral.

ينفِّذ هذا الصف LatLngLiteral.

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

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

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) المعلّمات:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral|LatLng قيمة التهيئة 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 عندما تصادفها واجهة برمجة تطبيقات الخرائط.

تمتد هذه الواجهة LatLngLiteral.

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

فئة Point

google.maps.Point الصف الدراسي

الوصول من خلال الاتصال بـ 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 قيمة الإرجاع:  boolean يقارن نقطتين
toString	toString() المعلّمات: بدون قيمة الإرجاع:  string لعرض تمثيل لهذه السلسلة من النقاط.

Size class

google.maps.Size الصف الدراسي

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

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