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

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

Geometry Library

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

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

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

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

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

مساحة كروية

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

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

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

الطرق الثابتة
`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` لعرض العنوان من خط عرض LatLng إلى خط عرض LatLng آخر. يتم التعبير عن العناوين بدرجات اتجاه عقارب الساعة من الشمال ضمن النطاق [-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×pi×radius2, 2×pi×radius2]. تستخدم المنطقة المحسوبة الوحدات نفسها التي يستخدمها النطاق الجغرافي. يتم تعيين نصف القطر بشكلٍ افتراضي إلى نصف قطر الأرض بالأمتار، وفي هذه الحالة تكون المساحة بالأمتار المربعة. يتم حساب المنطقة باستخدام طريقة النقل الموازي، في حين ينحرف النقل الموازي حول مسار مغلق على كرة الوحدة على زاوية تساوي المنطقة التي يحيط بها المسار. وهذا أبسط وأكثر دقة وقوة من المسح المثلثي باستخدام Girard أو L'Huilier أو Eriksson على كل مثلث. وعلى وجه الخصوص، بما أنه لا يتم تحويله للمثلث، فإنه لا يعاني من عدم الاستقرار إلا في حالة لا مفر منها عند امتداد حافة (وليس قطريًا) للمضلع 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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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