‫ Places UI Kit: ספרייה מוכנה לשימוש שמאפשרת למפתחים להתאים אישית ולשלוט. כדאי לנסות ולשתף את המשוב שלך על חוויית השימוש בערכת ממשק המשתמש.

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

Polygons

‫Polyline class

google.maps.Polyline class

קו פוליגוני הוא שכבת-על לינארית של קטעי קו מחוברים במפה.

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {Polyline} = await google.maps.importLibrary("maps") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
`Polyline`	`Polyline([opts])` פרמטרים: `opts`: `PolylineOptions optional` יוצרים קו פוליגוני באמצעות `PolylineOptions` שהועבר, שמציין גם את הנתיב של הקו הפוליגוני וגם את סגנון הקו לשימוש בשרטוט הקו הפוליגוני. כשיוצרים קו פוליגוני, אפשר להעביר מערך של `LatLng`s או `MVCArray` של `LatLng`s, אבל מערכים פשוטים מומרים ל-`MVCArray`s בתוך הקו הפוליגוני בזמן יצירת המופע.

יצרן

Polyline

Polyline([opts])

פרמטרים:

opts: PolylineOptions optional

יוצרים קו פוליגוני באמצעות PolylineOptions שהועבר, שמציין גם את הנתיב של הקו הפוליגוני וגם את סגנון הקו לשימוש בשרטוט הקו הפוליגוני. כשיוצרים קו פוליגוני, אפשר להעביר מערך של LatLngs או MVCArray של LatLngs, אבל מערכים פשוטים מומרים ל-MVCArrays בתוך הקו הפוליגוני בזמן יצירת המופע.

Methods
`getDraggable`	`getDraggable()` פרמטרים: אין ערך מוחזר: `boolean` הפונקציה מחזירה אם המשתמש יכול לגרור את הצורה הזו.
`getEditable`	`getEditable()` פרמטרים: אין ערך מוחזר: `boolean` הפונקציה מחזירה את הערך true אם המשתמש יכול לערוך את הצורה, ואת הערך false אם לא.
`getMap`	`getMap()` פרמטרים: אין ערך מוחזר: `Map\|null` מחזירה את המפה שאליה הצורה הזו מצורפת.
`getPath`	`getPath()` פרמטרים: אין ערך מוחזר: `MVCArray<LatLng>` מאחזר את הנתיב.
`getVisible`	`getVisible()` פרמטרים: אין ערך מוחזר: `boolean` מחזירה אם הפוליגון הזה גלוי במפה.
`setDraggable`	`setDraggable(draggable)` פרמטרים: `draggable`: `boolean` ערך מוחזר: אין אם ההגדרה היא `true`, המשתמש יכול לגרור את הצורה הזו מעל המפה. המאפיין `geodesic` מגדיר את מצב הגרירה.
`setEditable`	`setEditable(editable)` פרמטרים: `editable`: `boolean` ערך מוחזר: אין אם המאפיין מוגדר ל-`true`, המשתמש יכול לערוך את הצורה הזו על ידי גרירת נקודות הבקרה שמוצגות בקודקודים ובכל פלח.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map optional` ערך מוחזר: אין הפונקציה מציגה את הצורה הזו במפה שצוינה. אם המפה מוגדרת לערך `null`, הצורה תוסר.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `PolylineOptions optional` ערך מוחזר: אין
`setPath`	`setPath(path)` פרמטרים: `path`: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral>` ערך מוחזר: אין מגדיר את הנתיב. פרטים נוספים מופיעים במאמר `PolylineOptions`.
`setVisible`	`setVisible(visible)` פרמטרים: `visible`: `boolean` ערך מוחזר: אין הפולי הזה מוסתר אם ההגדרה היא `false`.
בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`click`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע הקליק של DOM מופעל בקו הפוליגוני.
`contextmenu`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל ב-Poyline.
`dblclick`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע ה-DOM dblclick מופעל בקו הפוליגוני.
`drag`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את הקו המקוטע.
`dragend`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מפסיק לגרור את הקו המקוטע.
`dragstart`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מתחיל לגרור את הקו המקוטע.
`mousedown`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע mousedown של DOM מופעל ב-Polyline.
`mousemove`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע mousemove של DOM מופעל בקו הפוליגוני.
`mouseout`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשמזיזים את העכבר מחוץ לקו פוליגוני.
`mouseover`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשמעבירים את העכבר מעל קו פוליגוני.
`mouseup`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע mouseup של DOM מופעל בקו הפוליגוני.
`rightclick`	הוצא משימוש: כדי לתמוך בדפוסי שימוש כמו קליק עם Ctrl ב-macOS, צריך להשתמש באירוע `Polyline.contextmenu` במקום זאת. `function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשלוחצים לחיצה ימנית על קו פוליגוני.

‫PolylineOptions interface

google.maps.PolylineOptions ממשק

אובייקט PolylineOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-Polyline.

מאפיינים
`clickable optional`	סוג: `boolean optional` ברירת מחדל: `true` מציין אם הרכיב `Polyline` מטפל באירועי עכבר.
`draggable optional`	סוג: `boolean optional` ברירת מחדל: `false` אם ההגדרה היא `true`, המשתמש יכול לגרור את הצורה הזו מעל המפה. המאפיין `geodesic` מגדיר את מצב הגרירה.
`editable optional`	סוג: `boolean optional` ברירת מחדל: `false` אם המאפיין מוגדר ל-`true`, המשתמש יכול לערוך את הצורה הזו על ידי גרירת נקודות הבקרה שמוצגות בקודקודים ובכל פלח.
`geodesic optional`	סוג: `boolean optional` ברירת מחדל: `false` כשמגדירים את הערך `true`, הקצוות של הפוליגון מתפרשים כגאודזיים ויעקבו אחרי הקימור של כדור הארץ. כשמגדירים את הערך `false`, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך. שימו לב: הצורה של מצולע גאודזי עשויה להשתנות כשגוררים אותו, כי המידות נשמרות ביחס לפני השטח של כדור הארץ.
`icons optional`	סוג: `Array<IconSequence> optional` הסמלים שיוצגו לאורך הקו הפוליגוני.
`map optional`	סוג: `Map optional` המפה שבה יוצג הקו המרובה.
`path optional`	סוג: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral> optional` הרצף המסודר של הקואורדינטות של הקו הפוליגוני. אפשר לציין את הנתיב הזה באמצעות מערך פשוט של `LatLng` או באמצעות `MVCArray` של `LatLng`. שימו לב: אם מעבירים מערך פשוט, הוא יומר ל-`MVCArray`. הוספה או הסרה של LatLngs ב-`MVCArray` תעדכן אוטומטית את הקו המקוטע במפה.
`strokeColor optional`	סוג: `string optional` צבע הקו. יש תמיכה בכל הצבעים ב-CSS3, מלבד צבעים עם שמות מורחבים.
`strokeOpacity optional`	סוג: `number optional` האטימות של הקו בין 0.0 ל-1.0.
`strokeWeight optional`	סוג: `number optional` עובי הקו בפיקסלים.
`visible optional`	סוג: `boolean optional` ברירת מחדל: `true` האם הקו הזה גלוי במפה.
`zIndex optional`	סוג: `number optional` הערך של zIndex בהשוואה לפוליגונים אחרים.

ממשק IconSequence

google.maps.IconSequence ממשק

מתאר איך סמלים מוצגים בשורה.

אם הקו המקומט הוא גיאודזי, המרחקים שצוינו עבור offset ו-repeat מחושבים במטרים כברירת מחדל. אם מגדירים את ההיסט או את החזרה לערך פיקסל, המרחקים יחושבו בפיקסלים במסך.

מאפיינים
`fixedRotation optional`	סוג: `boolean optional` ברירת מחדל: `false` אם `true`, לכל סמל ברצף יש סיבוב קבוע זהה, ללא קשר לזווית של הקצה שבו הוא נמצא. אם `false`, כל סמל ברצף מסובב כך שיתיישר עם הקצה שלו.
`icon optional`	סוג: `Symbol optional` הסמל שיוצג על הקו.
`offset optional`	סוג: `string optional` ברירת מחדל: `'100%'` המרחק מתחילת הקו שבו הסמל יוצג. אפשר לציין את המרחק הזה באחוזים מאורך הקו (למשל, '50%') או בפיקסלים (למשל, '50px').
`repeat optional`	סוג: `string optional` ברירת מחדל: `0` המרחק בין סמלים עוקבים בקו. אפשר לציין את המרחק באחוזים מאורך הקו (למשל, '50%') או בפיקסלים (למשל, '50px'). כדי להשבית את החזרה על הסמל, מציינים '0'.

‫Polygon class

google.maps.Polygon class

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

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {Polygon} = await google.maps.importLibrary("maps") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
`Polygon`	`Polygon([opts])` פרמטרים: `opts`: `PolygonOptions optional` יוצרים מצולע באמצעות הפרמטרים `PolygonOptions`, שמציינים את הנתיב של המצולע, את סגנון הקו של הקצוות של המצולע ואת סגנון המילוי של האזורים הפנימיים של המצולע. פוליגון יכול להכיל נתיב אחד או יותר, וכל נתיב מורכב ממערך של `LatLng`s. כשיוצרים את הנתיבים האלה, אפשר להעביר מערך של LatLngs או `MVCArray` של `LatLng`s. מערכים מומרים ל-`MVCArray`s בתוך הפוליגון בזמן יצירת המופע.

יצרן

Polygon

Polygon([opts])

פרמטרים:

opts: PolygonOptions optional

יוצרים מצולע באמצעות הפרמטרים PolygonOptions, שמציינים את הנתיב של המצולע, את סגנון הקו של הקצוות של המצולע ואת סגנון המילוי של האזורים הפנימיים של המצולע. פוליגון יכול להכיל נתיב אחד או יותר, וכל נתיב מורכב ממערך של LatLngs. כשיוצרים את הנתיבים האלה, אפשר להעביר מערך של LatLngs או MVCArray של LatLngs. מערכים מומרים ל-MVCArrays בתוך הפוליגון בזמן יצירת המופע.

Methods
`getDraggable`	`getDraggable()` פרמטרים: אין ערך מוחזר: `boolean` הפונקציה מחזירה אם המשתמש יכול לגרור את הצורה הזו.
`getEditable`	`getEditable()` פרמטרים: אין ערך מוחזר: `boolean` הפונקציה מחזירה את הערך true אם המשתמש יכול לערוך את הצורה, ואת הערך false אם לא.
`getMap`	`getMap()` פרמטרים: אין ערך מוחזר: `Map\|null` מחזירה את המפה שאליה הצורה הזו מצורפת.
`getPath`	`getPath()` פרמטרים: אין ערך מוחזר: `MVCArray<LatLng>` מאחזר את הנתיב הראשון.
`getPaths`	`getPaths()` פרמטרים: אין ערך מוחזר: `MVCArray<MVCArray<LatLng>>` מאחזר את הנתיבים של המצולע הזה.
`getVisible`	`getVisible()` פרמטרים: אין ערך מוחזר: `boolean` מחזירה אם הפוליגון הזה גלוי במפה.
`setDraggable`	`setDraggable(draggable)` פרמטרים: `draggable`: `boolean` ערך מוחזר: אין אם ההגדרה היא `true`, המשתמש יכול לגרור את הצורה הזו מעל המפה. המאפיין `geodesic` מגדיר את מצב הגרירה.
`setEditable`	`setEditable(editable)` פרמטרים: `editable`: `boolean` ערך מוחזר: אין אם המאפיין מוגדר ל-`true`, המשתמש יכול לערוך את הצורה הזו על ידי גרירת נקודות הבקרה שמוצגות בקודקודים ובכל פלח.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map optional` ערך מוחזר: אין הפונקציה מציגה את הצורה הזו במפה שצוינה. אם המפה מוגדרת לערך `null`, הצורה תוסר.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `PolygonOptions optional` ערך מוחזר: אין
`setPath`	`setPath(path)` פרמטרים: `path`: `MVCArray<LatLng>\|Array<LatLng\|LatLngLiteral>` ערך מוחזר: אין מגדיר את הנתיב הראשון. פרטים נוספים מופיעים במאמר `PolygonOptions`.
`setPaths`	`setPaths(paths)` פרמטרים: `paths`: `MVCArray<MVCArray<LatLng>>\|MVCArray<LatLng>\|Array<Array<LatLng\|LatLngLiteral>>\|Array<LatLng\|LatLngLiteral>` ערך מוחזר: אין מגדיר את הנתיב של הפוליגון.
`setVisible`	`setVisible(visible)` פרמטרים: `visible`: `boolean` ערך מוחזר: אין הפולי הזה מוסתר אם ההגדרה היא `false`.
בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`click`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשהאירוע click ב-DOM מופעל על הפוליגון.
`contextmenu`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל ב-Polygon.
`dblclick`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע dblclick של DOM מופעל על הפוליגון.
`drag`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את המצולע.
`dragend`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מפסיק לגרור את המצולע.
`dragstart`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש מתחיל לגרור את המצולע.
`mousedown`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע mousedown של DOM מופעל על הפוליגון.
`mousemove`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע mousemove של DOM מופעל ב-Polygon.
`mouseout`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל ב-Polygon mouseout.
`mouseover`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשמעבירים את העכבר מעל Polygon.
`mouseup`	`function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשאירוע ה-mouseup של DOM מופעל על המצולע.
`rightclick`	הוצא משימוש: כדי לתמוך בדפוסי שימוש כמו קליק עם Ctrl ב-macOS, צריך להשתמש באירוע `Polygon.contextmenu` במקום זאת. `function(event)` ארגומנטים: `event`: `PolyMouseEvent` האירוע הזה מופעל כשלוחצים לחיצה ימנית על המצולע.

‫PolygonOptions interface

google.maps.PolygonOptions ממשק

אובייקט PolygonOptions שמשמש להגדרת המאפיינים שאפשר להגדיר בפוליגון.

מאפיינים
`clickable optional`	סוג: `boolean optional` ברירת מחדל: `true` מציין אם הרכיב `Polygon` מטפל באירועי עכבר.
`draggable optional`	סוג: `boolean optional` ברירת מחדל: `false` אם ההגדרה היא `true`, המשתמש יכול לגרור את הצורה הזו מעל המפה. המאפיין `geodesic` מגדיר את מצב הגרירה.
`editable optional`	סוג: `boolean optional` ברירת מחדל: `false` אם המאפיין מוגדר ל-`true`, המשתמש יכול לערוך את הצורה הזו על ידי גרירת נקודות הבקרה שמוצגות בקודקודים ובכל פלח.
`fillColor optional`	סוג: `string optional` צבע המילוי. יש תמיכה בכל הצבעים ב-CSS3, מלבד צבעים עם שמות מורחבים.
`fillOpacity optional`	סוג: `number optional` מידת האטימות של המילוי בין 0.0 ל-1.0
`geodesic optional`	סוג: `boolean optional` ברירת מחדל: `false` כשמגדירים את הערך `true`, הקצוות של הפוליגון מתפרשים כגאודזיים ויעקבו אחרי הקימור של כדור הארץ. כשמגדירים את הערך `false`, הקצוות של הפוליגון מוצגים כקווים ישרים במרחב המסך. שימו לב: הצורה של מצולע גאודזי עשויה להשתנות כשגוררים אותו, כי המידות נשמרות ביחס לפני השטח של כדור הארץ.
`map optional`	סוג: `Map optional` המפה שבה יוצג הפוליגון.
`paths optional`	סוג: `MVCArray<MVCArray<LatLng>>\|MVCArray<LatLng>\|Array<Array<LatLng\|LatLngLiteral>>\|Array<LatLng\|LatLngLiteral> optional` הרצף המסודר של הקואורדינטות שמגדיר לולאה סגורה. בניגוד לקו פוליגוני, פוליגון יכול לכלול נתיב אחד או יותר. כתוצאה מכך, יכול להיות שבמאפיין paths יצוין מערך אחד או יותר של קואורדינטות `LatLng`. הנתיבים נסגרים אוטומטית, לכן לא צריך לחזור על הקודקוד הראשון של הנתיב כקודקוד האחרון. אפשר להגדיר פוליגונים פשוטים באמצעות מערך יחיד של `LatLng`. במצולעים מורכבים יותר אפשר לציין מערך של מערכים. מערכים פשוטים מומרים ל-`MVCArray`. הוספה או הסרה של `LatLng`s מ-`MVCArray` יעדכנו אוטומטית את הפוליגון במפה.
`strokeColor optional`	סוג: `string optional` צבע הקו. יש תמיכה בכל הצבעים ב-CSS3, מלבד צבעים עם שמות מורחבים.
`strokeOpacity optional`	סוג: `number optional` האטימות של הקו בין 0.0 ל-1.0
`strokePosition optional`	סוג: `StrokePosition optional` ברירת מחדל: `StrokePosition.CENTER` מיקום המהלך.
`strokeWeight optional`	סוג: `number optional` עובי הקו בפיקסלים.
`visible optional`	סוג: `boolean optional` ברירת מחדל: `true` האם הפוליגון הזה גלוי במפה.
`zIndex optional`	סוג: `number optional` הערך של zIndex בהשוואה לפוליגונים אחרים.

‫PolyMouseEvent interface

google.maps.PolyMouseEvent ממשק

האובייקט הזה מוחזר מאירועי עכבר בקווי פוליגון ובפוליגונים.

הממשק הזה מרחיב את MapMouseEvent.

מאפיינים
`edge optional`	סוג: `number optional` האינדקס של הקצה בנתיב מתחת לסמן כשהאירוע התרחש, אם האירוע התרחש בנקודת אמצע במצולע שאפשר לערוך.
`path optional`	סוג: `number optional` האינדקס של הנתיב מתחת לסמן כשהאירוע התרחש, אם האירוע התרחש בקודקוד והמצולע ניתן לעריכה. אחרת `undefined`.
`vertex optional`	סוג: `number optional` האינדקס של הקודקוד שמתחת לסמן כשהאירוע התרחש, אם האירוע התרחש על קודקוד והקו או הפוליגון ניתנים לעריכה. אם האירוע לא מתרחש בקודקוד, הערך הוא `undefined`.
בירושה: `domEvent`, `latLng`

Methods
Inherited: `stop`

‫Rectangle class

google.maps.Rectangle class

שכבת-על של מלבן.

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {Rectangle} = await google.maps.importLibrary("maps") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא

Polygons קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

‫Polyline class

יצרן

Methods

אירועים

‫PolylineOptions interface

מאפיינים

ממשק IconSequence

מאפיינים

‫Polygon class

יצרן

Methods

אירועים

‫PolygonOptions interface

מאפיינים

‫PolyMouseEvent interface

מאפיינים

Methods

‫Rectangle class

Polygons