הודעת אבטחה: נודע לנו על בעיית אבטחה שעשויה להשפיע על אתרים שמשתמשים בספריות ספציפיות של צד שלישי (כולל 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>` מפענח מחרוזת נתיב מקודדת לרצף של רכיבי LatLng.
`encodePath`	`encodePath(path)` פרמטרים: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` הערך המוחזר: `string` מקודד רצף של מחרוזות LatLng למחרוזת נתיב מקודדת.

מרחב שמות ספרי

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`, אזור ה-LatLng הדרומי לא יכול להיות יותר צפונית מצפון ה-LatLng.
`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×radius2, 2×pi×radius2]. האזור המחושב משתמש באותן יחידות כמו הרדיוס. ברירת המחדל של הרדיוס היא רדיוס כדור הארץ במטרים, ובמקרה כזה האזור הוא במטרים רבועים. השטח מחושב באמצעות שיטת ההעברה המקבילה. התנועה המקבילה סביב נתיב סגור בספירה של היחידה מתפתלת בזווית ששווה לשטח שתחום בנתיב. שיטת הטריאנגולציה פשוטה, מדויקת ומדויקת יותר מאשר המשולש באמצעות גירארד, ל'Huilier או אריקסון על כל משולש. בפרט, מכיוון שהרכיב לא מטריאנגול, הוא לא סובל מחוסר יציבות, אלא במקרה בלתי נמנע כאשר קצה (לא אלכסון) של המצולע משתרע על פני 180 מעלות.
`interpolate`	`interpolate(from, to, fraction)` פרמטרים: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` הערך המוחזר: `LatLng` מחזירה את ה-LatLng, שנמצא את השבר הנתון של הדרך בין ה-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 מעלות.