שיעור ב-KmlLayer
מחלקה google.maps.KmlLayer
KmlLayer
מוסיף סימון גיאוגרפי למפה מקובץ KML, KMZ או GeoRSS שמתארח בשרת אינטרנט נגיש לציבור. בכל שלב מתבצעת אספקת אובייקט KmlFeatureData
לכל תכונה.
השיעור הזה נמשך
MVCObject
.
אפשר לקבל גישה על ידי התקשרות ל-const {KmlLayer} = await google.maps.importLibrary("maps")
. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
יצרן | |
---|---|
KmlLayer |
KmlLayer([opts]) פרמטרים:
יוצר KmlLayer שמציג את התוכן של קובץ KML/KMZ ספציפי (https://developers.google.com/KML/documentation/KMLreference) או קובץ GeoRSS (http://www.georss.org). |
שיטות | |
---|---|
getDefaultViewport |
getDefaultViewport() פרמטרים: ללא
ערך החזרה:
LatLngBounds קבלת אזור התצוגה שמוגדר כברירת מחדל לשכבה המוצגת. |
getMap |
getMap() פרמטרים: ללא
ערך החזרה:
Map קבלת המפה שבה מתבצע עיבוד של שכבת ה-KML. |
getMetadata |
getMetadata() פרמטרים: ללא
ערך החזרה:
KmlLayerMetadata מקבלים את המטא-נתונים המשויכים לשכבה הזו, כפי שמצוין בתגי העיצוב של השכבה. |
getStatus |
getStatus() פרמטרים: ללא
ערך החזרה:
KmlLayerStatus קבלת הסטטוס של השכבה, לאחר טעינת המסמך המבוקש. |
getUrl |
getUrl() פרמטרים: ללא
ערך החזרה:
string כתובת URLמתקבלת כתובת האתר של קובץ ה-KML שמוצג. |
getZIndex |
getZIndex() פרמטרים: ללא
ערך החזרה:
number אינדקס ה-z.מקבלת את אינדקס ה-z של שכבת ה-KML. |
setMap |
setMap(map) פרמטרים:
ערך החזרה: ללא
מעבד את שכבת ה-KML במפה שצוינה. אם המפה מוגדרת לערך null , השכבה תוסר. |
setOptions |
setOptions(options) פרמטרים:
ערך החזרה: ללא
|
setUrl |
setUrl(url) פרמטרים:
ערך החזרה: ללא
הגדרת כתובת ה-URL של קובץ ה-KML להצגה. |
setZIndex |
setZIndex(zIndex) פרמטרים:
ערך החזרה: ללא
מגדירה את אינדקס ה-z של שכבת KML. |
עברו בירושה:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
אירועים | |
---|---|
click |
function(kmlClickEvent) ארגומנטים:
האירוע הזה מופעל כשלוחצים על תכונה כלשהי בשכבה. |
defaultviewport_changed |
function() ארגומנטים: ללא
האירוע הזה מופעל כשאזור התצוגה שמוגדר כברירת מחדל בשכבות של KML השתנה. |
status_changed |
function() ארגומנטים: ללא
האירוע הזה מופעל כשטעינת ה-KML מסתיימת. בשלב זה, בטוח לקרוא את מאפיין הסטטוס כדי לקבוע אם השכבה נטענת בהצלחה. |
הממשק של KmlLayer options
ממשק google.maps.KmlLayerOptions
האובייקט הזה מגדיר את המאפיינים שאפשר להגדיר באובייקט KmlLayer
.
נכסים | |
---|---|
clickable optional |
סוג:
boolean optional ברירת מחדל:
true אם הערך true , השכבה מקבלת אירועי עכבר. |
map optional |
סוג:
Map optional המפה שבה יש להציג את השכבה. |
preserveViewport optional |
סוג:
boolean optional ברירת מחדל:
false אם האפשרות הזו מוגדרת כ- true או אם מרכז המפה ומרחק התצוגה מעולם לא הוגדרו, מפת הקלט ממורכזת ומתמקדת בתיבה המוקפת בתוכן של השכבה. |
screenOverlays optional |
סוג:
boolean optional ברירת מחדל:
true הגדרה אם לעבד את שכבות-העל במסך. |
suppressInfoWindows optional |
סוג:
boolean optional הסתר את הרינדור של חלונות המידע בעת לחיצה על תכונות של שכבות. |
url optional |
סוג:
string optional כתובת ה-URL של מסמך ה-KML להצגה. |
zIndex optional |
סוג:
number optional אינדקס ה-z של השכבה. |
הממשק של KmlLayerMetadata
ממשק google.maps.KmlLayerMetadata
מטא-נתונים עבור שכבת KML אחת, בפורמט JSON.
נכסים | |
---|---|
author |
סוג:
KmlAuthor <atom:author> של השכבה, שחולצה מהסימון של השכבה. |
description |
סוג:
string <description> של השכבה, שחולצה מהסימון של השכבה. |
hasScreenOverlays |
סוג:
boolean אם לשכבה יש שכבות-על במסך. |
name |
סוג:
string <name> של השכבה, שחולצה מהסימון של השכבה. |
snippet |
סוג:
string <Snippet> של השכבה, שחולצה מהסימון של השכבה |
קבועים ב-KmlLayerStatus
google.maps.KmlLayerStatus
קבועים
הסטטוס שמוחזר על ידי KmlLayer
עם השלמת הטעינה של מסמך. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'OK'
או google.maps.KmlLayerStatus.OK
.
אפשר לקבל גישה על ידי התקשרות ל-const {KmlLayerStatus} = await google.maps.importLibrary("maps")
. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
קבועים | |
---|---|
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 אובייקט 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> של התכונה, שחולץ מהסימון של השכבה. |