حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Coordinates

LatLng class

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(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` لتفعيل القيم خارج هذا النطاق. يُرجى الانتباه إلى ترتيب خطوط الطول والعرض.

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

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 interface

يتم قبول القيم الحرفية للعناصر بدلاً من عناصر 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 interface

يتم قبول القيم الحرفية للعناصر بدلاً من عناصر LatLngBounds في جميع أنحاء واجهة برمجة التطبيقات. ويتم تحويلها تلقائيًا إلى عناصر LatLngBounds. يجب ضبط جميع قيم south وwest وnorth وeast، وإلا سيحدث خطأ.

الخصائص

Coordinates تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

LatLng class

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

الطُرق

واجهة LatLngLiteral

الخصائص

فئة LatLngBounds

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

الثوابت

الطُرق

LatLngBoundsLiteral interface

الخصائص

Coordinates