הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יתעדכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להביע הסכמה מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

Geometry Library

מרחב השמות encoding

מרחב שמות 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×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` הפונקציה מחזירה את קו הרוחב והאורך שנמצא בחלק הנתון מהדרך בין קו הרוחב והאורך של נקודת המוצא לבין קו הרוחב והאורך של נקודת היעד.

מרחב השמות 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 מעלות.