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]) المَعلمات:
تنشئ هذه الدالة عنصر LatLng يمثّل نقطة جغرافية. يتم تحديد خط العرض بالدرجات ضمن النطاق [-90, 90]. يتم تحديد خط الطول بالدرجات ضمن النطاق [-180, 180). اضبط noClampNoWrap على true لتفعيل القيم خارج هذا النطاق. يُرجى الانتباه إلى ترتيب خطوط الطول والعرض. |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
قيمة العائد:
boolean دالة المقارنة |
lat |
lat() المَعلمات: بدون
قيمة العائد:
number تعرض هذه السمة خط العرض بالدرجات. |
lng |
lng() المَعلمات: بدون
قيمة العائد:
number تعرض هذه السمة خط الطول بالدرجات. |
toJSON |
toJSON() المَعلمات: بدون
قيمة العائد:
LatLngLiteral تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify . |
toString |
toString() المَعلمات: بدون
قيمة العائد:
string تحويل إلى تمثيل سلسلة |
toUrlValue |
toUrlValue([precision]) المَعلمات:
قيمة العائد:
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]) المَعلمات:
تنشئ هذه الدالة مستطيلاً من النقاط الواقعة في الزاويتين الجنوبية الغربية والشمالية الشرقية. |
الثوابت | |
---|---|
MAX_BOUNDS |
LatLngBounds للحدود القصوى للأرض ستشمل هذه الحدود الكرة الأرضية بأكملها. |
الطُرق | |
---|---|
contains |
contains(latLng) المَعلمات:
قيمة العائد:
boolean تعرِض true إذا كانت خطوط الطول والعرض المحدّدة ضمن هذه الحدود. |
equals |
equals(other) المَعلمات:
قيمة العائد:
boolean تعرض true إذا كانت هذه الحدود تساوي الحدود المحدّدة تقريبًا. |
extend |
extend(point) المَعلمات:
قيمة العائد:
LatLngBounds توسّع هذه الحدود لتشمل النقطة المحدّدة. |
getCenter |
getCenter() المَعلمات: بدون
قيمة العائد:
LatLng تحسب هذه الطريقة مركز LatLngBounds. |
getNorthEast |
getNorthEast() المَعلمات: بدون
قيمة العائد:
LatLng تعرض هذه الدالة الزاوية الشمالية الشرقية لهذا المربع المحيط. |
getSouthWest |
getSouthWest() المَعلمات: بدون
قيمة العائد:
LatLng تعرض هذه الدالة الركن الجنوبي الغربي من هذه الحدود. |
intersects |
intersects(other) المَعلمات:
قيمة العائد:
boolean تعرض الدالة القيمة true إذا كانت هذه الحدود تتضمّن أي نقاط مشتركة مع الحدود الأخرى. |
isEmpty |
isEmpty() المَعلمات: بدون
قيمة العائد:
boolean تعرِض هذه السمة ما إذا كانت الحدود فارغة. |
toJSON |
toJSON() المَعلمات: بدون
قيمة العائد:
LatLngBoundsLiteral تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify . |
toSpan |
toSpan() المَعلمات: بدون
قيمة العائد:
LatLng تحويل حدود الخريطة المحدّدة إلى مدى خطوط الطول/العرض |
toString |
toString() المَعلمات: بدون
قيمة العائد:
string تحويل إلى سلسلة |
toUrlValue |
toUrlValue([precision]) المَعلمات:
قيمة العائد:
string تعرض هذه السمة سلسلة بالتنسيق "lat_lo,lng_lo,lat_hi,lng_hi" لهذه الحدود، حيث يشير "lo" إلى الزاوية الجنوبية الغربية للمربّع المحيط، بينما يشير "hi" إلى الزاوية الشمالية الشرقية لهذا المربّع. |
union |
union(other) المَعلمات:
قيمة العائد:
LatLngBounds توسّع هذه الحدود لتشمل اتحاد هذه الحدود والحدود المحدّدة. |
LatLngBoundsLiteral interface
google.maps.LatLngBoundsLiteral
interface
يتم قبول القيم الحرفية للعناصر بدلاً من عناصر 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]) المَعلمات:
|
الخصائص | |
---|---|
altitude |
النوع:
number تعرض هذه السمة الارتفاع. |
lat |
النوع:
number تعرض هذه السمة خط العرض. |
lng |
النوع:
number تعرض هذه السمة خط الطول. |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
القيمة المعروضة:
boolean ما إذا كان العنصران متساويين.دالة المقارنة |
toJSON |
toJSON() المَعلمات: بدون
قيمة الإرجاع:
LatLngAltitudeLiteral تمثيل JSON لهذا العنصر. |
LatLngAltitudeLiteral interface
google.maps.LatLngAltitudeLiteral
interface
يتم قبول القيم الحرفية للعناصر بدلاً من عناصر LatLngAltitude
، وذلك لتسهيل الاستخدام، في العديد من الأماكن. ويتم تحويلها إلى عناصر LatLngAltitude
عندما تصادفها واجهة برمجة التطبيقات Maps 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")
.
اطّلِع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
---|---|
Point |
Point(x, y) المَعلمات:
نقطة على مستوى ثنائي الأبعاد |
الخصائص | |
---|---|
x |
النوع:
number الإحداثي X |
y |
النوع:
number الإحداثي Y |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
قيمة العائد:
boolean مقارنة بين نقطتَين |
toString |
toString() المَعلمات: بدون
قيمة العائد:
string تعرض هذه الدالة تمثيلاً كسلسلة من Point. |
فئة الحجم
google.maps.Size
صف
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Size} = await google.maps.importLibrary("core")
.
اطّلِع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) المَعلمات:
الحجم الثنائي الأبعاد، حيث يمثّل العرض المسافة على المحور x، ويمثّل الارتفاع المسافة على المحور y. |
الخصائص | |
---|---|
height |
النوع:
number تمثّل هذه السمة الارتفاع على طول المحور y، بالبكسل. |
width |
النوع:
number تمثّل هذه السمة العرض على طول المحور x، بوحدة البكسل. |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
قيمة العائد:
boolean تقارن هذه الدالة بين حجمَين. |
toString |
toString() المَعلمات: بدون
قيمة العائد:
string تعرض هذه الدالة تمثيلاً على شكل سلسلة لهذا الحجم. |
واجهة Padding
google.maps.Padding
interface
الخصائص | |
---|---|
bottom optional |
النوع:
number optional المساحة المتروكة للأسفل، بالبكسل |
left optional |
النوع:
number optional تمثّل هذه السمة المساحة المتروكة لليسار بوحدة البكسل. |
right optional |
النوع:
number optional المساحة المتروكة لليمين بالبكسل |
top optional |
النوع:
number optional تمثّل هذه السمة المساحة المتروكة للأعلى بوحدة البكسل. |
واجهة CircleLiteral
google.maps.CircleLiteral
interface
عنصر حرفي يمثّل دائرة.
توسّع هذه الواجهة
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) المَعلمات:
|
الخصائص | |
---|---|
heading |
النوع:
number القيمة التلقائية:
0 الدوران حول المحور z (العمودي على سطح الأرض) القيمة 0 (القيمة التلقائية) تساوي الشمال. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة -190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170. |
roll |
النوع:
number القيمة التلقائية:
0 التدوير حول المحور y يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور y ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة -190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170. |
tilt |
النوع:
number القيمة التلقائية:
0 الدوران حول المحور x يكون الدوران الموجب في اتجاه عقارب الساعة حول المحور x ويتم تحديده بالدرجات من 0 إلى 360. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقلّ عنه لكي تندرج ضمنه. على سبيل المثال، سيتم تحويل القيمة -190 إلى 170. سيتم أيضًا تحويل القيمة 530 إلى 170. |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
القيمة المعروضة:
boolean ما إذا كان العنصران متساويين.دالة المقارنة |
toJSON |
toJSON() المَعلمات: بدون
قيمة العائد:
Orientation3DLiteral تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify. |
واجهة Orientation3DLiteral
google.maps.Orientation3DLiteral
interface
يتم قبول القيم الحرفية للعناصر بدلاً من عناصر Orientation3D
، وذلك لتسهيل الاستخدام، في العديد من الأماكن. ويتم تحويلها إلى عناصر Orientation3D
عندما تصادفها واجهة برمجة التطبيقات Maps API.
الخصائص | |
---|---|
heading optional |
النوع:
number optional الدوران حول المحور z (العمودي على سطح الأرض) القيمة 0 (القيمة التلقائية) تساوي الشمال. يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360. |
roll optional |
النوع:
number optional التدوير حول المحور y يكون التدوير الموجب في اتجاه عقارب الساعة حول المحور y ويتم تحديده بالدرجات من 0 إلى 360. |
tilt optional |
النوع:
number optional الدوران حول المحور x يكون الدوران الموجب في اتجاه عقارب الساعة حول المحور 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) المَعلمات:
|
الخصائص | |
---|---|
x |
النوع:
number تمثّل هذه السمة المكوّن X للخط المتّجه الثلاثي الأبعاد. |
y |
النوع:
number تمثّل هذه السمة المكوّن Y للخط المتجه الثلاثي الأبعاد. |
z |
النوع:
number المكوّن Z للخط المتجه الثلاثي الأبعاد. |
الطُرق | |
---|---|
equals |
equals(other) المَعلمات:
قيمة العائد:
boolean دالة المقارنة |
toJSON |
toJSON() المَعلمات: بدون
قيمة العائد:
Vector3DLiteral تحويل إلى تمثيل JSON من المفترض استخدام هذه الدالة من خلال JSON.stringify. |
واجهة Vector3DLiteral
google.maps.Vector3DLiteral
interface
يتم قبول القيم الحرفية للعناصر بدلاً من عناصر Vector3D
، وذلك لتسهيل الاستخدام، في العديد من الأماكن. ويتم تحويلها إلى عناصر Vector3D
عندما تصادفها واجهة برمجة التطبيقات Maps API.
الخصائص | |
---|---|
x |
النوع:
number تمثّل هذه السمة المكوّن X للخط المتّجه الثلاثي الأبعاد. |
y |
النوع:
number تمثّل هذه السمة المكوّن Y للخط المتجه الثلاثي الأبعاد. |
z |
النوع:
number المكوّن Z للخط المتجه الثلاثي الأبعاد. |