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 ترميز سلسلة من LatLngs في سلسلة مسار مرمّزة

spherical class

google.maps.geometry.spherical صف

دوال مساعدة لاحتساب الزوايا والمسافات والمساحات الجيوديسية نصف القطر التلقائي هو نصف قطر الأرض البالغ 6,378,137 مترًا.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم 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×radius²]. وتستخدم المساحة المحسوبة الوحدات نفسها المستخدمة في نصف القطر. يتم ضبط القيمة التلقائية للحقل 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 تعرض هذه السمة العنوان من 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 تعرض هذه الدالة 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×radius²‎, 2×pi×radius²‎]. تستخدم المساحة المحسوبة الوحدات نفسها المستخدمة في نصف القطر. يتم ضبط نصف القطر تلقائيًا على نصف قطر الأرض بالمتر، وفي هذه الحالة تكون المساحة بالمتر المربّع. يتم احتساب المساحة باستخدام طريقة النقل الموازي؛ حيث إنّ النقل الموازي حول مسار مغلق على كرة الوحدة ينحرف بزاوية تساوي المساحة المحاطة بالمسار. هذه الطريقة أبسط وأكثر دقة وفعالية من التثليث باستخدام Girard أو l'Huilier أو Eriksson على كل مثلث. على وجه الخصوص، وبما أنّه لا يحدّد الموقع الجغرافي باستخدام التثليث، لا يعاني من أي عدم استقرار إلا في الحالة التي لا يمكن تجنّبها عندما تمتد حافة (ليست قطرًا) من المضلّع على 180 درجة.
interpolate	interpolate(from, to, fraction) المَعلمات:  from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral fraction:  number قيمة العائد:  LatLng تعرض هذه الدالة LatLng الذي يقع على مسافة الكسر المحدّد بين LatLng المصدر وLatLng الوجهة.

poly class

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 درجة.