Geometry Library

מרחב השמות encoding

google.maps.geometry.encoding namespace
library "geometry"

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

const {encoding} = await google.maps.importLibrary("geometry");

שיטות סטטיות
decodePath	decodePath(encodedPath) פרמטרים: encodedPath: string ערך מוחזר: Array<LatLng> הפונקציה מפענחת מחרוזת נתיב מקודדת לרצף של LatLngs.
encodePath	encodePath(path) פרמטרים: path: Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> ערך מוחזר: string מקודד רצף של LatLngs למחרוזת נתיב מקודדת.

מרחב השמות spherical

google.maps.geometry.spherical namespace
library "geometry"

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

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×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 של היעד.
traversePath	הערה: זמין רק ב-v=alpha channel. traversePath(path, fraction) פרמטרים: path: Array<LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral> fraction: number ערך מוחזר: LatLngLiteral הפונקציה מחזירה את המיקום שנמצא בחלק היחסי הנתון לאורך המסלול הנתון. אם מעבירים אובייקטים מסוג LatLngAltitude, המערכת מתעלמת כרגע מהגובה, אבל יכול להיות שבגרסאות עתידיות הגובה יילקח בחשבון.

poly namespace

google.maps.geometry.poly namespace
library "geometry"

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

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 מעלות.