Geometry Library

encoding class

google.maps.geometry.encoding class

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

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

spherical class

google.maps.geometry.spherical class

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

אפשר להתקשר אל const {spherical} = await google.maps.importLibrary("geometry") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
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 של היעד.

poly class

google.maps.geometry.poly class

פונקציות עזר לחישובים שכוללים פוליגונים וקווים פוליגוניים.

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