KML

מחלקה KmlLayer

class google.maps.KmlLayer extends MVCObject
library "maps" 

const {KmlLayer} = await google.maps.importLibrary("maps");
KmlLayer
KmlLayer([opts])
פרמטרים:
יוצר KmlLayer שמציג את התוכן של קובץ KML/KMZ שצוין (https://developers.google.com/kml/documentation/kmlreference) או קובץ GeoRSS ‏ (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
פרמטרים: אין
ערך מוחזר: LatLngBounds|null
קבלת אזור התצוגה שמוגדר כברירת מחדל לשכבה שמוצגת.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
קבלת המפה שבה מוצגת שכבת ה-KML.
getMetadata
getMetadata()
פרמטרים: אין
ערך מוחזר: KmlLayerMetadata|null
קבלת המטא-נתונים שמשויכים לשכבה הזו, כפי שצוין בתגי העיצוב של השכבה.
getStatus
getStatus()
פרמטרים: אין
ערך מוחזר: KmlLayerStatus|null
אחזור הסטטוס של השכבה, שמוגדר אחרי שהמסמך המבוקש נטען.
getUrl
getUrl()
פרמטרים: אין
ערך מוחזר: כתובת URL של string
מקבל את כתובת ה-URL של קובץ ה-KML שמוצג.
getZIndex
getZIndex()
פרמטרים: אין
ערך מוחזר: number ה-z-index.
הפונקציה מחזירה את ה-z-index של שכבת ה-KML.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
הערך המוחזר: אין
הפונקציה מעבדת את שכבת ה-KML במפה שצוינה. אם המפה מוגדרת לערך null, השכבה תוסר.
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
setUrl
setUrl(url)
פרמטרים:
  • url: string
הערך המוחזר: אין
מגדיר את כתובת ה-URL של קובץ ה-KML שיוצג.
setZIndex
setZIndex(zIndex)
פרמטרים:
  • ‫zIndex: number ה-z-index שצריך להגדיר.
הערך המוחזר: אין
הגדרת ה-z-index של שכבת ה-KML.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
ארגומנטים:
האירוע הזה מופעל כשלוחצים על תכונה בשכבה.
defaultviewport_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשחל שינוי באזור התצוגה שמוגדר כברירת מחדל לשכבות KML.
status_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשהטעינה של שכבת ה-KML מסתיימת. בשלב הזה אפשר לקרוא את מאפיין הסטטוס כדי לקבוע אם השכבה נטענה בהצלחה.

הממשק KmlLayerOptions

ממשק google.maps.KmlLayerOptions

האובייקט הזה מגדיר את המאפיינים שאפשר להגדיר באובייקט KmlLayer.
clickable
אופציונלי
סוג: boolean optional
ברירת המחדל: true
אם הערך הוא true, השכבה מקבלת אירועי עכבר.
map
אופציונלי
סוג: Map optional
המפה שבה תוצג השכבה.
preserveViewport
אופציונלי
סוג: boolean optional
ברירת המחדל: false
אם האפשרות הזו מוגדרת לערך true או אם המרכז ורמת הזום של המפה לא הוגדרו אף פעם, המפה שנוספה ממורכזת ורמת הזום שלה מוגדרת לתיבה התוחמת של תוכן השכבה.
screenOverlays
אופציונלי
סוג: boolean optional
ברירת המחדל: true
הגדרה שקובעת אם לעבד את שכבות-העל במסך.
suppressInfoWindows
אופציונלי
סוג: boolean optional
ביטול העיבוד של חלונות מידע כשלוחצים על תכונות של שכבות.
url
אופציונלי
סוג: string optional
כתובת ה-URL של מסמך ה-KML שרוצים להציג.
zIndex
אופציונלי
סוג: number optional
ה-z-index של השכבה.

ממשק KmlLayerMetadata

ממשק google.maps.KmlLayerMetadata

מטא-נתונים של שכבת KML אחת, בפורמט JSON.
description
סוג: string
השדה <description> של השכבה, שחולץ מתגי העיצוב של השכבה.
hasScreenOverlays
סוג: boolean
אם לשכבה יש שכבות-על של מסך.
name
סוג: string
השדה <name> של השכבה, שחולץ מתגי העיצוב של השכבה.
snippet
סוג: string
השכבה <Snippet>, חולצה מתגי העיצוב של השכבה
author
אופציונלי
סוג: KmlAuthor optional
השדה <atom:author> של השכבה, שחולץ מתגי העיצוב של השכבה.

ערכי KmlLayerStatus קבועים

constants google.maps.KmlLayerStatus
ספרייה "maps"

הסטטוס שמוחזר על ידי KmlLayer בסיום הטעינה של מסמך. אפשר לציין אותם לפי ערך או לפי שם הקבוע. לדוגמה, 'OK' או google.maps.KmlLayerStatus.OK.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג KmlLayerStatusString.

const {KmlLayerStatus} = await google.maps.importLibrary("maps");
DOCUMENT_NOT_FOUND המסמך לא נמצא. סביר להניח שכתובת ה-URL לא תקינה או שהמסמך לא זמין לכולם.
DOCUMENT_TOO_LARGE המסמך חורג ממגבלות גודל הקובץ של KmlLayer.
FETCH_ERROR לא ניתן לאחזר את המסמך.
INVALID_DOCUMENT המסמך הוא לא מסמך KML, ‏ KMZ או GeoRSS תקין.
INVALID_REQUEST הערך של KmlLayer לא תקין.
LIMITS_EXCEEDED המסמך חורג ממגבלות הישויות של KmlLayer.
OK השכבה נטענה.
TIMED_OUT לא ניתן היה לטעון את המסמך בזמן סביר.
UNKNOWN המסמך לא נטען מסיבה לא ידועה.

ממשק KmlMouseEvent

ממשק google.maps.KmlMouseEvent

המאפיינים של אירוע מסוג קליק במסמך KML/KMZ או GeoRSS.
featureData
אובייקט KmlFeatureData שמכיל מידע על התכונה שנלחצה.
latLng
סוג: LatLng
המיקום שבו יוצמד חלון מידע לתכונה שנלחצה.
pixelOffset
סוג: Size
ההיסט שצריך להחיל על חלון מידע שמעוגן לתכונה שנלחצה.

ממשק KmlFeatureData

ממשק google.maps.KmlFeatureData

נתונים של תכונת KML אחת בפורמט JSON, שמוחזרים כשלוחצים על תכונת KML. הנתונים שכלולים באובייקט הזה משקפים את הנתונים שמשויכים לישות בתגי העיצוב של KML או GeoRSS שבהם היא מוצהרת.
author
סוג: KmlAuthor
המאפיין <atom:author> של הישות, שחולץ מתגי העיצוב של השכבה (אם צוין).
description
סוג: string
המאפיין <description>, שחולץ מתגי העיצוב של השכבה.
id
סוג: string
המאפיין <id>, שחולץ מתגי העיצוב של השכבה. אם לא צוין <id>, המערכת תיצור מזהה ייחודי לתכונה הזו.
infoWindowHtml
סוג: string
הטקסט המעוצב של הבלון של התכונה, אם הוא מוגדר.
name
סוג: string
המאפיין <name>, שחולץ מתגי העיצוב של השכבה.
snippet
סוג: string
המאפיין <Snippet>, שחולץ מתגי העיצוב של השכבה.

ממשק KmlAuthor

ממשק google.maps.KmlAuthor

מכיל פרטים על המחבר של מסמך או תכונה ב-KML.
email
סוג: string
כתובת האימייל של המחבר, או מחרוזת ריקה אם היא לא צוינה.
name
סוג: string
שם המחבר, או מחרוזת ריקה אם לא צוין שם.
uri
סוג: string
דף הבית של המחבר, או מחרוזת ריקה אם לא צוין.