Geometry Library

מרחב השמות encoding

מרחב שמות google.maps.geometry.encoding
ספרייה "geometry"

כלי עזר לקידוד ולפענוח של קווים פוליגוניים.

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
פרמטרים:
  • encodedPath: string
ערך מוחזר: Array<LatLng>
הפונקציה מפענחת מחרוזת נתיב מקודדת לרצף של LatLngs.
encodePath
encodePath(path)
פרמטרים:
ערך מוחזר: string
מקודד רצף של LatLngs למחרוזת נתיב מקודדת.

מרחב השמות spherical

מרחב שמות google.maps.geometry.spherical
ספרייה "geometry"

פונקציות בסיסיות לחישוב זוויות, מרחקים ואזורים גיאודזיים. רדיוס ברירת המחדל הוא הרדיוס של כדור הארץ, 6,378,137 מטרים.

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
פרמטרים:
ערך מוחזר: number
מחזירה את השטח הלא חתום של נתיב סגור, בטווח [0, 2×pi×radius²]. השטח המחושב משתמש באותן יחידות כמו הרדיוס. ערך ברירת המחדל של radiusOfSphere הוא הרדיוס של כדור הארץ במטרים, ובמקרה כזה השטח הוא במטרים רבועים. כדי להעביר Circle, צריך להגדיר את radius לערך לא שלילי. בנוסף, העיגול לא יכול לכסות יותר מ-100% מהכדור. כשמעבירים LatLngBounds, קו הרוחב וקו האורך הדרומיים לא יכולים להיות צפוניים יותר מקו הרוחב וקו האורך הצפוניים.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
פרמטרים:
ערך מוחזר: number
הפונקציה מחזירה את המרחק במטרים בין שני אובייקטים מסוג LatLng. אפשר גם לציין רדיוס בהתאמה אישית. הרדיוס שמוגדר כברירת מחדל הוא הרדיוס של כדור הארץ.
computeHeading
computeHeading(from, to)
פרמטרים:
ערך מוחזר: number
מחזירה את הכיוון מנקודת LatLng אחת לנקודת LatLng אחרת. הכיוונים מבוטאים במעלות בכיוון השעון מהצפון, בטווח של ‎[-180,180).
computeLength
computeLength(path[, radius])
פרמטרים:
ערך מוחזר: number
מחזירה את האורך של הנתיב הנתון.
computeOffset
computeOffset(from, distance, heading[, radius])
פרמטרים:
ערך מוחזר: LatLng
הפונקציה מחזירה את ה-LatLng שנוצר כתוצאה מהזזה של מרחק מנקודת מוצא בכיוון שצוין (מבוטא במעלות בכיוון השעון מהצפון).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
פרמטרים:
ערך מוחזר: LatLng|null
מחזירה את מיקום המוצא כשמציינים יעד בפורמט LatLng, מרחק נסיעה במטרים וכיוון מקורי. הכיוונים מבוטאים במעלות בכיוון השעון מהצפון. הפונקציה הזו מחזירה את הערך null כשאין פתרון זמין.
computeSignedArea
computeSignedArea(loop[, radius])
פרמטרים:
ערך מוחזר: number
הפונקציה מחזירה את השטח החתום של נתיב סגור, שבו נגד כיוון השעון הוא חיובי, בטווח [‎-2×pi×radius², 2×pi×radius²‎]. השטח המחושב משתמש באותן יחידות כמו הרדיוס. הרדיוס שמוגדר כברירת מחדל הוא הרדיוס של כדור הארץ במטרים, ובמקרה כזה השטח הוא במטרים רבועים.

השטח מחושב באמצעות השיטה העברה מקבילה. ההעברה המקבילה סביב נתיב סגור בספירת היחידה מתפתלת בזווית ששווה לשטח שמוקף על ידי הנתיב. השיטה הזו פשוטה, מדויקת ויציבה יותר מטריאנגולציה באמצעות Girard, ‏ l'Huilier או Eriksson בכל משולש. במיוחד, מכיוון שהוא לא מבצע טריאנגולציה, הוא לא סובל מחוסר יציבות, למעט במקרה הבלתי נמנע שבו קצה (לא אלכסון) של הפוליגון משתרע על פני 180 מעלות.
interpolate
interpolate(from, to, fraction)
פרמטרים:
ערך מוחזר: LatLng
הפונקציה מחזירה את ה-LatLng שנמצא בחלק היחסי הנתון של הדרך בין ה-LatLng של נקודת המוצא ל-LatLng של היעד.
AlphatraversePath
traversePath(path, fraction)
פרמטרים:
ערך מוחזר: LatLngLiteral
הפונקציה מחזירה את המיקום שנמצא בחלק היחסי הנתון לאורך המסלול הנתון. אם מעבירים אובייקטים מסוג LatLngAltitude, המערכת מתעלמת כרגע מהגובה, אבל יכול להיות שבגרסאות עתידיות הגובה יילקח בחשבון.

poly namespace

מרחב שמות google.maps.geometry.poly
ספרייה "geometry"

פונקציות בסיסיות לחישובים שכוללים פוליגונים וקווים פוליגוניים.

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
פרמטרים:
ערך מוחזר: boolean
חישוב אם הנקודה הנתונה נמצאת בתוך הפוליגון שצוין.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
פרמטרים:
ערך מוחזר: boolean
הפונקציה מחשבת אם הנקודה הנתונה נמצאת על קו פוליגוני או קרוב אליו, או על קצה של פוליגון, בטווח סטייה שצוין. הפונקציה מחזירה את הערך true אם ההפרש בין קו הרוחב וקו האורך של הנקודה שצוינה לבין הנקודה הקרובה ביותר בקצה קטן מהטולרנס. ברירת המחדל של הטולרנטיות היא 10‎-9 מעלות.