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
(bounds:GLatLngBounds)
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
(callback:Function(instance: GEPlugin))
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.