إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

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

Geometry Library

ترميز مساحة الاسم

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

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

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

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

مساحة اسم كروية

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

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

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

طرق ثابتة
`computeArea`	`computeArea(path[, radiusOfSphere])` المَعلمات: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` قيمة الإرجاع: `number` لعرض المساحة غير الموقَّعة لمسار مغلق، في النطاق [0, 2×pi×radius2]. تستخدم المنطقة المحسوبة الوحدات نفسها المستخدَمة في نصف القطر. يتم ضبط `radiusOfSphere` تلقائيًا على نصف قطر الأرض بالمتر، وفي هذه الحالة تكون المنطقة بالمتر المربّع. يتطلب تمرير `Circle` ضبط `radius` على قيمة غير سالبة. بالإضافة إلى ذلك، يجب ألا تغطي الدائرة أكثر من 100% من الكرة. وعند تمرير `LatLngBounds`، لا يمكن أن يكون خط الطول والعرض الجنوبي أكثر شمالاً من خط الطول الشمالي.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` قيمة الإرجاع: `number` لعرض المسافة بالمتر بين خطين خط الطول والعرض. يمكنك تحديد نطاق جغرافي مخصص اختياريًا. يتم تعيين نصف القطر افتراضيًا على نصف قطر الأرض.
`computeHeading`	`computeHeading(from, to)` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` قيمة الإرجاع: `number` لعرض العنوان من خط LtLng إلى خط الطول والعرض الآخر. يتم التعبير عن العناوين بالدرجات في اتجاه عقارب الساعة من الشمال في النطاق [-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` تعرض موقع المنشأ عند توفيره مع وجهة خط الطول والعرض بالمتر والعنوان الأصلي. يتم التعبير عن العناوين بالدرجات في اتجاه عقارب الساعة من الشمال. تعرض هذه الدالة الخطأ `null` عندما لا يتوفّر أي حل.
`computeSignedArea`	`computeSignedArea(loop[, radius])` المَعلمات: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` قيمة الإرجاع: `number` لعرض المنطقة الموقّعة لمسار مغلق، حيث يكون عكس اتجاه عقارب الساعة موجبًا، في النطاق [-2×pi×radius2, 2×pi×radius2]. تستخدم المساحة المحسوبة الوحدات نفسها مثل نصف القطر. ويتم تعيين نصف القطر افتراضيًا على نصف قطر الأرض بالمتر، وفي هذه الحالة تكون المساحة بالمتر المربع. يتم احتساب المساحة باستخدام طريقة النقل المتوازي، أي أنّ النقل الموازي حول مسار مغلق على وحدة الكرة الأرضية يلتف على زاوية تساوي المساحة المحصورة بالمسار. وهو أبسط وأكثر دقة وقوة من المثلث باستخدام جيرارد أو ليلييه أو إريكسون على كل مثلث. وعلى وجه الخصوص، نظرًا لعدم إجراء مثلث، فإنّه لا يعاني من عدم استقرار إلا في الحالة التي لا مفر منها عندما تمتد حافة (وليس قطرًا) للمضلّع بزاوية 180 درجة.
`interpolate`	`interpolate(from, to, fraction)` المَعلمات: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` قيمة الإرجاع: `LatLng` تعرض خط الطول والعرض الذي يقع في الجزء المحدد من الطريق بين خط LatLng الأصلي والوجهة خط الطول والعرض.

مساحة الاسم poly

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

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

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

طرق ثابتة
`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 درجات.