إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

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

Geometry Library

مساحة اسم التشفير

google.maps.geometry.encoding مساحة الاسم

أدوات لترميز خطوط الالتفاف وفك ترميزها

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

الطرق الثابتة
`decodePath`	`decodePath(encodedPath)` المَعلمات: `encodedPath`: `string` القيمة المعروضة: `Array<LatLng>` فك ترميز سلسلة مسار مشفّرة إلى تسلسل من خطوط الطول والعرض
`encodePath`	`encodePath(path)` المَعلمات: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` القيمة المعروضة: `string` ترميز تسلسل LatLngs إلى سلسلة مسار مُشفّرة

الصور المجسمة

google.maps.geometry.spherical class

دوال مساعدة لاحتساب الزوايا والمسافات والمساحات الجيوديسية ونطاق العرض التلقائي هو 6378137 مترًا، وهو نطاق عرض الأرض.

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

الطرق الثابتة
`computeArea`	`computeArea(path[, radiusOfSphere])` المَعلمات: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` القيمة المعروضة: `number` عرض مساحة غير موقَّعة لمسار مغلق، في النطاق [0، 2×باي×نصف القطر²] القيمة التلقائية للمَعلمة `radiusOfSphere` هي نصف قطر الأرض بالأمتار، وفي هذه الحالة تكون المساحة بالمتر المربّع. يتطلّب تمرير `Circle` ضبط `radius` على قيمة غير سالبة. بالإضافة إلى ذلك، يجب ألا تغطي الدائرة أكثر من% 100 من الكرة. وعند تمرير `LatLngBounds`، لا يمكن أن تكون الإحداثيات الجغرافية الجنوبية لخط العرض وخط الطول أبعد شمالًا من الإحداثيات الجغرافية الشمالية لخط العرض وخط الطول.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` القيمة المعروضة: `number` لعرض المسافة، بالكيلومترات، بين نقطتَي LatLng. يمكنك اختياريًا تحديد دائرة نصف قطرها مخصّصة. يتم ضبط نصف القطر تلقائيًا على نصف قطر الأرض.
`computeHeading`	`computeHeading(from, to)` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` القيمة المعروضة: `number` عرض الاتجاه من خطوط الطول والعرض إلى خطوط الطول والعرض الأخرى يتم التعبير عن الاتجاهات بالدرجات باتجاه عقارب الساعة من الشمال ضمن النطاق [-180,180).
`computeLength`	`computeLength(path[, radius])` المَعلمات: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` القيمة المعروضة: `number` لعرض طول المسار المحدّد.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` المَعلمات: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` القيمة المعروضة: `LatLng` لعرض الإحداثيات الجغرافية الناتجة عن التنقّل لمسافة من نقطة أصل في الاتجاه المحدّد (يتم التعبير عنها بالدرجات باتجاه عقارب الساعة من الشمال).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` المَعلمات: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` القيمة المعروضة: `LatLng\|null` تعرِض هذه الدالة الموقع الجغرافي الأصلي عند تزويدها بوجهة LatLng وعدد الأمتار التي تم قطعها والعنوان الأصلي. يتم التعبير عن الاتجاهات بالدرجات في اتجاه عقارب الساعة من الشمال. تُرجع هذه الدالة `null` عندما لا يتوفّر أي حلّ.
`computeSignedArea`	`computeSignedArea(loop[, radius])` المَعلمات: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` القيمة المعروضة: `number` عرض المساحة ذات القيمة الموجبة لمسار مغلق، حيث تكون القيمة الموجبة في اتجاه عقارب الساعة، في النطاق [-2×باي×نصف القطر²، 2×باي×نصف القطر²] يتم ضبط نصف القطر تلقائيًا على نصف قطر الأرض بالمتر، وفي هذه الحالة تكون المساحة بالمتر المربّع. يتم احتساب المساحة باستخدام طريقة النقل المتوازي، حيث يتم الالتفاف حول مسار مغلق على كرة الوحدة بزاوية تساوي المساحة التي يحيط بها المسار. وهذا أبسط وأكثر دقة وفعالية من تحديد الموقع باستخدام طريقة تحديد الموقع الثلاثي باستخدام Girard أو l'Huilier أو Eriksson في كل مثلث. وعلى وجه الخصوص، بما أنّه لا يتم تقسيمه إلى مثلثات، لا يواجه أيّ عدم استقرار إلا في الحالة التي لا يمكن تجنّبها عندما تبلغ الحافة (وليس قطرها) للمضلّع 180 درجة.
`interpolate`	`interpolate(from, to, fraction)` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` القيمة المعروضة: `LatLng` لعرض إحداثيات خط الطول والعرض التي تقع على بعد جزء معيّن من الطريق بين إحداثيات خط الطول والعرض لنقطة الانطلاق ونقطة الوجهة

poly class

google.maps.geometry.poly class

دوالّ مساعدة للعمليات الحسابية التي تتضمّن المضلّعات والخطوط المتعددة

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

الطرق الثابتة
`containsLocation`	`containsLocation(point, polygon)` المَعلمات: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` القيمة المعروضة: `boolean` تُحدِّد ما إذا كانت النقطة المحدَّدة تقع داخل المضلّع المحدَّد.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` المَعلمات: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` القيمة المعروضة: `boolean` تحسب هذه الدالة ما إذا كانت النقطة المحدّدة تقع على خط متعدد الأضلاع أو بالقرب منه أو على حافة مضلّع ضمن حدّ مقبول محدّد. تعرِض هذه الدالة القيمة `true` عندما يكون الفرق بين خطوط الطول والعرض للنقطة المقدَّمة وأقرب نقطة على الحافة أقل من الحدّ المسموح به. القيمة التلقائية للتفاوت هي 10^-9 درجة.

الطرق الثابتة

containsLocation

containsLocation(point, polygon)

المَعلمات:

point: LatLng|LatLngLiteral
polygon: Polygon

القيمة المعروضة: boolean

تُحدِّد ما إذا كانت النقطة المحدَّدة تقع داخل المضلّع المحدَّد.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

المَعلمات:

point: LatLng|LatLngLiteral
poly: Polygon|Polyline
tolerance: number optional

القيمة المعروضة: boolean

تحسب هذه الدالة ما إذا كانت النقطة المحدّدة تقع على خط متعدد الأضلاع أو بالقرب منه أو على حافة مضلّع ضمن حدّ مقبول محدّد. تعرِض هذه الدالة القيمة true عندما يكون الفرق بين خطوط الطول والعرض للنقطة المقدَّمة وأقرب نقطة على الحافة أقل من الحدّ المسموح به. القيمة التلقائية للتفاوت هي 10^-9 درجة.