API 1
Klasse "GMap2"
Instanziieren Sie die Klasse GMap2, wenn
Sie eine Karte erstellen möchten. Dies ist die zentrale Klasse des API. Alle
anderen Klassen sind Hilfsklassen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMap2(container:Node, opts?:GMapOptions)
|
Erstellt eine neue Karte in einem vorhandenen HTML-Container, bei dem
es sich üblicherweise um ein DIV-Element handelt. Ist im optionalen
Argument opts.mapTypes keine Gruppe von Kartentypen angegeben,
wird die Standardgruppe G_DEFAULT_MAP_TYPES verwendet. Ist
im optionalen Argument opts.size keine Größe angegeben, wird
die container-Größe verwendet. Ist opts.size
angegeben, wird die Größe des Containerelements der Karte entsprechend
angepasst. Siehe class GMapOptions. Hinweis: Karten müssen
zentriert werden, bevor sie verwendet werden können. Sie sollten umgehend
GMap2.setCenter() aufrufen,
um eine mit diesem Konstruktor erstellte Karte zu initialisieren. |
Methoden
Konfiguration
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
enableDragging() |
None |
Aktiviert das Verschieben der Karte (standardmäßig aktiviert). |
disableDragging() |
None |
Deaktiviert das Verschieben der Karte. |
draggingEnabled() |
Boolean |
Gibt true zurück, wenn das Verschieben der Karte aktiviert
ist. |
enableInfoWindow() |
None |
Aktiviert Infofenstervorgänge auf der Karte (standardmäßig aktiviert). |
disableInfoWindow() |
None |
Schließt das Infofenster, wenn es geöffnet ist, und deaktiviert das Öffnen eines neuen Infofensters. |
infoWindowEnabled() |
Boolean |
Gibt true zurück, wenn das Infofenster aktiviert ist. |
enableDoubleClickZoom() |
None |
Aktiviert das Doppelklicken zum Vergrößern und Verkleinern (standardmäßig
aktiviert).
(Seit 2,58) |
disableDoubleClickZoom() |
None |
Deaktiviert das Doppelklicken zum Vergrößern und Verkleinern.
(Seit 2,58) |
doubleClickZoomEnabled() |
Boolean |
Gibt true zurück, wenn das Doppelklicken zum Zoomen aktiviert
ist.
(Seit 2,58) |
enableContinuousZoom() |
None |
Aktiviert das fortlaufende gleichmäßige Zoomen für ausgewählte Browser
(standardmäßig deaktiviert).
(Seit 2,58) |
disableContinuousZoom() |
None |
Deaktiviert das fortlaufende gleichmäßige Zoomen.
(Seit 2,58) |
continuousZoomEnabled() |
Boolean |
Gibt true zurück, wenn das fortlaufende gleichmäßige Zoomen
aktiviert ist.
(Seit 2,58) |
enableGoogleBar() |
None |
Aktiviert die GoogleBar, ein integriertes Bedienelement zum Suchen,
für die Karte. Ist es aktiviert, ersetzt dieses Bedienelement das standardmäßige
Logo Powered by Google. Beachten Sie, dass dieses Bedienelement
standardmäßig nicht aktiviert ist.
(Seit 2,92) |
disableGoogleBar() |
None |
Deaktiviert das integrierte Such-Bedienelement GoogleBar. Ist
dieses deaktiviert, wird anstelle dieses Bedienelements das standardmäßige
Logo Powered by Google angezeigt. Beachten Sie, dass dieses Bedienelement
bereits standardmäßig deaktiviert ist.
(Seit 2,92) |
enableScrollWheelZoom() |
None |
Aktiviert das Zoomen mit dem Mausrad. Hinweis: Das Zoomen mit dem Mausrad
ist standardmäßig deaktiviert.
(Seit 2,78) |
disableScrollWheelZoom() |
None |
Deaktiviert das Zoomen mit dem Mausrad. Hinweis: Das Zoomen mit dem
Mausrad ist standardmäßig deaktiviert.
(Seit 2,78) |
scrollWheelZoomEnabled() |
Boolean |
Gibt einen booleschen Wert zurück, der angibt, ob das Zoomen mit dem
Mausrad aktiviert ist.
(Seit 2,78) |
Bedienelemente
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
addControl(control:GControl, position?:GControlPosition)
|
None |
Fügt das Bedienelement der Karte hinzu. Die Position auf der Karte
ergibt sich aus dem optionalen Argument position. Fehlt
dieses Argument, wird die Standardposition des Bedienelements verwendet,
die durch die Methode GControl.getDefaultPosition()
ermittelt wird. Eine Bedienelementinstanz darf nur einmal zur Karte
hinzugefügt werden. |
removeControl(control:GControl) |
None |
Entfernt das Bedienelement aus der Karte. Es wird nichts ausgeführt, wenn das Bedienelement nie zur Karte hinzugefügt wurde. |
getContainer() |
Node |
Gibt das DOM-Objekt zurück, das die Karte enthält. Wird von GControl.initialize()
verwendet. |
Kartentypen
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
getMapTypes() |
GMapType[] |
Gibt ein Array mit Kartentypen zurück, die mit dieser Karte registriert sind. |
getCurrentMapType() |
GMapType |
Gibt den aktuell ausgewählten Kartentyp zurück. |
setMapType(type:GMapType) |
None |
Wählt den angegebenen Kartentyp aus. Der Typ muss der Karte bekannt
sein. Siehe den Konstruktor und die Methode addMapType(). |
addMapType(type:GMapType) |
None |
Fügt der Karte einen neuen Kartentyp hinzu. Weitere Informationen
zum Definieren benutzerdefinierter Kartentypen finden Sie im Abschnitt
GMapType. |
removeMapType(type:GMapType) |
None |
Entfernt den Kartentyp aus der Karte. Aktualisiert die Schaltflächen,
die durch GMapTypeControl
oder GHierarchicalMapTypeControl
angezeigt werden, und löst das removemaptype-Ereignis aus. |
Kartenstatus
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
isLoaded() |
Boolean |
Gibt true zurück, wenn die Karte nach der Erstellung
durch setCenter() initialisiert wurde. |
getCenter() |
GLatLng |
Gibt die geografischen Koordinaten des Mittelpunkts der Kartenansicht zurück. |
getBounds() |
GLatLngBounds |
Gibt den sichtbaren rechteckigen Auswahlbereich der Kartenansicht in Form geografischer Koordinaten zurück. |
getBoundsZoomLevel |
Number |
Gibt die Zoomstufe zurück, bei der der rechteckige Auswahlbereich in die Kartenansicht passt. Die Zoomstufe wird für den aktuell ausgewählten Kartentyp berechnet. Wenn kein Kartentyp ausgewählt ist, wird der erste in der Liste der Kartentypen verwendet. |
getSize() |
GSize |
Gibt die Größe der Kartenansicht in Pixel zurück. |
getZoom() |
Number |
Gibt die aktuelle Zoomstufe zurück. |
getDragObject() |
GDraggableObject |
Gibt das verschiebbare Objekt zurück, das von dieser Karte verwendet
wird.
(Seit 2,93) |
getEarthInstance |
None |
Ruft die Instanz des an diese Karte angehängten Google
Earth-Browser-Plug-ins ab und ruft die übergebene Callback-Funktion
auf, sobald die Instanz zum Empfang von Befehlen bereit ist. Die Earth-Instanz
(ein GEPlugin-Objekt) wird dabei als Parameterübergeben.
Diese Callback-Funktion kann sofort ausgelöst werden, sofern die Earth-Instanz zuvor durch Einstellen des Google Earth-Kartentyps mithilfe von GMap2.setMapType(G_SATELLITE_3D_MAP)
instanziiert wurde. Wurde die Instanz noch nicht erstellt, wird das
Google Earth-Plug-in durch Aufrufen von getEarthInstance
initialisiert. (Aufgrund dieses asynchronen Verhaltens erfordert die
Methode ein Callback.) Hinweis: Sollte bei der Initialisierung ein Fehler auftreten,übergibt die Callback-Funktion den Parameter null. Mit dieser Methode wird zwar eine Google Earth-Instanz erstelle, der Earth-Kartentyp wird jedoch nicht als aktuelle Ansicht festgelegt. Rufen Sie hierzu GMap2.setMapType(G_SATELLITE_3D_MAP)
explizit auf oder gestatten Sie dem Nutzer die Auswahl dieser Karteüber das MapTypeControl. Nähere Informationen zur Verwendung
des ObjektsGEPlugin finden Sie im Google
Earth-API-Entwicklerhandbuch.
(Seit 2,113) |
Kartenstatus ändern
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
setCenter(center:GLatLng, zoom?:Number, type?:GMapType)
|
None |
Stellt die Kartenansicht auf den angegebenen Mittelpunkt ein. Optional
können auch die Zoomstufe und der Kartentyp angegeben werden. Der Kartentyp
muss der Karte bekannt sein. Siehe den Konstruktor und die Methode addMapType().
Diese Methode muss nach der Konstruktion zuerst aufgerufen werden, um
den anfänglichen Status der Karte festzulegen. Es ist ein Fehler, Vorgänge
für ein neu konstruiertes GMap2-Objekt
aufzurufen, bevor diese Funktion aufgerufen wurde. |
panTo(center:GLatLng) |
None |
Ändert den Mittelpunkt der Karte in den angegebenen Punkt. Wenn der Punkt in der aktuellen Kartenansicht bereits sichtbar ist, ändern Sie den Mittelpunkt in einer gleichmäßig ablaufenden Animation. |
panBy(distance:GSize) |
None |
Startet eine Pan-Animation mit der angegebenen Entfernung in Pixel. |
panDirection(dx:one of -1 0 +1, dy:one of -1 0 +1) |
None |
Startet eine Pan-Animation um die Hälfte der Kartenbreite in die angegebenen
Richtungen. +1 ist nach rechts und unten, -1
nach links und oben. |
setZoom(level:Number) |
None |
Setzt die Zoomstufe auf den angegebenen neuen Wert. |
zoomIn() |
None |
Erhöht die Zoomstufe um eins. |
zoomOut() |
None |
Verringert die Zoomstufe um eins. |
savePosition() |
None |
Speichert die aktuelle Kartenposition und Zoomstufe für einen späteren,
erneuten Aufruf durch returnToSavedPosition(). |
returnToSavedPosition() |
None |
Stellt die mit savePosition() gespeicherte Kartenansicht
wieder her. |
checkResize() |
None |
Benachrichtigt die Karteüber eine Größenänderung ihres Containers. Rufen Sie diese Methode auf, wenn sich die Größe des DOM-Containerobjekts geändert hat, um die Karte an die neue Größe anzupassen. |
Overlays
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
addOverlay(overlay:GOverlay) |
None |
Fügt der Karte ein Overlay hinzu und löst das addoverlay-Ereignis
aus. |
removeOverlay(overlay:GOverlay) |
None |
Entfernt das Overlay aus der Karte. Der Versuch, ein nicht auf der
Karte befindliches Overlay zu entfernen, ist ein Fehler. Ist der Aufruf
erfolgreich, wird das Ereignis removeoverlay ausgelöst. |
clearOverlays() |
None |
Entfernt alle Overlays aus der Karte und löst das clearoverlays-Ereignis
aus. |
getPane(pane:GMapPane) |
Node |
Gibt ein DIV-Element zurück, welches das Objekt in der durch pane
angegebenen Ebene enthält. Wird von GOverlay-Instanzen
in Instanzen der Methode GOverlay.initialize()
verwendet, womit diese sich auf der Karte einzeichnen. |
Infofenster
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
openInfoWindow(latlng:GLatLng, node:Node, opts?:GInfoWindowOptions)
|
None |
Öffnet an der angegebenen Position ein einfaches Infofenster. Schwenkt die Karte, sodass das geöffnete Infofenster vollständig sichtbar wird. Der Inhalt des Infofensters wird als DOM-Knoten angegeben. |
openInfoWindowHtml(latlng:GLatLng, html:String,
opts?:GInfoWindowOptions) |
None |
Öffnet an der angegebenen Position ein einfaches Infofenster. Schwenkt die Karte, sodass das geöffnete Infofenster vollständig sichtbar wird. Der Inhalt des Infofensters wird als HTML-Text angegeben. |
openInfoWindowTabs(latlng:GLatLng, tabs:GInfoWindowTab[],
opts?:GinfoWindowOptions) |
None |
Öffnet an der angegebenen Position ein Infofenster mit Registerkarten. Schwenkt die Karte, sodass das geöffnete Infofenster vollständig sichtbar wird. Der Inhalt des Infofensters wird als DOM-Knoten angegeben. |
openInfoWindowTabsHtml(latlng:GLatLng, tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions) |
None |
Öffnet an der angegebenen Position ein Infofenster mit Registerkarten. Schwenkt die Karte, sodass das geöffnete Infofenster vollständig sichtbar wird. Der Inhalt des Infofensters wird als HTML-Text angegeben. |
showMapBlowup(latlng:GLatLng, opts?:GInfoWindowOptions)
|
None |
Öffnet am angegebenen Punkt ein Infofenster, das eine Nahansicht der Karte um diesen Punkt herum enthält. |
updateInfoWindow(tabs:GInfoWindowTab[],
onupdate?:Function) |
None |
Aktualisiert den Inhalt des aktuell geöffneten GInfoWindow-Objekts,
ohne eine Neupositionierung durchzuführen. Die Größe des Infofensters
wird an den neuen Inhalt angepasst. Die optionale Callback-Funktion onupdate
wird aufgerufen, nachdem der Inhalt des Infofensters geändert wurde.
(Seit 2,85) |
updateCurrentTab(modifier:Function, onupdate?:Function) |
None |
Aktualisiert die aktuell ausgewählte Registerkarte und führt zu einer
Größenänderung des GInfoWindow-Objekts,
ohne eine Neupositionierung durchzuführen. Mit der Funktion modifier
wird die derzeit ausgewählte Registerkarte geändert. Ihr wird eine GInfoWindowTab
als Argumentübergeben. Die optionale Callback-Funktion onupdate
wird aufgerufen, sobald im Infofenster der neue Inhalt angezeigt wird.
(Seit 2,85) |
closeInfoWindow() |
None |
Schlieäßt das aktuell geöffnete Infofenster. |
getInfoWindow() |
GInfoWindow |
Gibt das Infofensterobjekt dieser Karte zurück. Falls noch kein Infofenster
existiert, wird es erstellt, aber nicht angezeigt. Dieser Vorgang wird
von enableInfoWindow() nicht beeinflusst. |
Koordinaten-Transformationen
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
fromContainerPixelToLatLng(pixel:GPoint) |
GLatLng |
Berechnet die geografischen Koordinaten des Punkts an den angegebenen Pixelkoordinaten im DOM-Element, das die Karte auf der Seite enthält. Dies ist hilfreich, wenn Sie Interaktionen angepasster Bedienelemente mit der Karte implementieren möchten. |
fromLatLngToContainerPixel(latlng:GLatLng) |
GPoint |
Berechnet die Pixelkoordinaten des angegebenen geografischen Punkts
im DOM-Element, das die Karte auf der Seite enthält.
(Seit 2,100) |
fromLatLngToDivPixel(latlng:GLatLng) |
GPoint |
Berechnet die Pixelkoordinaten des angegebenen geografischen Punkts
im DOM-Element, das die verschiebbare Karte enthält. Sie benötigen diese
Methode zum Positionieren eines benutzerdefinierten Overlays, wenn Sie
die GOverlay.redraw()-Methode
für ein benutzerdefiniertes Overlay implementieren. |
fromDivPixelToLatLng(pixel:GPoint) |
GLatLng |
Berechnet die geografischen Koordinaten aus den Pixelkoordinaten im
DIV-Element, das die verschiebbare Karte enthält. Dies ist hilfreich,
wenn Sie Interaktionen mit benutzerdefinierten Overlays implementieren
möchten, die das Interface GOverlay
nicht erweitern. Sollte dies nicht zum erwarteten Ergebnis führen, versuchen
Sie es stattdessen mit der Methode fromContainerPixelToLatLng. |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
addmaptype(type:GMapType) |
Dieses Ereignis wird ausgelöst, wenn ein Kartentyp zur Karte hinzugefügt wird. |
removemaptype(type:GMapType) |
Dieses Ereignis wird ausgelöst, wenn ein Kartentyp von der Karte entfernt wird. |
click(overlay:GOverlay, latlng:GLatLng,
overlaylatlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn der Nutzer mit der Maus auf die
Karte klickt. Ein click-Ereignisübergibt je nach Klickkontext
und je nachdem, ob auf ein anklickbares Overlay geklickt wurde, verschiedene
Argumente. Wurde nicht auf ein anklickbares Overlay geklickt, ist das
Argument overlay null und das Argument latlng
enthält die geografischen Koordinaten des Punkts, auf den geklickt wurde.
Klickt der Nutzer auf ein Overlay, das clickable ist (beispielsweise
des Typs GMarker, GPolygon,
GPolyline oder GInfoWindow),
enthält das Argument overlay das Overlay-Objekt und das
Argument overlaylatlng die Koordinaten des Overlays, auf
das geklickt wurde. Darüber hinaus wird dann auch ein click-Ereignis
für das Overlay selbst ausgelöst. |
dblclick(overlay:GOverlay, latlng:GLatLng)
|
Dieses Ereignis wird ausgelöst, wenn auf die Karte doppelgeklickt
wird. Beachten Sie, dass dieses Ereignis nicht ausgelöst wird, wenn
auf eine Markierung oder ein anderes anklickbares Overlay doppelgeklickt
wurde. Die geografischen Koordinaten des Punkts, auf den doppelgeklickt
wurde, werden mit dem Argument latlngübergeben. Das Argument
overlay ist immer auf null eingestellt.
(Seit 2,83) |
singlerightclick(point:GPoint, src:Element, overlay?:GOverlay)
|
Dieses Ereignis tritt ein, wenn das DOM-Ereignis contextmenu
für den Kartencontainer ausgelöst wird . Wurde mit der rechten Maustaste
auf eine Markierung oder ein anderes anklickbares Overlay geklickt, wird
das Overlay an den Ereignis-Handler im Argument overlayübergeben.
Die Pixelkoordinaten (im DOM-Element mit der Karte) des Punkts, auf den
mit der rechten Maustaste geklickt wurde, und das Quellelement des DOM-Ereignisses
werden mit dem Argument point bzw. src übergeben.
Wenn es sich um einen doppelten Rechtsklick handelt und das Doppelklicken
zum Zoomen aktiviert ist, wird die Karte verkleinert und kein singlerightclick-Ereignis
ausgelöst. Wenn allerdings das Doppelklicken zum Zoomen deaktiviert ist,
werden zwei singlerightclick-Ereignisse ausgelöst.
(Seit 2,84) |
movestart() |
Dieses Ereignis wird ausgelöst, wenn sich die Kartenansicht zundern
beginnt. Dies kann durch Verschieben geschehen, wobei das dragstart-Ereignis
ausgelöst wird, oder durch den Aufruf einer Methode, die die Kartenansicht
ändert. |
move() |
Dieses Ereignis wird ausgelöst, möglicherweise mehrfach, während die Kartenansicht geändert wird. |
moveend() |
Dieses Ereignis wird ausgelöst, wenn das Ändern der Kartenansicht beendet wird. |
zoomend(oldLevel:Number, newLevel:Number) |
Dieses Ereignis wird ausgelöst, wenn die Karte eine neue Zoomstufe erreicht hat. Der Ereignis-Handler erhält die vorherige und die neue Zoomstufe als Argumente. |
maptypechanged() |
Dieses Ereignis wird ausgelöst, wenn ein anderer Kartentyp ausgewählt wird. |
infowindowopen() |
Dieses Ereignis wird ausgelöst, wenn das Infofenster geöffnet wird. |
infowindowbeforeclose() |
Dieses Ereignis wird ausgelöst, bevor das Infofenster geschlossen
wird.
(Seit 2,83) |
infowindowclose() |
Dieses Ereignis wird ausgelöst, wenn das Infofenster geschlossen wird.
Vor diesem Ereignis wird das infowindowbeforeclose-Ereignis
ausgelöst. Wenn ein aktuell geöffnetes Infofenster an einem anderen
Punkt mit einem weiteren Aufruf von openInfoWindow*() neu
geöffnet wird, werden die Ereignisse infowindowbeforeclose,
infowindowcloseund infowindowopen in dieser
Reihenfolge ausgelöst. |
addoverlay(overlay:GOverlay) |
Dieses Ereignis wird ausgelöst, wenn mit der Methode addOverlay()
ein einzelnes Overlay zur Karte hinzugefügt wird. Das neue Overlay wird
mit dem overlay-Argument an den Ereignis-Handlerübergeben. |
removeoverlay(overlay:GOverlay) |
Dieses Ereignis wird ausgelöst, wenn mit der Methode removeOverlay()
ein einzelnes Overlay entfernt wird. Das entfernte Overlay wird als
Argument overlay an den Ereignis-Handlerübergeben. |
clearoverlays() |
Dieses Ereignis wird ausgelöst, wenn alle Overlays durch die Methode
clearOverlays() gleichzeitig entfernt werden. |
mouseover(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn der Nutzer die Maus von außerhalb der Karteüber die Karte bewegt. |
mouseout(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn der Nutzer die Maus von der Karte weg bewegt. |
mousemove(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn der Nutzer die Maus in der Karte bewegt. |
dragstart() |
Dieses Ereignis wird ausgelöst, wenn der Nutzer beginnt, die Karte zu verschieben. |
drag() |
Dieses Ereignis wird wiederholt ausgelöst, während der Nutzer die Karte verschiebt. |
dragend() |
Dieses Ereignis wird ausgelöst, wenn der Nutzer das Verschieben der Karte beendet. |
load() |
Dieses Ereignis wird ausgelöst, wenn das Einrichten der Karte abgeschlossen
ist und für isLoaded() true zurückgeben würde. Dies bedeutet,
dass Position, Zoomen und Kartentyp initialisiert sind, aber möglicherweise
immer noch Kachelbilder geladen werden.
(Seit 2,52) |
Klasse "GMapOptions"
Diese Klasse liefert dem GMap2-Konstruktor
optionale Argumente. Sie hat keinen Konstruktor, wird aber als Objektliteral
instanziiert.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
size |
GSize |
Legt die Größe der Karte in Pixel fest. Der Container, der dem Kartenkonstruktorübergeben wird, wird auf die angegebene Größe angepasst. Standardmäßigübernimmt die Karte die Größe ihres Containers. |
mapTypes |
GMapType[] |
Array aus Kartentypen, die von dieser Karte verwendet werden. Standardmäßig
wird G_DEFAULT_MAP_TYPES verwendet. Sie können diese Option
verwenden, um die vordefinierten Kartentypen zu beschränken, die für
die Karte angezeigt werden, oder um der Karte eigene Kartentypen zuübergeben. Siehe auch GMap2.addMapType(). |
draggableCursor |
String |
Der anzuzeigende Cursor, wenn die Karte verschiebbar ist.
(Seit 2,59) |
draggingCursor |
String |
Der anzuzeigende Cursor, wenn die Karte verschoben wird.
(Seit 2,59) |
googleBarOptions |
GGoogleBarOptions |
Diese Eigenschaft gibt die Optionen zum Konfigurieren des GGoogleBar-Suchbedienelements
an. Diese Optionen werden an das GMapOptions-Objektliteralübergeben, wenn die Karte konstruiert wird. Mit ihnen wird das lokale
GGoogleBar-Bedienelement konstruiert, wenn GMap2.enableGoogleBar()
aufgerufen wird.
(Seit 2,95) |
backgroundColor |
String |
Mit dieser Eigenschaft wird die Hintergrundfarbe für die Kartenkacheln
festgelegt. Bei der Farbe kann es sich um jeden gültigen W3C-Standardfarbwert
handeln.
(Seit 2,119) |
Klasse "GGoogleBarOptions"
Diese Klasse stellt Optionen bereit, die im googleBarOptions-Parameter
an das GMapOptions-Objektübergeben
werden. Sie hat keinen Konstruktor, wird aber als Objektliteral instanziiert.
Wie das GInfoWindow wird das GGoogleBar-Objekt
nicht konstruiert, sondern automatisch an das Kartenobjekt angehängt undüber
die hier beschriebenen Eigenschaften aktiviert.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
showOnLoad |
Boolean |
Wenn auf "true" gesetzt, zeigt diese Eigenschaft das Suchfeld in GoogleBar
an (vorausgesetzt, dass das Bedienelement aktiviert und die Karte geladen
ist). Standardmäßig ist das Suchfeld im Bedienelement verborgen und
wird nur dann angezeigt, wenn auf das Vergrößerungsglas des Bedienelements
geklickt wird.
(Seit 2,95) |
linkTarget |
GGoogleBarLinkTarget |
Mit dieser Eigenschaft können Sie die Ziele von Links angeben, die
in den Suchergebnissen von GoogleBar eingebettet sind.
Der Standardwert G_GOOGLEBAR_LINK_TARGET_BLANK gibt an,
dass Links in einem neuen Fenster geöffnet werden.
(Seit 2,95) |
resultList |
GGoogleBarResultList or Element |
Mit dieser Eigenschaft können Sie den Stil für die Suchergebnisliste
von GoogleBar angeben. Sie haben die Wahl zwischen folgenden
Stilen: G_GOOGLEBAR_RESULT_LIST_INLINE (Standard) platziert
die Ergebnisliste in einer Tabelle oberhalb des Suchfeldes, G_GOOGLEBAR_RESULT_LIST_SUPPRESS
ersetzt die Liste durch die Schaltflächen "Weiter"/intl/de/"Vorherige".
Wird ein DOM-Element der Block-Ebeneübergeben, wird die
Liste in einem Container Ihrer Wahl platziert (normalerweise ein <div>-Element).
(Seit 2,95) |
suppressInitialResultSelection |
Boolean |
Diese Eigenschaft unterdrückt nach Beendigung einer Suche in GoogleBar
die Anzeige des anfänglichen Resultats im eigenen Infofenster (dies ist
das Standardverhalten).
(Seit 2,95) |
suppressZoomToBounds |
Boolean |
Diese Eigenschaft unterdrückt nach Beendigung einer Suche in GoogleBar
das automatische Schwenken und Zoomen der Ergebnisse. (Diese Eigenschaft
unterdrückt das Standardverhalten.)
(Seit 2,95) |
onIdleCallback |
Function |
Diese Eigenschaft gibt eine Callback-Funktion an, die aufgerufen werden
soll, wenn GoogleBar die Suche abgeschlossen hat und die
Suchergebnisse geschlossen werden.
(Seit 2,95) |
onSearchCompleteCallback |
Function |
Diese Eigenschaft gibt eine Callback-Funktion an, die aufgerufen werden
soll, wenn GoogleBar die Suche abgeschlossen hat und die
Suche beendet ist. An sie wird das GlocalSearch-Objektübergeben, das mit dem Suchbedienelement verknüpft ist. Diese Callback-Funktion
wird aufgerufen, bevor die Ergebnisse auf der Karte oder in der Ergebnisliste
abgelegt werden.
(Seit 2,95) |
onGenerateMarkerHtmlCallback |
Function |
Mit dieser Eigenschaft können Sie eine Callback-Funktion angeben,
die aufgerufen werden soll, wenn das Infofenster für eine Suchergebnismarkierung
geöffnet ist. Der Funktion sollte ein GMarker,
ein generierter HTML-String und ein GlocalSearchResult-Objektübergeben werden (in dieser Reihenfolge). Sie muss den geänderten HTML-String,
der im Infofenster angezeigt werden soll, zurückgeben.
(Seit 2,95) |
onMarkersSetCallback |
Function |
Mit dieser Eigenschaft können Sie eine Callback-Funktion angeben,
die aufgerufen werden soll, wenn GGoogleBar das Erstellen
von Markierungen abgeschlossen hat und diese auf der Karte platziert.
Dieser Funktion muss ein Array von Objekten der Form {result:
GlocalSearch, marker: GMarker}übergeben werden.
(Seit 2,95) |
Klasse "GInfoWindow"
GInfoWindow hat keinen Konstruktor.
Sie wird von der Karte erstellt und kann von deren Methode GMap2.getInfoWindow()
aufgerufen werden.
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
selectTab(index:Number) |
None |
Wählt die Registerkarte mit dem angegebenen Index aus. Dies hat denselben Effekt wie das Klicken auf die entsprechende Registerkarte. |
hide() |
None |
Macht das Infofenster unsichtbar. HINWEIS: Das Infofenster wird dadurch
nicht geschlossen. Es kann mit show() wieder sichtbar gemacht
werden. |
show() |
None |
Macht das Infofenster sichtbar, wenn es zurzeit unsichtbar ist. |
isHidden() |
Boolean |
Gibt true zurück, wenn das Infofenster zurzeit verborgen
ist. Dies beinhaltet den Status, dass es geschlossen ist. |
reset(latlng:GLatLng, tabs:GInfoWindowTab[],
size:GSize, offset?:GSize,
selectedTab?:Number) |
None |
Setzt den Status des Infofensters zurück. Jedes Argument kann null
sein; der Wert unterscheidet sich dann nicht vom aktuellen Wert. |
getPoint() |
GLatLng |
Gibt den geografischen Punkt zurück, an dem das Infofenster verankert ist. Die Spitze des Fensters zeigt auf diesen Punkt auf der Karte und befindet sich nach einer Modulo-Berechnung im entsprechenden Abstand von dem Punkt in Pixel. |
getPixelOffset() |
GSize |
Gibt den Abstand in Pixel zwischen der Spitze des Infofensters und dem Punkt auf der Karte an, an dessen geografischen Koordinaten das Infofenster verankert ist. |
getSelectedTab() |
Number |
Gibt den Index, beginnend bei 0, der aktuell ausgewählten Registerkarte zurück. |
getTabs() |
GInfoWindowTabs[] |
Gibt ein Array von Registerkarten für dieses Infofenster zurück.
(Seit 2,59) |
getContentContainers() |
Node[] |
Gibt ein Array von DOM-Knoten zurück, die den Inhalt der Registerkarten
dieses Infofensters enthalten.
(Seit 2,59) |
enableMaximize() |
None |
Aktiviert die Maximierung des Infofensters. Ein maximierbares Infofenster
kann erweitert werden, um den größten Teil der Karte mit Inhalt zu füllen,
derüber die Eigenschaften maxContent und maxTitlevon
GInfoWindowOptions angegeben
wird. Das Infofenster muss mit den Optionen maxContent
oder maxTitle geöffnet worden sein, damit enableMaximize()
oder disableMaximize wirksam verwendet werden können. Für
ein Infofenster, das mit maxContent oder maxTitle
geöffnet wird, ist die Maximierung standardmäßig aktiviert.
(Seit 2,93) |
disableMaximize() |
None |
Deaktiviert die Maximierung des Infofensters. Das Infofenster muss mit
den Optionen maxContent oder maxTitle geöffnet
worden sein. Wenn das Infofenster geöffnet ist, entfernt diese Funktion
die Maximierungsschaltfläche, stellt aber das Fenster nicht im minimierten
Zustand wieder her.
(Seit 2,93) |
maximize() |
None |
Maximiert das Infofenster. Das Infofenster muss mit den Optionen maxContent
oder maxTitle geöffnet und die Maximierung darf nicht durch
disableMaximize deaktiviert worden sein.
(Seit 2,93) |
restore() |
None |
Stellt den Standardzustand des Infofensters wieder her (nicht maximiert).
Das Infofenster muss mit den Optionen maxContent oder maxTitle
geöffnet worden sein.
(Seit 2,93) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
closeclick() |
Dieses Ereignis wird ausgelöst, wenn auf das Schließfeld des Infofensters geklickt wird. |
maximizeclick() |
Signalisiert, dass das Infofenster gleich maximiert wird.
(Seit 2,93) |
maximizeend() |
Signalisiert, dass die Maximierung des Infofensters abgeschlossen
ist.
(Seit 2,93) |
restoreclick() |
Signalisiert, dass das Infofenster gleich auf den nicht maximierten
Zustand zurückgesetzt wird.
(Seit 2,93) |
restoreend() |
Signalisiert, dass das Zurücksetzen des Infofensters auf den nicht
maximierten Zustand abgeschlossen ist.
(Seit 2,93) |
Klasse "GInfoWindowTab"
Ein Array von Instanzen dieser Klasse kann als tabs-Argument
an die Methoden GMap2.openInfoWindowTabs(),
GMap2.openInfoWindowTabsHtml(),
GMarker.openInfoWindowTabs(),
GMarker.openInfoWindowTabsHtml()
und die GMarker.bindInfoWindow*()-Variantenübergeben werden. Wenn das Array mehr als ein Element enthält, wird das Infofenster
mit Registerkarten angezeigt. Jedes InfoWindowTab-Objekt enthält
zwei Elemente: content definiert den Content des Informationsfensters,
wenn die Registerkarte ausgeWählt ist, und label definiert das
Label der Registerkarte. Die Eigenschaften werden als Argumente an den Konstruktorübergeben. Für die openInfoWindowTabs()-Methoden ist content
ein DOM-Knoten. Für die openInfoWindowTabsHtml()-Methoden ist
content ein String, der HTML-Text enthält.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GInfoWindowTab(label:String, content:Node or String) |
Erstellt eine Datenstruktur für Infofensterregisterkarten, die im
Argument tabs an openInfoWindowTabs*()-Methodenübergeben werden kann. |
Klasse "GInfoWindowOptions"
Instanzen dieser Klasse werden im Argument opts? für die Methoden
openInfoWindow(), openInfoWindowHtml(), openInfoWindowTabs(),
openInfoWindowTabsHtml(), die bindInfoWindow*()-Varianten
und showMapBlowup() der Klassen GMap2
und GMarker verwendet. Für diese Klasse
gibt es keinen Konstruktor. Stattdessen wird diese Klasse als Javascript-Objektliteral
instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
selectedTab |
Number |
Wählt die Registerkarte mit dem angegebenen Index, beginnend bei 0, anstelle der ersten Registerkarte (mit dem Index 0) aus. |
maxWidth |
Number |
Maximale Breite des Inhalts des Infofensters in Pixel. |
noCloseOnClick |
Boolean |
Gibt an, ob das Infofenster bei einem Klick auf die Karte (wobei nicht
auf eine Markierung geklickt wird) geschlossen werden soll. Bei der
Einstellung true wird das Infofenster nicht geschlossen,
wenn auf die Karte geklickt wird. Der Standardwert ist false.
(Seit 2,83) |
onOpenFn |
Function |
Die Funktion wird aufgerufen, nachdem das Infofenster geöffnet wurde und der Inhalt angezeigt wird. |
onCloseFn |
Function |
Die Funktion wird aufgerufen, wenn das Infofenster geschlossen wird. |
zoomLevel |
Number |
Nur für showMapBlowup() geeignet. Die Zoomstufe
der Blowup-Karte im Infofenster. |
mapType |
GMapType |
Nur für showMapBlowup() geeignet. Der Kartentyp
der Blowup-Karte im Infofenster. |
maxContent |
String |
Gibt den Inhalt an, der angezeigt wird, wenn das Infofenster maximiert
wird. Der Inhalt kann entweder ein HTML-String oder ein HTML-DOM-Element
sein.
(Seit 2,93) |
maxTitle |
String |
Gibt den Titel an, der angezeigt wird, wenn das Infofenster maximiert
wird. Der Inhalt kann entweder ein HTML-String oder ein HTML-DOM-Element
sein.
(Seit 2,93) |
pixelOffset |
GSize |
Gibt die Anzahl der Pixel in der Richtung nach oben (x) und rechts
(y), die das Infofenster von der angegebenen GLatLng
wegverschoben werden soll.
(Seit 2,98) |
Klasse "GMarker"
Ein GMarker-Objekt markiert eine Position
auf der Karte. Die Klasse implementiert das Interface GOverlay
und wird auf diese Weise mithilfe der GMap2.addOverlay()-Methode
zur Karte hinzugefügt.
Ein Markierungsobjekt weist latlng auf, was der geografischen
Position, an der die Markierung auf der Karte verankert ist, entspricht, sowie
ein icon. Wenn das icon nicht im Konstruktor angegeben
wurde, wird das Standardsymbol G_DEFAULT_ICON verwendet.
Nachdem ein Infofenster zu einer Karte hinzugefügt wurde, kann es anhand der Markierung geöffnet werden. Das Markierungsobjekt löst Maus- und Infofensterereignisse aus.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMarker(latlng:GLatLng, icon?:GIcon,
inert?:Boolean) |
Erstellt eine Markierung amübergebenen latlng von GPoint
oder GLatLng mit einem icon
oder mit G_DEFAULT_ICON. Ist das Flag inert
auf true gesetzt, ist die Markierung nicht anklickbar und
sie löst keine Ereignisse aus.
(Seit 2.50 auslaufend) |
GMarker(latlng:GLatLng, opts?:GMarkerOptions)
|
Erstellt eine Markierung bei latlng mit den in GMarkerOptions
angegebenen Optionen. Standardmäßig sind Markierungen anklickbar und
haben das Standardsymbol G_DEFAULT_ICON.
(Seit 2,50) |
Methoden
Bevor diese Methoden aufgerufen werden können, muss die Markierung einer Karte hinzugefügt werden.
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
openInfoWindow(content:Node, opts?:GInfoWindowOptions)
|
None |
Öffnet das Karteninfofensterüber dem Symbol der Markierung. Der Inhalt
des Infofensters wird als DOM-Knoten angegeben. Nur die Option
GInfoWindowOptions.maxWidth
kann verwendet werden. |
openInfoWindowHtml(content:String, opts?:GInfoWindowOptions)
|
None |
Öffnet das Karteninfofensterüber dem Symbol der Markierung. Der Inhalt
des Infofensters ist ein String, der HTML-Text enthält. Nur die
Option GInfoWindowOptions.maxWidth
kann verwendet werden. |
openInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions) |
None |
Öffnet über dem Symbol der Markierung das Karten-Infofenster mit Registerkarten.
Der Inhalt des Infofensters ist ein Array mit Registerkarten, die den
Registerkarteninhalt als DOM-Knoten enthalten. Nur die Optionen
GInfoWindowOptions.maxWidth
und InfoWindowOptions.selectedTab können verwendet werden. |
openInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions) |
None |
Äffnet über dem Symbol der Markierung das Karten-Infofenster mit Registerkarten.
Der Inhalt des Infofensters ist ein Array mit Registerkarten, die den
Registerkarteninhalt als Strings mit HTML-Text enthalten. Nur die
Optionen InfoWindowOptions.maxWidth und InfoWindowOptions.selectedTab
können verwendet werden. |
bindInfoWindow(content:Node, opts?:GInfoWindowOptions)
|
None |
Bindet den angegebenen DOM-Knoten an diese Markierung. Der
Inhalt in diesem Knoten wird automatisch im Infofenster angezeigt, wenn
auf die Markierung geklickt wird. Übergeben Sie content
als null, um die Bindung aufzuheben.
(Seit 2,85) |
bindInfoWindowHtml(content:String, opts?:GInfoWindowOptions)
|
None |
Bindet den angegebenen HTML-Text an diese Markierung. Der HTML-Text
wird automatisch im Infofenster angezeigt, wenn auf die Markierung geklickt
wird. Übergeben Sie content als null, um die
Bindung aufzuheben.
(Seit 2,85) |
bindInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions) |
None |
Bindet die angegebenen GInfoWindowTabs
(als DOM-Knoten bereitgestellt) an diese Markierung. Der Inhalt in den
Knoten dieser Registerkarten wird automatisch im Infofenster angezeigt,
wenn auf die Markierung geklickt wird. Übergeben Sie tabs
als null, um die Bindung aufzuheben.
(Seit 2,85) |
bindInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions) |
None |
Bindet die angegebenen GInfoWindowTabs
(als HTML-Strings bereitgestellt) an diese Markierung. Der HTML-Inhalt
in diesen Registerkarten wird automatisch im Infofenster angezeigt,
wenn auf die Markierung geklickt wird. Übergeben Sie tabs
als null, um die Bindung aufzuheben.
(Seit 2,85) |
closeInfoWindow() |
None |
Schlieäßt das Infofenster nur dann, wenn es zu dieser Markierung gehört.
(Seit 2,85) |
showMapBlowup(opts?:GInfoWindowOptions)
|
None |
Öffnet das Karteninfofensterüber dem Symbol der Markierung. Der Inhalt
des Infofensters ist eine Closeup-Karte um die Markierungsposition herum.
Nur die Optionen InfoWindowOptions.zoomLevel und InfoWindowOptions.mapType
können verwendet werden. |
getIcon() |
GIcon |
Gibt das icon dieser Markierung gemäß der Einstellung
des Konstruktors zurück. |
getTitle() |
String |
Gibt den Titel dieser Markierung zurück, wie er vom Konstruktor anhand
der GMarkerOptions.title-Eigenschaft
festgelegt wurde. Gibt einen undefinierten Wert zurück, wenn kein Titelübergeben wird.
(Seit 2,85) |
getPoint() |
GLatLng |
Gibt die geografischen Koordinaten zurück, an denen diese Markierung
verankert ist, wie dies vom Konstruktor oder von setPoint()
festgelegt wurde.
(Seit 2.88 auslaufend) |
getLatLng() |
GLatLng |
Gibt die geografischen Koordinaten zurück, an denen diese Markierung
verankert ist, wie dies vom Konstruktor oder von setLatLng()
festgelegt wurde.
(Seit 2,88) |
setPoint(latlng:GLatLng) |
None |
Legt die geografischen Koordinaten des Punkts fest, an dem diese Markierung
verankert ist.
(Seit 2.88 auslaufend) |
setLatLng(latlng:GLatLng) |
None |
Legt die geografischen Koordinaten des Punkts fest, an dem diese Markierung
verankert ist.
(Seit 2,88) |
enableDragging() |
None |
Aktiviert das Ziehen und Ablegen der Markierung innerhalb der Karte.
Damit dies funktioniert, muss die Markierung mit GMarkerOptions.draggable
= true initialisiert worden sein. |
disableDragging() |
None |
Deaktiviert das Ziehen und Ablegen der Markierung um die Karte herum. |
draggable() |
Boolean |
Gibt true zurück, wenn die Markierung mithilfe von GMarkerOptions.draggable
= trueüber den Konstruktor initialisiert wurde. Anderenfalls
wird false zurückgegeben. |
draggingEnabled() |
Boolean |
Gibt true zurück, wenn die Markierung für das Verschieben
auf der Karte durch den Nutzer aktiviert ist. |
setImage(url:String) |
None |
Fordert das Bild an, das in der url angegeben ist und
als Vordergrundbild für diese Markierung festgelegt werden soll. Beachten
Sie, dass weder das Druckbild noch das Schattenbild angepasst werden.
Deshalb sollte diese Methode primär zum Implementieren von Hervorhebungs-
oder Abdunkelungseffekten verwendet werden und nicht für größere Änderungen
an der Darstellung von Markierungen.
(Seit 2,75) |
hide() |
None |
Verbirgt die Markierung, wenn sie zurzeit sichtbar ist. Beachten Sie,
dass diese Funktion das Ereignis GMarker.visibilitychanged
auslöst, wenn die Markierung zurzeit sichtbar ist.
(Seit 2,77) |
show() |
None |
Zeigt die Markierung an, wenn sie zurzeit verborgen ist. Beachten
Sie, dass diese Funktion das Ereignis GMarker.visibilitychanged
auslöst, wenn die Markierung zurzeit verborgen ist.
(Seit 2,77) |
isHidden() |
Boolean |
Gibt true zurück, wenn die Markierung zurzeit verborgen
ist. Anderenfalls wird false zurückgegeben.
(Seit 2,77) |
Ereignisse
All diese Ereignisse werden nur ausgelöst, wenn die Markierung nicht inaktiv ist (siehe Konstruktor).
| Ereignis | Beschreibung |
|---|---|
click(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn auf das Markierungssymbol geklickt
wird. Dabei wird die aktuelle Koordinate der Markierung innerhalb ihres
Arguments latlngübergeben. Beachten Sie, dass dieses Ereignis
auch für die Karte ausgelöst wird, wobei die Markierung als erstes Argument
an den Ereignis-Handlerübergeben wird. |
dblclick(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn auf das Markierungssymbol doppelgeklickt
wird. Dabei wird die aktuelle Koordinate der Markierung innerhalb ihres
Arguments latlngübergeben. Beachten Sie, dass dieses Ereignis
nicht für die Karte ausgelöst wird, da die Karte einen Doppelklick
als fest verbundenes Verhalten interpretiert. |
mousedown(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn das DOM-Ereignis "mousedown"
für das Markierungssymbol ausgelöst wird, wobei die aktuelle Koordinate
der Markierung innerhalb ihres Arguments latlngübergeben
wird. Beachten Sie, dass die Markierung das DOM-Ereignis "mousedown"
beendet, um ein Verschieben der Karte zu verhindern. |
mouseup(latlng:GLatLng) |
Dieses Ereignis wird für das DOM-Ereignis "mouseup" für das Markierungssymbol
ausgelöst, wobei die aktuelle Koordinate der Markierung innerhalb ihres
Arguments latlngübergeben wird. Die Markierung beendet
das DOM-Ereignis "mousedown" nicht, da der Handler zum Verschieben
auf der Karte nicht verwechselt wird. |
mouseover(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich des Markierungssymbols
gelangt, wobei die aktuelle Koordinate der Markierung innerhalb ihres
Arguments latlngübergeben wird. |
mouseout(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn die Maus den Bereich des Markierungssymbols
verlässt, wobei die aktuelle Koordinate der Markierung innerhalb ihres
Arguments latlngübergeben wird. |
infowindowopen() |
Dieses Ereignis wird ausgelöst, wenn das Infofenster der Karteüber diese Markierung geöffnet wurde. |
infowindowbeforeclose() |
Dieses Ereignis wird ausgelöst, bevor das Infofenster der Karte, dieüber diese Markierung geöffnet wurde, geschlossen wird.
(Seit 2,83) |
infowindowclose() |
Dieses Ereignis wird ausgelöst, wenn das Infofenster der Karte, dieüber diese Markierung geöffnet wurde, geschlossen wird. Dies geschieht,
wenn das Infofenster entweder geschlossen oder bei einer anderen
Markierung oder auf der Karte geöffnet wurde. Vor diesem Ereignis wird
das infowindowbeforeclose-Ereignis ausgelöst. |
remove() |
Dieses Ereignis wird ausgelöst, wenn die Markierung mithilfe von GMap2.removeOverlay()
oder GMap2.clearOverlays()
von der Karte entfernt wird. |
dragstart(latlng:GLatLng) |
Ist für die Markierung das Verschieben aktiviert, wird dieses Ereignis
ausgelöst, wenn mit dem Verschieben der Markierung begonnen wird, wobei
die aktuelle Koordinate der Markierung innerhalb ihres Arguments latlngübergeben wird. |
drag(latlng:GLatLng) |
Ist für die Markierung das Verschieben aktiviert, wird dieses Ereignis
während des Verschiebens der Markierung ausgelöst, wobei die aktuelle
Koordinate der Markierung innerhalb ihres Arguments latlngübergeben wird. |
dragend(latlng:GLatLng) |
Ist für die Markierung das Verschieben aktiviert, wird dieses Ereignis
ausgelöst, wenn das Verschieben der Markierung abgeschlossen ist, wobei
die aktuelle Koordinate der Markierung innerhalb ihres Arguments latlngübergeben wird. |
visibilitychanged(isVisible:Boolean) |
Dieses Ereignis wird ausgelöst, wenn die Sichtbarkeit der Markierung
geändert wird (beispielsweise wenn sie ein- oder ausgeblendet wird). isVisible
verweist auf den Status der Markierung nachdem die Sichtbarkeit geändert
wurde.
(Seit 2,77) |
Klasse "GMarkerOptions"
Instanzen dieser Klasse werden im Argument opts? für den Konstruktor
der Klasse GMarker verwendet. Für diese
Klasse gibt es keinen Konstruktor. Stattdessen wird diese Klasse als Javascript-Objektliteral
instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
icon |
GIcon |
Wählt das Symbol für diese Klasse. Falls nicht angegeben, wird G_DEFAULT_ICON
verwendet.
(Seit 2,50) |
dragCrossMove |
Boolean |
Normalerweise befindet sich beim Verschieben die Markierung oberhalb
und weiter weg vom Cursor. Wenn Sie diesen Wert auf true
setzen, verbleibt die Markierung unter dem Cursor und das Kreuz wird
stattdessen nach unten verschoben. Der Standardwert für diese Option
ist false.
(Seit 2,63) |
title |
String |
Dieser String wird als Tooltipp der Markierung angezeigt, d. h., er
ähnelt dem title-Attribut bei HTML-Elementen.
(Seit 2,50) |
clickable |
Boolean |
Gibt an, ob die Markierung anklickbar ist. Markierungen, die nicht
anklickbar sind oder nicht verschoben werden können, sind inaktiv, verbrauchen
weniger Ressourcen und reagieren nicht auf Ereignisse. Der Standardwert
für diese Option ist true, d. h., wenn die Option nicht
angegeben wird, ist die Markierung anklickbar.
(Seit 2,50) |
draggable |
Boolean |
Gibt an, ob die Markierung von Nutzern verschoben werden kann. Markierungen,
die für das Verschieben eingerichtet sind, benötigen mehr Ressourcen
als Markierungen, die anklickbar sind. Verschiebbare Markierungen sind
auch anklickbar, hüpfen und das automatische Schwenken ist standardmäßig
aktiviert. Der Standardwert für diese Option ist false.
(Seit 2,61) |
bouncy |
Boolean |
Gibt an, ob die Markierung nach dem Verschieben nach oben und unten
hüpft. Der Standardwert für diese Option ist false.
(Seit 2,61) |
bounceGravity |
Number |
Diese Zahl definiert beim Beenden des Verschiebevorgangs die Beschleunigungsrate
der Markierung beim "Herunterhüpfen" auf die Erde. Der Standardwert
für diese Option ist 1.
(Seit 2,61) |
autoPan |
Boolean |
Automatisches Schwenken der Karte, wenn Sie die Markierung nahe an
den Rand ziehen. Wenn die Markierung verschoben werden kann, ist der
Standardwert für diese Option true.
(Seit 2,87) |
zIndexProcess |
Function |
Diese Funktion wird zum Ändern der Z-Index-Reihenfolge der Markierungen
verwendet, wenn sie sich auf der Karteüberlagern. Sie wird auch aufgerufen,
wenn deren Infofenster geöffnet wird. Standardmäßig werden die südlicher
gelegenen Markierungen höher platziert als die nördlicher gelegenen. Diese
Funktion wird an das GMarker-Objektübergeben
und gibt eine Zahl zurück, die den neuen Z-Index angibt.
(Seit 2,98) |
hide |
Boolean |
Bei der Einstellung "true" gibt dies an, dass die GMarkeranfänglich
auf der Karte nicht angezeigt werden soll. Rufen Sie GMarker.show()
auf, um das Overlay zu aktivieren. Standardmäßig ist für diesen Wert
"false" eingestellt.
(Seit 2,139) |
Klasse "GPolyline"
Dies ist ein Karten-Overlay, das eine Polylinie auf der Karte einzeichnet. Dazu werden die Browserfunktionen für das Vektorzeichnen verwendet, falls verfügbar, oder anderenfalls ein Bild-Overlay von Google-Servern.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GPolyline(latlngs:GLatLng[], color?:String, weight?:Number,
opacity?:Number, opts?:GPolylineOptions)
|
Erstellt eine Polylinie aus einem Array von Scheitelpunkten. Die color
wird als Stringübergeben, der die Farbe in hexadezimalem HTML-Stil
angibt, z. B. #RRGGBB. Das weight ist die Breite der
Linie in Pixel. Die opacity wird als Zahl zwischen 0 und
1 angegeben. Die Linie ist halbdurchsichtig und Antialiasing ist aktiviert. |
Factory-Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
GPolyline.fromEncoded(color?:String, weight?:Number, opacity?:Number,
latlngs:String, zoomFactor:Number, levels:String, numLevels:Number)
|
GPolyline |
Erstellt eine Polylinie aus verschlüsselten Strings mit aggregierten
Koordinaten und Stufen. color ist ein String mit hexadezimalem
numerischen HTML-Code, beispielsweise #RRGGBB. weight ist
die Breite der Linie in Pixel. opacity ist eine Zahl zwischen
0 und 1. latlngs ist ein String mit den verschlüsselten Koordinaten
für Breite und Länge. levels ist ein String mit den verschlüsselten
Zoomstufengruppen für Polylinien. numLevels ist die Anzahl
der im verschlüsselten levels-String enthaltenen Zoomstufen.
zoomFactor ist die Vergrößerung zwischen aufeinander folgenden
Zoomstufen im verschlüsselten levels-String. Zusammen bestimmen
diese beiden Werte die Genauigkeit der levels innerhalb einer
verschlüsselten Polylinie. Die Linie ist halbdurchsichtig und Antialiasing
ist aktiviert.
(Seit 2,63) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
deleteVertex(index:Number) |
None |
Entfernt den Scheitelpunkt mit dem angegebenen Index aus der Polylinie
und aktualisiert die Form der Polylinie entsprechend. Das GPolyline
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
disableEditing() |
None |
Kehrt den Effekt von enableEditing um, wodurch alle Kontrollpunkte
von der Linie entfernt werden und sie nicht mehr vom Nutzer bearbeitet
werden kann.
(Seit 2,111) |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Ermöglicht dem Benutzer die Konstruktion (oder Änderung) eines GPolyline-Objekts
durch Klicken auf zusätzliche Punkte auf der Karte. Die GPolyline
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzugefügt worden sein, auch wenn die Polylinie anfänglich nicht ausgefüllt
ist und keine Scheitelpunkte enthält. Mit jedem Klick wird der Polylinien-Kette
ein weiterer Scheitelpunkt hinzugefügt und das Zeichnen kann per
Doppelklick oder durch erneutes Klicken auf den zuletzt hinzugefügten
Punkt beendet werden. An dieser Stelle wird das Ereignis "endline" ausgelöst,
sofern die Polylinie erfolgreich fertiggestellt wurde. Anderenfalls wird
das Ereignis "cancelline" ausgelöst, die Polylinie wird jedoch nicht von
der Karte entfernt. Wird eine vorhandene GPolyline
geändert, werden die Scheitelpunkte entwederüber die Start- oder Endpunkte
der vorhandenen Polylinie verbunden, was im optionalen Parameter GPolyEditingOptions.fromStart
festgelegt ist.
(Seit 2,111) |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Ermöglicht die Änderung einer vorhandenen GPolyline-Kette
von Punkten. Ist dies aktiviert, können Nutzer vorhandene Scheitelpunkte
auswählen und verschieben. Sofern durch maxVertices in GPolyEditingOptions
kein Limit für Scheitelpunkte festgelegt ist, das geringer ist als die
aktuelle Anzahl der Scheitelpunkte, werden an den Mittelpunkten der Polylinienabschnitte
auch "Geisterpunkte" hinzugefügt, mit deren Hilfe Nutzer neue Scheitelpunkte
interpolieren können, indem sie auf diese zusätzlichen Scheitelpunkte
klicken und sie verschieben. Das Ereignis "lineupdated" wird jedes Mal,
wenn ein Scheitelpunkt hinzugefügt oder verschoben wird, ausgelöst.
(Seit 2,111) |
getVertexCount() |
Number |
Gibt die Anzahl der Scheitelpunkte der Polylinie zurück.
(Seit 2,46) |
getVertex(index:Number) |
GLatLng |
Gibt den Scheitelpunkt mit dem angegebenen Index in der Polylinie
zurück.
(Seit 2,46) |
getLength() |
Number |
Gibt die Länge (in Metern) der Polylinie entlang der Oberfläche der
sphärischen Erde zurück.
(Seit 2,85) |
getBounds() |
GLatLngBounds |
Gibt die Grenzen der Polylinie zurück.
(Seit 2,85) |
hide() |
None |
Verbirgt die Polylinie, wenn sie zurzeit sichtbar ist, und GPolyline.supportsHide()
gibt true zurück. Beachten Sie, dass diese Funktion das
Ereignis GPolyline.visibilitychanged
auslöst, falls die Polylinie zurzeit sichtbar ist.
(Seit 2,87) |
insertVertex(index:Number, latlng:GLatLng) |
None |
Fügt beim angegebenen Index in der Polylinie einen neuen Punkt hinzu
und aktualisiert ihre Form. Das GPolyline
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
isHidden() |
Boolean |
Gibt true zurück, falls die Polylinie zurzeit verborgen
ist. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
show() |
None |
Zeigt die Polylinie an, wenn sie zurzeit verborgen ist. Beachten Sie,
dass diese Funktion das Ereignis GPolyline.visibilitychanged
auslöst, falls die Polylinie zurzeit verborgen ist.
(Seit 2,87) |
supportsHide() |
Boolean |
Gibt true zurück, wenn GPolyline.hide()
in der aktuellen Umgebung für GPolyline-Objekte
unterstützt wird. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Ändert den Stil der Polylinie. Das GPolyline
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
remove() |
Dieses Ereignis wird ausgelöst, wenn die Polylinie mithilfe von GMap2.removeOverlay()
oder GMap2.clearOverlays()
von der Karte entfernt wird. |
visibilitychanged(isVisible:Boolean) |
Dieses Ereignis wird ausgelöst, wenn der Sichtbarkeitsstatus der Polylinie
von "sichtbar" zu "verborgen" oder umgekehrt wechselt. Das Argument
isVisible gibt den Status der Polylinie nach Abschluss
dieses Sichtbarkeitsstatus wieder.
(Seit 2,87) |
click(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn auf die Polylinie geklickt wird.
Dabei wird die angeklickte Koordinate der Linie innerhalb ihres Arguments
latlngübergeben. Dieses Ergebnis löst anschließend außerdem
ein Klickereignis auf der Karte aus, wobei die Polylinie als overlay-Argument
innerhalb dieses Ereignissesübergeben wird.
(Seit 2,88) |
mouseover() |
Dieses Ereignis wird ausgelöst, wenn die Mausüber die Polylinie bewegt
wird.
(Seit 2,111) |
mouseout() |
Dieses Ereignis wird ausgelöst, wenn die Maus von der Polylinie weg
bewegt wird.
(Seit 2,111) |
lineupdated() |
Dieses Ereignis wird ausgelöst, wenn der Stil oder die Form der Polylinie
aktualisiert wird.
(Seit 2,111) |
endline() |
Dieses Ereignis wird ausgelöst, wenn die Linienzeichnung (durch einen
Aufruf von GPolyline.enableDrawing
initiiert) vom Nutzer abgeschlossen wird.
(Seit 2,111) |
cancelline() |
Dieses Ereignis wird ausgelöst, wenn die Linienzeichnung (durch einen
Aufruf von GPolyline.enableDrawing
initiiert) vom Nutzer abgebrochen wird.
(Seit 2,111) |
Klasse "GPolylineOptions"
Instanzen dieser Klasse werden im Konstruktor von GPolyline
verwendet. Für diese Klasse gibt es keinen Konstruktor. Stattdessen wird diese
Klasse als Javascript-Objektliteral instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
clickable |
Boolean |
Gibt an, ob die Polylinie anklickbar ist. Der Standardwert für diese
Option ist true, d. h., wenn die Option nicht angegeben
wird, ist die Polylinie anklickbar.
(Seit 2,91) |
geodesic |
Boolean |
Rendert jede Kante der Polylinie als "geodätisch" (ein Segment eines
"großen Kreises"). Dies ist der kürzeste Pfad zwischen zwei Punkten entlang
der Erdoberfläche.
(Seit 2,84) |
Klasse "GPolyEditingOptions"
Instanzen dieser Klasse werden in den enableEditing-Methoden
von GPolyline und GPolygon
verwendet. Für diese Klasse gibt es keinen Konstruktor. Stattdessen wird diese
Klasse als Javascript-Objektliteral instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
maxVertices |
Number |
Diese Eigenschaft gibt die für diese Polylinie maximal zulässige Anzahl
von Scheitelpunkten an. Sobald diese Anzahl erreicht ist, können keine
weiteren Scheitelpunkte mehr hinzufügt werden.
(Seit 2,111) |
fromStart |
Boolean |
Diese Eigenschaft gibt an, ob enableDrawing vom Anfang statt vom Ende
aus Punkte hinzufügen soll. Letzteres ist die Standardeinstellung.
(Seit 2,111) |
Klasse "GPolyStyleOptions"
Instanzen dieser Klasse werden in der Methode setStrokeStyle
von GPolyline und GPolygon
verwendet sowie in der Methode setFillStyle von GPolygon.
Für diese Klasse gibt es keinen Konstruktor. Stattdessen wird diese Klasse
als Javascript-Objektliteral instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
color |
String |
Diese Eigenschaft gibt einen String mit hexadezimalem numerischen
HTML-Code an, beispielsweise #RRGGBB.
(Seit 2,111) |
weight |
Number |
Diese Eigenschaft gibt die Breite der Linie in Pixel an.
(Seit 2,111) |
opacity |
Number |
Diese Eigenschaft gibt die Deckkraft der Polylinie als Bruchwert zwischen
0 (transparent) und 1 (undurchsichtig) an.
(Seit 2,111) |
Klasse "GPolygon"
Sie ist der GPolyline sehr ähnlich
mit der Ausnahme, dass Sie außerdem eine Füllfarbe und die Deckkraft angeben
können.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GPolygon(latlngs:GLatLng[], strokeColor?:String,
strokeWeight?:Number, strokeOpacity?:Number, fillColor?:Number, fillOpacity?:Number,
opts?:GPolygonOptions) |
Erstellt ein Polygon aus einem Array von Scheitelpunkten. Die colors
werden als String angegeben, der die Farbe in Form hexadezimalen numerischen
HTML-Codes enthält, beispielsweise #RRGGBB. Das weight
ist die Breite der Linie in Pixel. Die opacities wird als
Zahl zwischen 0 und 1 angegeben. Die Linie ist halbdurchsichtig und
Antialiasing ist aktiviert.
(Seit 2,69) |
Factory-Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
GPolygon.fromEncoded(polylines:encoded polylines[], fill?:Boolean, color?:String,
opacity?:Number, outline?:Boolean) |
GPolygon |
Erstellt ein Polygon (welches aus mehreren Polylinien besteht) aus
verschlüsselten Strings mit aggregierten Koordinaten und Stufen. polylines
enthält ein assoziatives Array konstituierender Polylinien, die in dem
in der GPolyline.fromEncoded-Dokumentation
beschriebenen Format verschlüsselt sind. fill gibt an,
ob das Polygon mit einer bestimmten color gefüllt werden
soll. opacity und outline geben an, ob die
Farbe, das Gewicht und die Deckkraft der Polylinie auf das Polygon angewendet
werden sollen. Falls unter "Polylinien" mehrere Werte angegeben sind,
werden die Werte der ersten Polylinie verwendet.
(Seit 2,78) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
deleteVertex(index:Number) |
None |
Entfernt den Scheitelpunkt mit dem angegebenen Index aus dem Polygon
und aktualisiert die Form der Polygone entsprechend. Das GPolygon
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
disableEditing() |
None |
Kehrt den Effekt von enableEditing um, wodurch alle Kontrollpunkte
von der Linie entfernt werden und sie nicht mehr vom Nutzer bearbeitet
werden kann.
(Seit 2,111) |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Ermöglicht dem Benutzer die Konstruktion eines GPolygon-Objekts
durch Klicken auf zusätzliche Punkte auf der Karte. Die GPolyline
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzugefügt worden sein, auch wenn die Polylinie anfänglich nicht ausgefüllt
ist und keine Scheitelpunkte enthält. Mit jedem Klick wird der Begrenzung
des Polygons ein weiterer Scheitelpunkt hinzugefügt und das Zeichnen
kann per Doppelklick oder durch Klicken auf den zuletzt hinzugefügten
Punkt zur Vervollständigung der Form beendet werden. An dieser Stelle
wird das Ereignis "endline" ausgelöst, sofern die Polylinie erfolgreich
fertiggestellt wurde. Anderenfalls wird das Ereignis "cancelline" ausgelöst,
die Polylinie wird jedoch nicht von der Karte entfernt.
(Seit 2,111) |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Ermöglicht dieÄnderung einer vorhandenen GPolygon-Begrenzung.
Ist dies aktiviert, können Nutzer vorhandene Scheitelpunkte auswählen
und verschieben. Sofern durch maxVertices in GPolyEditingOptions
kein Limit für Scheitelpunkte festgelegt ist, das geringer ist als die
aktuelle Anzahl der Scheitelpunkte, werden an den Mittelpunkten der Polygonabschnitte
auch "Geisterpunkte" hinzugefügt, mit deren Hilfe Nutzer neue Scheitelpunkte
interpolieren können, indem sie auf diese zusätzlichen Scheitelpunkte
klicken und sie verschieben. Das Ereignis "lineupdated" wird jedes Mal,
wenn ein Scheitelpunkt hinzugefügt oder verschoben wird, ausgelöst.
(Seit 2,111) |
getVertexCount() |
Number |
Gibt die Anzahl der Scheitelpunkte im Polygon zurück.
(Seit 2,69) |
getVertex(index:Number) |
GLatLng |
Gibt den Scheitelpunkt mit dem angegebenen Index im Polygon zurück.
(Seit 2,69) |
getArea() |
Number |
Gibt die Fläche (in Quadratmetern) des Polygons ausgehend von einer
sphärischen Erde zurück.
(Seit 2,85) |
getBounds() |
GLatLngBounds |
Gibt die Grenzen des Polygons zurück.
(Seit 2,85) |
hide() |
None |
Verbirgt das Polygon, wenn es zurzeit sichtbar ist, und GPolygon.supportsHide
gibt true zurück. Beachten Sie, dass diese Funktion das
Ereignis GPolygon.visibilitychanged
auslöst, falls das Polygon zurzeit sichtbar ist.
(Seit 2,87) |
insertVertex(index:Number, latlng:GLatLng) |
None |
Fügt beim angegebenen Index im Polygon einen neuen Punkt ein. Das
GPolygon muss der Karte bereits
mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
isHidden() |
Boolean |
Gibt true zurück, falls das Polygon zurzeit verborgen
ist. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
show() |
None |
Zeigt das Polygon an, falls es zurzeit verborgen ist. Beachten Sie,
dass diese Funktion das Ereignis GPolygon.visibilitychanged
auslöst, falls das Polygon zurzeit verborgen ist.
(Seit 2,87) |
supportsHide() |
Boolean |
Gibt true zurück, wenn GPolygon.hide()
in der aktuellen Umgebung für GPolygon-Objekte
unterstützt wird. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
setFillStyle(style:GPolyStyleOptions)
|
None |
Ändert den Füllstil des Polygons. Das GPolygon
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Ändert den Linienstil des Polygons. Das GPolygon
muss der Karte bereits mithilfe von GMap2.addOverlay()
hinzufügt worden sein.
(Seit 2,111) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
remove() |
Dieses Ereignis wird ausgelöst, wenn das Polygon mithilfe von GMap2.removeOverlay()
oder GMap2.clearOverlays()
von der Karte entfernt wird. |
visibilitychanged(isVisible:Boolean) |
Dieses Ereignis wird ausgelöst, wenn der Sichtbarkeitsstatus des Polygons
von "sichtbar" zu "verborgen" oder umgekehrt wechselt. Das Argument
isVisible gibt den Status des Polygons nach Abschluss dieses
Sichtbarkeitsstatus wieder.
(Seit 2,87) |
click(latlng:GLatLng) |
Dieses Ereignis wird ausgelöst, wenn auf das Polygon geklickt wird.
Dabei wird die angeklickte Koordinate des Polygons innerhalb seines
Arguments latlngübergeben. Dieses Ergebnis löst anschlieäßend
außerdem ein Klickereignis auf der Karte aus, wobei das Polygon als
overlay-Argument innerhalb dieses Ereignissesübergeben
wird.
(Seit 2,88>) |
mouseover() |
Dieses Ereignis wird ausgelöst, wenn die Maus in den Bereich des Polygons
bewegt wird.
(Seit 2,111) |
mouseout() |
Dieses Ereignis wird ausgelöst, wenn die Maus aus dem Bereich des
Polygons heraus bewegt wird.
(Seit 2,111) |
lineupdated() |
Dieses Ereignis wird ausgelöst, wenn der Stil oder die Form des Polygons
aktualisiert wird.
(Seit 2,111) |
endline() |
Dieses Ereignis wird ausgelöst, wenn die Polygonzeichnung (durch einen
Aufruf von GPolyline.enableDrawing
initiiert) vom Nutzer abgeschlossen wird.
(Seit 2,111) |
cancelline() |
Dieses Ereignis wird ausgelöst, wenn die Polygonzeichnung (durch einen
Aufruf von GPolyline.enableDrawing
initiiert) vom Nutzer abgebrochen wird.
(Seit 2,111) |
Klasse "GPolygonOptions"
Instanzen dieser Klasse werden im Konstruktor von GPolygon
verwendet. Für diese Klasse gibt es keinen Konstruktor. Stattdessen wird diese
Klasse als Javascript-Objektliteral instanziiert.
Eigenschaften
Wie der Name dieser Klasse bereits aussagt, sind alle Eigenschaften optional.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
clickable |
Boolean |
Gibt an, ob das Polygon anklickbar ist. Der Standardwert für diese
Option ist true, d. h., wenn die Option nicht angegeben
wird, ist das Polygon anklickbar.
(Seit 2,91) |
Klasse "GScreenOverlay"
Dieses Objekt zeigt ein rechteckiges Bild-Overlay auf der Karte an, dessen Position unverändert bleibt, wenn sich der Darstellungsbereich ändert. Beispiele für den Einsatz von Bildschirm-Overlays sind Kompassabbildungen, Logos und HUD-Anzeigen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GScreenOverlay(imageUrl:String, screenXY:GScreenPoint,
overlayXY:GScreenPoint, size:GScreenSize)
|
Erstellt ein Bildschirm-Overlay aus einer Bild-URL und zeigt es wie
von den Parametern screenXY, overlayXY und
size angegeben an. Der Parameter overlayXY
bestimmt den Punkt auf dem Overlay-Bild (oder außerhalb dessen), das
der Koordinate screenXY zugewiesen wird. Damit kann das
Bild effektiv "beschnitten" werden. Der Parameter screenXY
bestimmt den Punkt relativ zum Bildschirmursprung (untere linke Ecke),
dem das Overlay-Bild zugewiesen wird.
(Seit 2,92) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
hide() |
None |
Verbirgt das Bildschirm-Overlay, falls es zurzeit sichtbar ist. Beachten
Sie, dass diese Funktion das Ereignis GScreenOverlay.visibilitychanged
auslöst, falls das Bildschirm-Overlay zurzeit sichtbar ist.
(Seit 2,92) |
isHidden() |
Boolean |
Gibt true zurück, falls das Bildschirm-Overlay zurzeit
verborgen ist. Anderenfalls wird false zurückgegeben.
(Seit 2,92) |
show() |
None |
Zeigt das Bildschirm-Overlay an, falls es zurzeit verborgen ist. Beachten
Sie, dass diese Funktion das Ereignis GScreenOverlay.visibilitychanged
auslöst, falls das Bildschirm-Overlay zurzeit verborgen ist.
(Seit 2,92) |
supportsHide() |
Boolean |
Es wird immer true zurückgegeben.
(Seit 2,92) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
visibilitychanged(isVisible:Boolean) |
Dieses Ereignis wird ausgelöst, wenn der Sichtbarkeitsstatus des Bildschirm-Overlays
von "sichtbar" zu "verborgen" oder umgekehrt wechselt. Das Argument
isVisible gibt den Status des Bildschirm-Overlays nach
Abschluss dieses Sichtbarkeitsstatus wieder.
(Seit 2,92) |
Klasse "GScreenPoint"
Ein GScreenPoint gibt einen Punkt
im Darstellungsbereich der Karte mittels X- und Y-Koordinate an. Dies kann,
abhängig vom Wert der optionalen Konstruktorparameter, eine relative oder
eine absolute Positionierung sein.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GScreenPoint(x:Number, y:Number, xunits?:String, yunits?:String) |
Erstellt ein GScreenPoint-Objekt.
Die Koordinaten x und y können entweder eine
relative oder absolute Positionierung sein, entsprechend wird "fraction"
oder "pixels" an die Parameter xunits und yunitsübergeben. Der Standardwert für diese Parameter ist "pixels".
(Seit 2,92) |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
x |
Number |
x-Koordinate, die sich nach rechts hin erhöht. |
y |
Number |
y-Koordinate, die sich nach unten hin erhöht. |
xunits |
String |
Gibt den für die x-Koordinate zu verwendenden Einheitentyp an. Der Wert "fraction" bedeutet die relative Position im Verhältnis zur Kartengröße, der Wert "pixels" steht für eine absolute Positionierung. Standard ist die absolute Positionierung. |
yunits |
String |
Gibt den für die y-Koordinate zu verwendenden Einheitentyp an. Der Wert "fraction" bedeutet die relative Position im Verhältnis zur Kartengröße, der Wert "pixels" steht für eine absolute Positionierung. Standard ist die absolute Positionierung. |
Klasse "GScreenSize"
GScreenSize gibt die Größe des rechteckigen
Bereichs der Karte an, dieser wird durch die Parameter width
und height festgelegt. Jeder dieser Parameter kann eine relative
Angabe oder die Pixelgröße sein, abhängig vom Wert der optionalen Konstruktorparameter.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GScreenSize(width:Number, height:Number, xunits?:String, yunits?:String)
|
Erstellt ein GScreenSize-Objekt.
Die Koordinaten width und height können entweder
eine relative Angabe oder eine Pixelgröße sein, entsprechend wird "fraction"
oder "pixel" an die Parameter xunits und yunitsübergeben. Der Standardwert für die Argumente width und
height ist "pixel".
(Seit 2,92) |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
width |
Number |
Der Breitenparameter der Nutzfläche des Bildschirms. Beachten Sie, dass
dieser Wert entweder eine relative Angabe oder ein absoluter Pixelwert
sein kann. Dies hängt vom Wert der Eigenschaft GScreen.yunits
ab. |
height |
Number |
Der Höhenparameter der Nutzfläche des Bildschirms. Beachten Sie, dass
dieser Wert entweder eine relative Angabe oder ein absoluter Pixelwert
sein kann. Dies hängt vom Wert der Eigenschaft GScreen.yunits
ab. |
xunits |
String |
Gibt den zu verwendenden Einheitentyp für die Eigenschaft GScreenSize.width
an. Der Wert "fraction" bedeutet die relative Position im Verhältnis zur
Kartengröße, der Wert "pixel" steht für eine Pixelpositionierung. Standard
ist die Pixelpositionierung. |
yunits |
String |
Gibt den zu verwendenden Einheitentyp für die Eigenschaft GScreenSize.height
an. Der Wert "fraction" bedeutet die relative Position im Verhältnis
zur Kartengröße, der Wert "pixel" steht für eine Pixelpositionierung.
Standard ist die Pixelpositionierung. |
Klasse "GGroundOverlay"
Dieses Objekt erstellt ein rechteckiges Bild-Overlay auf der Karte, dessen
Grenzen durch GLatLngBounds definiert
werden.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GGroundOverlay(imageUrl:String, bounds:GLatLngBounds)
|
Erstellt ein Boden-Overlay aus einer Bild-URL und dessen Grenzen.
(Seit 2,79) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
hide() |
None |
Verbirgt das Boden-Overlay, falls es zurzeit sichtbar ist. Beachten
Sie, dass diese Funktion das Ereignis GGroundOverlay.visibilitychanged
auslöst, falls das Boden-Overlay zurzeit sichtbar ist.
(Seit 2,87) |
isHidden() |
Boolean |
Gibt true zurück, falls das Boden-Overlay zurzeit verborgen
ist. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
show() |
None |
Zeigt das Boden-Overlay an, falls es zurzeit verborgen ist. Beachten
Sie, dass diese Funktion das Ereignis GGroundOverlay.visibilitychanged
auslöst, falls das Boden-Overlay zurzeit verborgen ist.
(Seit 2,87) |
supportsHide() |
Boolean |
Es wird immer true zurückgegeben.
(Seit 2,87) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
visibilitychanged(isVisible:Boolean) |
Dieses Ereignis wird ausgelöst, wenn der Sichtbarkeitsstatus des Boden-Overlays
von "sichtbar" zu "verborgen" oder umgekehrt wechselt. Das Argument
isVisible gibt den Status des Boden-Overlays nach Abschluss
dieses Sichtbarkeitsstatus wieder.
(Seit 2,77) |
Klasse "GIcon"
Ein Symbol gibt die Bilder an, die zum Anzeigen von GMarker
auf der Karte verwendet werden. Aus Gründen der Browser-Kompatibilität ist
die Angabe eines Symbols ziemlich komplex. Beachten Sie, dass Sie das Standard-Maps-Symbol
G_DEFAULT_ICON verwenden können, wenn Sie kein eigenes Symbol
angeben möchten.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GIcon(copy?:GIcon, image?:String) |
Erstellt ein neues Symbolobjekt. Ist im optionalen Argument copy
ein anderes Symbol angegeben, werden seine Eigenschaften kopiert. Anderenfalls
bleiben sie leer. Das optionale Argument image legt den
Wert der image-Eigenschaft fest. |
Konstanten
| Konstante | Beschreibung |
|---|---|
G_DEFAULT_ICON |
Das für Markierungen verwendete Standardsymbol. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
image |
String |
Die URL für das Vordergrundbild des Symbols. |
shadow |
String |
Die URL für das Schattenbild des Symbols. |
iconSize |
GSize |
Die Pixelgröße des Vordergrundbilds des Symbols. |
shadowSize |
GSize |
Die Pixelgröße des Schattenbilds. |
iconAnchor |
GPoint |
Die Pixelkoordinate relativ zur oberen linken Ecke des Symbolbilds, an der dieses Symbol mit der Karte verankert ist. |
infoWindowAnchor |
GPoint |
Die Pixelkoordinate relativ zur oberen linken Ecke des Symbolbilds, an der das Infofenster mit diesem Symbol verankert ist. |
printImage |
String |
Die URL des Vordergrundbilds des Symbols, das für gedruckte Karten
verwendet wird. Es muss dieselbe Größe haben wie das Hauptbild des Symbols,
das durch image festgelegt wird. |
mozPrintImage |
String |
Die URL des Vordergrundbilds des Symbols, das für gedruckte Karten
in Firefox/Mozilla verwendet wird. Es muss dieselbe Größe haben wie
das Hauptbild des Symbols, das durch image festgelegt wird. |
printShadow |
String |
Die URL des Schattenbilds, das für gedruckte Karten verwendet wird. Bei dem Bild sollte es sich um eine GIF-Datei handeln, da die meisten Browser keine PNG-Bilder drucken können. |
transparent |
String |
Die URL einer praktisch transparenten Version des Vordergrundbilds des Symbols, das zum Erfassen von Klickereignissen in Internet Explorer verwendet wird. Bei dem Bild sollte es sich um eine 24-Bit-PNG-Version des Hauptbilds des Symbols mit 1 % Deckkraft handeln, aber mit derselben Form und Größe wie das Hauptsymbol. |
imageMap |
Number[] |
Ein Array von Ganzzahlen, die die x/y-Koordinaten der Bildkarte repräsentieren, die zum Angeben des anklickbaren Teils des Symbolbilds in anderen Browsern als Internet Explorer verwendet werden sollten. |
maxHeight |
Integer |
Gibt die Strecke in Pixel an, um die sich eine Markierung beim Verschieben
visuell nach oben bewegt.
(Seit 2,79) |
dragCrossImage |
String |
Gibt die URL für das Kreuz beim Verschieben eines Symbols an.
(Seit 2,79) |
dragCrossSize |
GSize |
Gibt die Pixelgröße des Kreuzes an, das beim Verschieben eines Symbols
angezeigt wird.
(Seit 2,79) |
dragCrossAnchor |
GPoint |
Gibt die Abstände des Kreuzes in Pixelkoordinaten (relativ zu iconAnchor)
an, das beim Verschieben eines Symbols angezeigt wird.
(Seit 2,79) |
Klasse "GPoint"
Ein GPoint ist ein durch Pixelkoordinaten
definierter Punkt auf der Karte. Beachten Sie, dass dies in v2 kein
Punkt auf der Erde ist, der durch seine geografischen Koordinaten definiert
ist. Geografische Koordinaten werden nun durch GLatLng
dargestellt.
Im Koordinatensystem von Google Maps, erhöht sich die x-Koordinate
nach rechts hin und die y-Koordinate nach unten hin.
Sie können die GPoint-Koordinaten jedoch
beliebig verwenden.
Beachten Sie, dass Sie auf die beiden Parameter von GPoint
in Form der Eigenschaften x und y zugreifen können,
es aber besser ist, diese niemals zundern, sondern stattdessen ein neues
Objekt mit unterschiedlichen Parametern zu erstellen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GPoint(x:Number, y:Number) |
Erstellt ein GPoint-Objekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
x |
Number |
x-Koordinate. (Dieser Wert erhöht sich im Google Maps-Koordinatensystem
nach rechts hin.) |
y |
Number |
y-Koordinate. (Dieser Wert erhöht sich im Google Maps-Koordinatensystem
nach unten hin.) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
equals(other:GPoint) |
Boolean |
Gibt true zurück, wenn der andere Punkt dieselben Koordinaten
hat. |
toString() |
String |
Gibt einen String zurück, der die X- und Y-Koordinaten, durch ein Komma getrennt, in dieser Reihenfolge enthält. |
Klasse "GSize"
GSize ist die Größe eines rechteckigen
Bereichs der Karte in Pixel. Das Größenobjekt hat die beiden Parameter width
und height. Breite ist die Differenz in der X-Koordinate und
Höhe ist die Differenz in der Y-Koordinate in Punkten.
Beachten Sie, dass Sie auf die beiden Parameter von GSize
in Form der Eigenschaften width und height zugreifen
können, es aber besser ist, diese niemals zu ändern, sondern stattdessen ein
neues Objekt mit unterschiedlichen Parametern zu erstellen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GSize(width:Number, height:Number) |
Erstellt ein GSize-Objekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
width |
Number |
Der Breitenparameter. |
height |
Number |
Der Höhenparameter. |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
equals(other:GSize) |
Boolean |
Gibt true zurück, wenn die andere Größe über genau dieselben
Komponenten verfügt. |
toString() |
String |
Gibt einen String zurück, der die Breite und Höhe, durch ein Komma getrennt, in dieser Reihenfolge enthält. |
Klasse "GBounds"
GBounds ist ein rechteckiger Bereich
der Karte in Pixelkoordinaten. Beachten Sie, dass ein Rechteck in geografischen
Koordinaten durch ein GLatLngBounds-Objekt
repräsentiert wird.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GBounds(points:GPoint[]) |
Konstruiert ein Rechteck, das sämtliche gegebenen points
enthält. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
minX |
Number |
Die X-Koordinate der linken Kante des Rechtecks. |
minY |
Number |
Die Y-Koordinate der oberen Kante des Rechtecks. |
maxX |
Number |
Die X-Koordinate der rechten Kante des Rechtecks. |
maxY |
Number |
Die Y-Koordinate der unteren Kante des Rechtecks. |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
toString() |
String |
Gibt einen String zurück, der, durch ein Komma getrennt und in Klammern eingeschlossen, die Koordinaten der oberen linken und der unteren rechten Eckpunkte des Rechtecks in dieser Reihenfolge enthält. |
equals(other:GBounds) |
Boolean |
Gibt "true" zurück, wenn alle Parameter in diesem Rechteck mit den
Parametern des anderen Rechtecksübereinstimmen.
(Seit 2,98) |
mid() |
GPoint |
Gibt die Pixelkoordinaten des Mittelpunkts des rechteckigen Bereichs
zurück.
(Seit 2,88) |
min() |
GPoint |
Gibt die Pixelkoordinaten der oberen linken Ecke des rechteckigen Bereichs zurück. |
max() |
GPoint |
Gibt die Pixelkoordinaten der unteren rechten Ecke des rechteckigen Bereichs zurück. |
containsBounds(other:GBounds) |
Boolean |
Gibt true zurück, wenn derübergebene rechteckige Bereich
vollständig in diesem rechteckigen Bereich enthalten ist. |
containsPoint(point:GPoint) |
Boolean |
Gibt true zurück, wenn der rechteckige Bereich (einschlieäßlich)
die Pixelkoordinaten enthält.
(Seit 2,88) |
extend(point:GPoint) |
None |
Vergrößert den Bereich, sodass der Punkt ebenfalls im Bereich enthalten ist. |



