API 4
Enumeration "GGoogleBarListingTypes"
Diese Konstanten beschränken die von einer lokalen Suche mit der GGoogleBar
zurückgegebenen Ergebnistypen. Dieses Suchverhalten wird in der Eigenschaft
GGoogleBarOptions.listingTypes
festgelegt.
Konstanten
| Konstante | Beschreibung |
|---|---|
G_GOOGLEBAR_TYPE_BLENDED_RESULTS |
Diese Konstante gibt an, dassüber die GGoogleBar der Karte
durchgeführte Suchvorgänge alle Ergebnistypen zurückgeben (KML, Unternehmen,
Geocodes usw.).
(Seit 2,113) |
G_GOOGLEBAR_TYPE_KMLONLY_RESULTS |
Diese Konstante gibt an, dasüber die GGoogleBar der Karte
durchgeführte Suchvorgänge nur Ergebnisse aus indizierten KML-/KMZ-/GeoRSS-Dateien
zurückgeben.
(Seit 2,113) |
G_GOOGLEBAR_TYPE_LOCALONLY_RESULTS |
Diese Konstante gibt an, dassüber die GGoogleBar der Karte
durchgeführte Suchvorgänge nur Unternehmens- und Geocode-Ergebnisse zurückgeben.
(Seit 2,113) |
Enumeration "GGoogleBarLinkTarget"
Diese Konstanten werden in GGoogleBarOptions.linkTargetübergeben und definieren das Standardziel für Links in den Ergebnis-Infofenstern.
Konstanten
| Konstante | Beschreibung |
|---|---|
G_GOOGLEBAR_LINK_TARGET_BLANK |
Entspricht target = '_blank'. |
G_GOOGLEBAR_LINK_TARGET_PARENT |
Entspricht target = '_parent'. |
G_GOOGLEBAR_LINK_TARGET_SELF |
Entspricht target = '_self'. |
G_GOOGLEBAR_LINK_TARGET_TOP |
Entspricht target = '_top'. |
Enumeration "GGoogleBarResultList"
Diese Konstanten werden in GGoogleBarOptions.resultListübergeben und definieren, wie die Ergebnisliste angezeigt wird.
Konstanten
| Konstante | Beschreibung |
|---|---|
G_GOOGLEBAR_RESULT_LIST_INLINE |
Dies entspricht dem Standardstil, wobei die Ergebnisliste in tabellarischer Form auf der Karte angezeigt wird. |
G_GOOGLEBAR_RESULT_LIST_SUPPRESS |
Dies entspricht dem Standardstil, wobei die Ergebnisliste ausgeblendet ist und durch die Schaltflächen WeiterVorherige ersetzt wird. |
Enumeration "GMapPane"
Diese Konstanten definieren die Stapelreihenfolge (Z-Reihenfolge), die von der Karte und den in ihr befindlichen Objekten zu Anzeigezwecken verwendet wird. Jedes Fenster definiert eine Reihe ähnlicher Anzeigeobjekte, die auf der Karte eingeblendet werden sowie eine eindeutige Z-Reihenfolge auf der Karte. Fenster mit einer höheren Position in der Z-Reihenfolge werden "oberhalb" von Fenstern mit einer niedrigeren Position angezeigt. (Auch Objekte innerhalb eines bestimmten Fensters können gemäß der jeweiligen Position in der Z-Reihenfolge angezeigt werden. So kann ein Objekt oberhalb anderer Objekte innerhalb des Fensters eingeblendet werden.)
Sie müssen diese Konstanten verwenden, wenn Sie anhand von GOverlay
Unterklassen erstellen, sodass Sie Ihr benutzerdefiniertes Overlay in einem
der Fenster platzieren können.
Die folgenden Konstanten werden von der untersten Z-Position bis zur obersten aufgelistet.
Konstanten
| Konstante | Beschreibung |
|---|---|
G_MAP_MAP_PANE |
Dieses Fenster ist das unterste Fenster und befindet sich oberhalb der Kacheln. |
G_MAP_OVERLAY_LAYER_PANE |
Dieses Fenster enthält Polylinien, Polygone, Boden-Overlays und Kachelebenen-Overlays.
(Seit 2,127) |
G_MAP_MARKER_SHADOW_PANE |
Dieses Fenster enthält die Markierungsschatten. |
G_MAP_MARKER_PANE |
Dieses Fenster enthält die Vordergrundbilder für Markierungen. |
G_MAP_FLOAT_SHADOW_PANE |
Dieses Fenster enthält den Infofensterschatten. Es befindet sich oberhalb
von G_MAP_MARKER_PANE, sodass sich Markierungen im Schatten
des Infofensters befinden können. |
G_MAP_MARKER_MOUSE_TARGET_PANE |
Dieses Fenster enthält transparente Elemente, die DOM-Mausereignisse
für die Markierungen empfangen. Es befindet sich oberhalb von G_MAP_FLOAT_SHADOW_PANE,
sodass auf Markierungen im Schatten des Infofensters geklickt werden
kann. |
G_MAP_FLOAT_PANE |
Dieses Fenster enthält das Infofenster. Es befindet sich oberhalb aller Karten-Overlays. |
Interface "GOverlay"
Dieses Interface wird durch die Klassen GMarker,
GPolyline, GTileLayerOverlay
und GInfoWindow in der Maps-API-Bibliothek
implementiert. Sie können es implementieren, wenn Sie benutzerdefinierte Typen
von Overlay-Objekten auf der Karte anzeigen möchten. Eine Instanz von GOverlay
kann mit der Methode GMap2.addOverlay()
auf der Karte abgelegt werden. Die Karte ruft anschließend die Methode GOverlay.initialize()
der Overlay-Instanz auf, damit diese anfänglich auf der Karte angezeigt wird.
Immer wenn sich die Kartenanzeige ändert, ruft die Karte GOverlay.redraw()
auf, sodass sich das Overlay, falls erforderlich, neu positionieren kann. Die
Overlay-Instanz kann mit der Methode GMap2.getPane()
ein oder mehrere DOM-Containerelemente abrufen, mit dem bzw. denen sie sich
verbinden kann.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GOverlay() |
Dieser Konstruktor erstellt Dummy-Implementierungen für die Methoden. Wenn von dieser Klasse geerbt wird, sollte Ihr abgeleiteter Klassenkonstruktor diesen Konstruktor der Vollständigkeit halber aufrufen. |
Statische Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
GOverlay.getZIndex(latitude:Number) |
Number |
Gibt einen CSS-Wert von z-index für eine angegebene geografische
Breite zurück. Es wird ein Z-Index berechnet, sodass sich weiter südlich
gelegene Overlays oberhalb von Overlays weiter nördlich befinden, wodurch
die 3D-Darstellung der Markierungs-Overlays zustande kommt. |
Abstrakte Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
initialize(map:GMap2) |
None |
Wird von der Karte aufgerufen, nachdem das Overlay unter Verwendung
von GMap2.addOverlay()
zur Karte hinzugefügt wurde. Das Overlay-Objekt kann sich selbst in
verschiedene Fenster der Karte einzeichnen. Die Fenster können mit GMap2.getPane()
abgerufen werden. |
remove() |
None |
Wird von der Karte aufgerufen, nachdem das Overlay unter Verwendung
von GMap2.removeOverlay()
oder GMap2.clearOverlays()
von der Karte entfernt wurde. Mit dieser Methode wird das Overlay aus
den Kartenfenstern entfernt. |
copy() |
GOverlay |
Gibt eine nicht initialisierte Eigenkopie zurück, die zur Karte hinzugefügt werden kann. |
redraw(force:Boolean) |
None |
Wird von der Karte aufgerufen, wenn sich die Kartenanzeige geändert
hat. Das Argument force ist true, wenn die Zoomstufe
oder der Abstand in Pixel der Kartenansicht sich geändert hat, sodass
die Pixelkoordinaten neu berechnet werden müssen. |
Interface "GControl"
Dieses Interface wird von allen Bedienelementen implementiert. Sie können
es implementieren, um ein benutzerdefiniertes Bedienelement für die Karte
bereitzustellen. Bedienelemente werden der Karte anhand der GMap2.addControl()-Methode
hinzugefügt.
Im Unterschied zu Overlays, die relativ zur Karte positioniert werden, werden Bedienelemente relativ zur Kartenansicht positioniert, d. h., sie werden nicht verschoben, wenn die Karte verschoben wird.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GControl(printable?:Boolean, selectable?:Boolean) |
Erstellt die Prototypinstanz für eine neue Bedienelementklasse. Das
Flag printable gibt an, dass das Bedienelement in der Druckausgabe
der Karte sichtbar sein sollte. Das Flag selectable gibt
an, dass das Bedienelement Text enthält, der ausgewählt werden kann. |
Methoden
Diese Methoden werden auch durch die Karte aufgerufen, wenn das Bedienelement
der Karte mithilfe von GMap2.addControl()
hinzugefügt wird. Diese Methoden werden also nicht von Ihnen aufgerufen,
sondern von Ihnen implementiert.
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
printable() |
Boolean |
Kehrt zur Karte zurück, wenn das Bedienelement druckbar ist. |
selectable() |
Boolean |
Kehrt zur Karte zurück, wenn das Bedienelement auswählbaren Text enthält. |
initialize(map:GMap2) |
Node |
Wird von der Karte aufgerufen, damit sich das Bedienelement initialisieren
kann. Das Bedienelement verwendet die Methode GMap2.getContainer(),
um das DOM-Element abzurufen, das die Karte enthält, und fügt sich dieser
selbst hinzu. Das hinzugefügte Element wird zurückgegeben. |
getDefaultPosition() |
GControlPosition |
Gibt der Karte die Position in der Kartenansicht zurück, an der das
Bedienelement standardmäßig angezeigt wird. Dies wird vom zweiten Argument
von GMap2.addControl()
aufgehoben. |
Klasse "GControlPosition"
Diese Klasse beschreibt die Position eines Bedienelements in der Kartenansicht.
Es besteht aus einer Ecke, die relativ zur Position des Bedienelements ist,
und einem Abstand, der diese Position bestimmt. Sie kann als optionales Argument
position an die Methode GMap2.addControl()übergeben werden und wird von der Methode GControl.getDefaultPosition()
zurückgegeben.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GControlPosition(anchor:enum GControlAnchor, offset:GSize)
|
Erstellt eine Spezifikation für die Position eines Bedienelements. |
Enumeration "GControlAnchor"
Konstanten
| Konstante | Beschreibung |
|---|---|
G_ANCHOR_TOP_RIGHT |
Das Bedienelement wird in der rechten oberen Ecke der Karte verankert. |
G_ANCHOR_TOP_LEFT |
Das Bedienelement wird in der linken oberen Ecke der Karte verankert. |
G_ANCHOR_BOTTOM_RIGHT |
Das Bedienelement wird in der rechten unteren Ecke der Karte verankert. |
G_ANCHOR_BOTTOM_LEFT |
Das Bedienelement wird in der linken unteren Ecke der Karte verankert. |
Klasse "GMapTypeControl"
Ein GMapTypeControl stellt ein
Bedienelement zum Auswählen und Umschalten zwischen unterstützten Kartentypen
mittels Schaltflächen zur Verfügung. Allen Kartentypen, die der Karte zum Zeitpunkt
der Konstruktion der Elemente zugeordnet sind, werden diese Bedienelemente zur
Verfügung gestellt.
Standardmäßig unterstützen Karten das Festlegen eines G_DEFAULT_MAP_TYPES.
Karten können auch Kartentypen explizitüber GMap2.addMapType()
hinzufügen. Um Platz für die Karte zu sparen, können Sie mithilfe von GHierarchicalMapTypeControl
"verschachtelte" Kartentypen oder mithilfe von GMenuMapTypeControl
Dropdown-Kartentypen anzeigen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMapTypeControl(useShortNames?:Boolean) |
Erstellt ein GMapTypeControl
mit den Kurznamen (alternativen Namen) der Kartentypen, wenn useShortNames
auf "true" gesetzt ist, und standardmäßig mit den langen Namen. |
Klasse "GMenuMapTypeControl"
Ein GMenuMapTypeControl stellt
ein Bedienelement zum Auswählen und Umschalten zwischen unterstützten Kartentypenüber ein Dropdown-Menü zur Verfügung. Allen Kartentypen, die der Karte zum
Zeitpunkt der Konstruktion der Elemente zugeordnet sind, werden diese Bedienelemente
zur Verfügung gestellt.
Standardmäßig unterstützen Karten das Festlegen eines G_DEFAULT_MAP_TYPES.
Karten können auch Kartentypen explizitüber GMap2.addMapType()
hinzufügen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMenuMapTypeControl(useShortNames?:Boolean) |
Erstellt ein GMenuMapTypeControl
mit den Kurznamen (alternativen Namen) der Kartentypen, wenn useShortNames
auf "true" gesetzt ist, und standardmäßig mit den langen Namen. |
Klasse "GHierarchicalMapTypeControl"
Das GHierarchicalMapTypeControl
stellt ein verschachteltes Kartentyp-Bedienelement zum Auswählen und Umschalten
zwischen unterstützten Kartentypen mittels Schaltflächen und verschachtelter
Kontrollkästchen zur Verfügung. Allen Kartentypen, die der Karte zum Zeitpunkt
der Konstruktion der Elemente zugeordnet sind, werden diese Bedienelemente zur
Verfügung gestellt.
Zur Karte hinzugefügte Kartentypen werden als Schaltflächen wie im normalen
GMapTypeControl verwendet. Kartentypen,
die als Subtypen anderer Kartentypen festgelegt sind (siehe auch nachfolgende
addRelationship()-Methode) werden als Kontrollkästchen-Untermenüeinträge
unter derübergeordneten Schaltfläche angezeigt.
Standardmäßig unterstützen Karten das Festlegen von G_DEFAULT_MAP_TYPES.
Karten können jedoch auch Kartentypen explizitüber GMap2.addMapType()
hinzufügen. Allen Kartentypen, die der Karte zum Zeitpunkt der Konstruktion
der Elemente zugeordnet sind, werden diese Bedienelemente zur Verfügung gestellt.
Beachten Sie: Da Subtypen als Kontrollkästchen angezeigt werden, können Sie
ihre Darstellung mit denübergeordneten und gleichgeordneten Elementen im Untermenü
einstellen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GHierarchicalMapTypeControl() |
Erstellt das Bedienelement. Standardmäßig ist der Kartentyp G_HYBRID_MAP
dem Kartentyp G_SATELLITE_MAP untergeordnet. Wird dies
nicht gewünscht, kann die Beziehung durch Aufrufen der Methode clearRelationships()
entfernt werden. |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
addRelationship(parentType:GMapType, childType:GMapType,
childText?:String, isDefault?:Boolean) |
None |
Registriert eineüber-/untergeordnete Beziehung zwischen Kartentypen
mit dem Bedienelement. Ist childText gegeben, wird dies statt
seines Namens neben dem Kontrollkästchen für den untergeordneten Kartentyp
angezeigt. Ist isDefault auf "true" eingestellt, wird der
untergeordnete Kartentyp standardmäßig ausgewählt. Beachten Sie, dass
alle Beziehungen eingerichtet werden müssen, bevor das Bedienelement hinzugefügt
wird. Das Hinzufügen von Beziehungen, nachdem das Bedienelement hinzugefügt
wurde, hat keine Auswirkungen.
(Seit 2,94) |
removeRelationship(mapType:GMapType) |
None |
Entfernt vom Bedienelement alle Beziehungen, die einen Kartentyp betreffen.
(Seit 2,94) |
clearRelationships() |
None |
Entfernt alle Beziehungen aus dem Bedienelement.
(Seit 2,94) |
Klasse "GMapType"
Google bietet einige vordefinierte Kartentypen. Mit dieser Klasse werden
benutzerdefinierte Kartentypen definiert. Damit sie auf der Karte angezeigt
werden, verwenden Sie den GMap2-Konstruktor
oder die Methode GMap2.addMapType().
Unter GTileLayerOverlay finden
Sie weitere Informationen zum Hinzufügen (statt Ersetzen) zu den Kachelebenen
der Karte.
Zu dieser Klasse können auch Unterklassen angelegt werden. Konstruktor-Argumente
können bei Instanzierung als Prototyp weggelassen werden. Ein Unterklassen-Konstruktor
muss den GMapType-Konstruktor mithilfe
von call() aufrufen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMapType(layers:GTileLayer[], projection:GProjection,
name:String, opts?:GMapTypeOptions) |
Erstellt einen Kartentyp mit den angegebenen Kachelebenen, der Projektion, dem Namen und optionalen Parametern. |
Methoden
Diese Methoden werden meistens von der Karte aufgerufen, der dieser Kartentypübergeben wird, doch einige Methoden können auch von auäßerhalb der Karte aufgerufen
werden, z. B. getBoundsZoomLevel().
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
getSpanZoomLevel(center:GLatLng, span:GLatLng,
viewSize:GSize) |
Number |
Gibt die Zoomstufe an die Karte zurück, bei der der Kartenabschnitt, der durch den Mittelpunkt und den Abstand definiert wird, in die Kartenansicht passt, deren Größe in Pixel angegeben ist. |
getBoundsZoomLevel(bounds:GLatLngBounds,
viewSize:GSize) |
None |
Gibt die Zoomstufe an die Karte zurück, bei der der Kartenabschnitt, der durch Grenzen definiert wird, in die Kartenansicht passt, deren Größe in Pixel angegeben ist. |
getName(short?:Boolean) |
String |
Gibt den Namen des Kartentyps an die Karte zurück, der als Schaltflächenbeschriftung
im GMapTypeControl verwendet
werden soll. |
getProjection() |
GProjection |
Gibt die Projektion dieses Kartentyps an die Karte zurück. |
getTileSize() |
Number |
Gibt die Kartenkachelgröäße in Pixel dieses Kartentyps an die Karte zurück. Es wird davon ausgegangen, dass die Kacheln quadratisch sind. Alle Kachelebenen haben die gleiche Kachelgröäße. |
getTileLayers() |
GTileLayer[] |
Gibt das Array der Kachelebenen an die Karte zurück. |
getMinimumResolution() |
Number |
Gibt die niedrigste Zoomstufe, auf der dieser Kartentyp definiert ist, an die Karte zurück. |
getMaximumResolution() |
Number |
Gibt die höchste Zoomstufe, auf der dieser Kartentyp definiert ist, an die Karte zurück. |
getTextColor() |
String |
Gibt die am besten für Overlay-Text auf der Karte geeignete Farbe an die Karte zurück. Wird für die Textfarbe der Urheberrechtsmeldung verwendet, die vom Urheberrechtsbedienelement angezeigt wird. |
getLinkColor() |
String |
Gibt die am besten für einen Overlay-Hyperlink auf der Karte geeignete Farbe an die Karte zurück. Wird für die Textfarbe der Nutzungsbedingungen verwendet, die vom Urheberrechtsbedienelement angezeigt werden. |
getErrorMessage() |
String |
Gibt die Fehlermeldung an die Karte zurück, die in Bereichen oder in der Zoomstufe angezeigt wird, wo dieser Kartentyp keine Kartenkacheln besitzt. |
getCopyrights(bounds:GLatLngBounds, zoom:Number)
|
String[] |
Gibt die Urheberrechtsmeldungen an die Karte zurück, die für Region
gelten, die durch bounds auf der gegebenen Zoomstufe definiert
wird. Dies wird von der Urheberrechtsmeldung auf der Karte verwendet. |
getUrlArg() |
String |
Gibt einen Wert an die Karte zurück, der als URL-Parameterwert zur Identifikation des Kartentyps in Permalinks zur aktuellen Kartenansicht verwendet wird. Dies wird derzeit nur von der Kartenanwendung verwendet. |
getAlt() |
String |
Gibt den alternativen Text dieses Kartentyps an die Karte zurück.
(Seit 2,86) |
Konstanten
| Konstante | Beschreibung |
|---|---|
G_NORMAL_MAP |
Dieser Kartentyp (die Standardeinstellung) zeigt eine normale Straäßenkarte an. |
G_SATELLITE_MAP |
Dieser Kartentyp zeigt Satellitenbilder an. |
G_HYBRID_MAP |
Dieser Kartentyp zeigt eine transparente Ebene von Hauptstraäßen auf Satellitenbildern an. |
G_PHYSICAL_MAP |
Dieser Kartentyp zeigt Karten mit physischen Eigenschaften wie z. B.
Gelände und Vegetation an. Dieser Kartentyp wird standardmäßig in Kartentyp-Bedienelementen
nicht angezeigt.
(Seit 2,94) |
G_MOON_ELEVATION_MAP |
Dieser Kartentyp zeigt eine schattierte Geländekarte der Mondoberfläche
an, nach Höhe eingefärbt. Dieser Kartentyp wird standardmäßig in Kartentyp-Bedienelementen
nicht angezeigt.
(Seit 2,95) |
G_MOON_VISIBLE_MAP |
Dieser Kartentyp zeigt Fotos aus der Mondumlaufbahn an. Dieser Kartentyp
wird standardmäßig in Kartentyp-Bedienelementen nicht angezeigt.
(Seit 2,95) |
G_MARS_ELEVATION_MAP |
Dieser Kartentyp zeigt eine Reliefdarstellung der Marsoberfläche an,
nach Höhe eingefärbt. Dieser Kartentyp wird standardmäßig in Kartentyp-Bedienelementen
nicht angezeigt.
(Seit 2,95) |
G_MARS_VISIBLE_MAP |
Dieser Kartentyp zeigt Fotos aus der Marsumlaufbahn an. Dieser Kartentyp
wird standardmäßig in Kartentyp-Bedienelementen nicht angezeigt.
(Seit 2,95) |
G_MARS_INFRARED_MAP |
Dieser Kartentyp zeigt eine schattierte Infrarotkarte der Marsoberfläche
an, auf der wärmere Bereiche heller und kältere Bereiche dunkler erscheinen.
(Seit 2,95) |
G_SKY_VISIBLE_MAP |
Dieser Kartentyp zeigt ein Mosaik des Weltraums an, das die gesamte
Himmelssphäre abdeckt.
(Seit 2,95) |
G_SATELLITE_3D_MAP |
Dieser Kartentyp zeigt in Verbindung mit dem Google
Earth-Browser-Plug-in eine voll interaktives 3D-Modell der Erde
mit Satellitenbildern an. Dieser Kartentyp wird standardmäßig in Kartentyp-Bedienelementen
nicht angezeigt. Durch das Hinzufügen dieses Kartentyps zu Ihrer Karte wird nicht nur ein Bedienelement für den Google Earth-Kartentyp hinzugefügt, sondern auch die Initialisierung des Kartentypsübernommen, sobald ein Nutzer auf das Bedienelement klickt. Ist im Browser eines Nutzers das Google Earth-Plug-in derzeit nicht installiert, wird er beim erstmaligen Auswählen dieses Kartentyps aufgefordert, das Plug-in herunterzuladen und zu installieren und seinen Browser neu zu starten. Für Nutzer, die das Plug-in bereits installiert haben, wird nach der Auswahl dieses Kartentyps eine Earth-Instanz für die Karte erstellt und eine 3D-Ansicht der Erde angezeigt. Mithilfe von GMap2.getEarthInstance()
können Sie diese Earth-Instanz abrufen und mit dem Google
Earth-API bearbeiten. Derzeit funktionieren mit diesem 3D-Kartentyp Markierungen, Infofenster und Polylinien, andere Funktionen werden jedoch noch nicht unterstützt. Für zukünftige Version ist die Unterstützung weiterer Funktionen geplant. (Seit 2,113) |
G_DEFAULT_MAP_TYPES |
Ein Array der ersten drei vordefinierten, oben beschriebenen Kartentypen (G_NORMAL_MAP, G_SATELLITE_MAP und G_HYBRID_MAP). |
G_MOON_MAP_TYPES |
Ein Array der beiden oben beschriebenen Mond-Kartentypen (G_MOON_ELEVATION_MAP und G_MOON_VISIBLE_MAP). |
G_MARS_MAP_TYPES |
Ein Array der drei oben beschriebenen Mars-Kartentypen (G_MARS_ELEVATION_MAP, G_MARS_VISIBLE_MAP und G_MARS_INFRARED_MAP). |
G_SKY_MAP_TYPES |
Ein Array des oben beschriebenen Weltraum-Kartentyps (G_SKY_VISIBLE_MAP). |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
newcopyright(copyright:GCopyright) |
Dieses Ereignis wird ausgelöst, wenn ein neuer Urheberrechtsvermerk zur Urheberrechtssammlung einer der in diesem Kartentyp enthaltenen Kachelebenen hinzugefügt wird. |
Klasse "GMapTypeOptions"
Instanzen dieser Klasse werden als opts?-Argument für den GMapType-Konstruktor
verwendet. Für diese Klasse gibt es keinen Konstruktor. Stattdessen wird diese
Klasse als Javascript-Objektliteral instanziiert.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
shortName |
String |
Legt den Kurznamen des Kartentyps fest, der von GMapType.getName(true)
zurückgegeben wird. Die Standardeinstellung ist die gleiche wie für
name. |
urlArg |
String |
Legt das URL-Argument des Kartentyps fest, der von GMapType.getUrlArg()
zurückgegeben wird. Standardmäßig ist der String leer. |
maxResolution |
Number |
Legt die höchste Zoomstufe dieses Kartentyps fest, die von GMapType.getMaximumResolution()
zurückgegeben wird. Die Standardeinstellung ist das Maximum aller Kachelebenen. |
minResolution |
Number |
Legt die niedrigste Zoomstufe dieses Kartentyps fest, die von GMapType.getMinimumResolution()
zurückgegeben wird. Die Standardeinstellung ist das Minimum aller Kachelebenen. |
tileSize |
Number |
Legt die von GMapType.getTileSize()
zurückgegebene Kachelgröße fest. Die Standardeinstellung ist 256. |
textColor |
String |
Legt die Textfarbe fest, die von GMapType.getTextColor()
zurückgegeben wird. Die Standardeinstellung ist "black". |
linkColor |
String |
Legt die Textfarbe fest, die von GMapType.getLinkColor()
zurückgegeben wird. Die Standardeinstellung ist "#7777cc". |
errorMessage |
String |
Legt die Fehlermeldung fest, die von GMapType.getErrorMessage()
zurückgegeben wird. Standardmäßig ist der String leer. |
alt |
String |
Legt den alternativen Text für den Kartentyp fest, der von GMapType.getAlt()
zurückgegeben wird. Standardmäßig ist der String leer.
(Seit 2,64) |
radius |
Number |
Legt des Radius des Kartentyps mit derübergebenen Number
in Metern fest . Der Standardwert ist 6378137, der Äquatorradius der Erde
in Metern.
(Seit 2,89) |
Klasse "GLayer"
Diese Klasse instanziiert ein vordefiniertes "Ebenen"-Overlay, das aus einer
Sammlung verwandter Elemente besteht. Die Klasse implementiert das Interface
GOverlay und wird auf diese Weise mithilfe
der GMap2.addOverlay()-Methode
zur Karte hinzugefügt.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GLayer(layerId:String) |
Erstellt anhand der eindeutigen Ebenen-ID eine Ebene. http://spreadsheets.google.com/pub?key=p9pdwsai2hDN-cAocTLhnag enthält eine Liste der derzeit unterstützten Ebenen. |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
hide() |
None |
Blendet dieses Overlay aus, sodass es nicht sichtbar ist, behält aber die Position im Overlay-Stapel bei. |
show() |
None |
Zeigt eine zuvor verborgene GLayer an. |
Statische Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
GLayer.isHidden(layerId:String) |
None |
Gibt true zurück, sofern das Ebenen-Overlay verborgen
ist oder der Karte nicht mit der Methode GMap2.addOverlay()
hinzugefügt wurde. Anderenfalls wird false zurückgegeben. |
Interface "GTileLayer"
Implementieren Sie dieses Interface, um benutzerdefinierte Kartenkachelebenen
bereitzustellen, entweder durch GMapType
oder durch GTileLayerOverlay.
Die Implementierung dieses Interface sollte eine Instanz von GTileLayer
als Prototyp verwenden, da hiermit die Urheberrechtsbehandlung für Sie implementiert
wird.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GTileLayer(copyrights:GCopyrightCollection,
minResolution:Number, maxResolution:Number, options?:GTileLayerOptions)
|
Konstruktor-Argumente können bei Instanzierung als Prototyp weggelassen
werden. Ein Unterklassen-Konstruktor muss diesen Konstruktor mithilfe
von call() aufrufen. Der optionale Parameter options
legt eine Reihe von GTileLayerOptions,
die in Form eines Objektliteralsübergeben werden sollten. |
Methoden
Diese Methoden werden von der Karte und dem Kartentyp aufgerufen, an die die Kachelebeneübergeben wird. Sie müssen die als abstrakt markierten Methoden implementieren, wenn Sie eine benutzerdefinierte Kachelebene implementieren.
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
minResolution() |
Number |
Gibt die niedrigste Zoomstufe dieser Kachelebene an den Kartentyp zurück. |
maxResolution() |
Number |
Gibt die höchste Zoomstufe dieser Kachelebene an den Kartentyp zurück. |
getTileUrl(tile:GPoint, zoom:Number) |
String |
Abstrakt. Gibt die URL der Kartenkachel mit den durch die
Eigenschaften x und y des GPoint
angegebenen Kachelindizes auf der gegebenen Zoomstufe an die Karte zurück. |
isPng() |
Boolean |
Abstrakt. Gibt die Information an die Karte zurück, ob die Kacheln im PNG-Bildformat vorliegen und somit transparent sein können. Ansonsten wird vom GIF-Format ausgegangen. |
getOpacity() |
Number |
Abstrakt. Gibt die Deckkraft, mit der diese Kachelebene angezeigt werden soll, an die Karte zurück. 1.0 ist undurchsichtig, 0.0 ist transparent. |
getCopyright(bounds:GLatLngBounds, zoom:Number)
|
String |
Abstrakt. Gibt die Urheberrechtsmeldungen für diese Kachelebene
an die Karte zurück, die für die gegebene Kartenregion auf der gegebenen
Zoomstufe gelten. Hiermit wird die Urheberrechtsmeldung von GMapType
generiert, zu dem diese Kachelebene gehört.
(Seit 2,89) |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
newcopyright(copyright:GCopyright) |
Dieses Ereignis wird ausgelöst, wenn ein neuer Urheberrechtsvermerk zur Urheberrechtssammlung dieser Kachelebene hinzugefügt wird. |
Klasse "GTileLayerOverlay"
Ein GTileLayerOverlay erweitert
die Karte mit GTileLayer. Die Klasse
implementiert das Interface GOverlay
und wird auf diese Weise mithilfe der GMap2.addOverlay()-Methode
zur Karte hinzugefügt. GTileLayer wird
zuoberst auf dem vorhandenen Kartenbildmaterial angezeigt. Zum Ersetzen der
Bilder verwenden Sie stattdessen GTileLayer
in einem benutzerdefinierten GMapType.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GTileLayerOverlay(tileLayer:GTileLayer, opts?:GTileLayerOverlayOptions)
|
Erstellt ein GOverlay, das die
tileLayer umfasst.
(Seit 2,61) |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
hide() |
None |
Blendet dieses Overlay aus, sodass es nicht sichtbar ist, behält aber
die Position im Overlay-Stapel bei.
(Seit 2,71) |
isHidden() |
None |
Gibt true zurück, wenn das Kachelebenen-Overlay verborgen
ist. Anderenfalls wird false zurückgegeben.
(Seit 2,87) |
show() |
None |
Zeigt ein zuvor verborgenes GTileLayerOverlay
an.
(Seit 2,71) |
refresh() |
None |
Lädt alle mit diesem GTileLayerOverlay
verknüpften Kacheln neu.
(Seit 2,132) |
supportsHide() |
None |
Es wird immer true zurückgegeben.
(Seit 2,87) |
getTileLayer() |
None |
Gibt die von diesem Overlay verwendete Kachelebene zurück.
(Seit 2,83) |
Klasse "GCopyrightCollection"
Verwenden Sie diese Klasse, um Urheberrechtsmeldungen, die auf Karten mit benutzerdefiniertem Kartentyp angezeigt werden, zu verwalten. Wenn Sie keine benutzerdefinierten Kartentypen implementieren, benötigen Sie diese Klasse nicht. Eine Urheberrechtssammlung enthält Informationen darüber, welcher Urheberrechtsvermerk für welchen Bereich der Karte auf welcher Zoomstufe angezeigt werden soll. Dies ist besonders wichtig für Kartentypen, die heterogene Daten wie z. B. den Satellitenkartentyp anzeigen.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GCopyrightCollection(prefix?:String) |
Urheberrechtsmeldungen, die von dieser Urheberrechtssammlung erzeugt
wurden, haben ein gemeinsames Präfix, das als Argument angegeben wird. Example: "Bilder (C) 2006" |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
addCopyright(copyright:GCopyright) |
None |
Fügt ein Urheberrechtsinformationsobjekt zur Sammlung hinzu. |
getCopyrights(bounds:GLatLngBounds, zoom:Number)
|
String[] |
Gibt alle Urheberrechts-Strings zurück, die dem Kartenbereich bei
der angegebenen Zoomstufe entsprechen. Example: [ "Google", "Keyhole" ] |
getCopyrightNotice(bounds:GLatLngBounds,
zoom:Number) |
String |
Gibt das Präfix und alle relevanten Urheberrechts-Strings zurück, die
dem Kartenbereich bei der angegebenen Zoomstufe entsprechen. Example: "Bilder (C) 2006 Google, Keyhole" |
Ereignisse
| Ereignis | Beschreibung |
|---|---|
newcopyright(copyright:GCopyright) |
Dieses Ereignis wird ausgelöst, wenn ein neuer Urheberrechtsvermerk zu dieser Urheberrechtssammlung hinzugefügt wurde. |
Klasse "GCopyright"
Ein Urheberrechtsobjekt enthält Informationen darüber, welche Urheberrechtsmeldung auf einen rechteckigen Bereich der Karte bei einer angegebenen Zoomstufe zur Anwendung kommt. Sie benötigen dieses Objekt nur, wenn Sie benutzerdefinierte Kartentypen oder Kachelebenen implementieren.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GCopyright(id:Number, bounds:GLatLngBounds,
minZoom:Number, text:String) |
Erstellt ein Urheberrechtsinformationsobjekt mit den angegebenen Eigenschaften. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
id |
Number |
Ein eindeutiger Identifikator für diese Urheberrechtsinformation. |
minZoom |
Number |
Die niedrigste Zoomstufe, bei der diese Information angewendet wird. |
bounds |
GLatLngBounds |
Der Bereich, auf den diese Information angewendet wird. |
text |
String |
Der Text der Urheberrechtsmeldung. |
Interface "GProjection"
Dies ist das Interface für Kartenprojektionen. Eine Kartenprojektionsinstanz
wird an den Konstruktor von GMapTypeübergeben. Dieses Interface wird von der class GMercatorProjection
implementiert, die von allen vordefinierten Kartentypen verwendet wird. Sie
können dieses Interface implementieren, wenn Sie Kartentypen mit unterschiedlichen
Kartenprojektionen definieren möchten.
Methoden
Diese Methoden werden von der Karte aufgerufen. Sie müssen sie implementieren.
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng, zoom:Number)
|
GPoint |
Gibt die Kartenkoordinaten für den Punkt an den angegebenen geografischen Koordinaten und der angegebenen Zoomstufe in Pixel zurück. |
fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)
|
GLatLng |
Gibt die geografischen Koordinaten für den Punkt an den angegebenen
Kartenkoordinaten und der angegebenen Zoomstufe in Pixel zurück. Das Flag
unbounded bewirkt, dass die Koordinate für die geografische
Länge nicht eingepasst wird, wenn sie auäßerhalb von -180 bzw. 180 Grad
liegt. |
tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)
|
Boolean |
Gibt an die Karte zurück, ob der Kachelindex in einem gültigen Bereich
für den Kartentyp liegt. Ansonsten zeigt die Karte eine leere Kachel an.
Auäßerdem kann, sofern die Karte mehrere Kopien der Erde und somit dieselbe
Kachel an unterschiedlichen Kachelkoordinaten enthält, der tile-Index
so geändert werden, dass er auf eine andere Instanz derselben Kachel verweist. |
getWrapWidth(zoom:Number) |
Number |
Gibt die Periodizität in x-Richtung an die Karte zurück, d. h. die Zahl
der Pixel, nach der sich die Karte wiederholt, weil sie die Erde einmal
umspannt hat. Standardmäßig wird Infinity zurückgegeben,
d. h., die Karte wiederholt sich nicht. Dies wird von der Karte verwendet,
um die Platzierung von Overlays auf Kartenansichten zu berechnen, die
mehr als eine Kopie der Erde enthalten (dies geschiehtüblicherweise nur
auf niedrigen Zoomstufen).
(Seit 2,46) |
Klasse "GMercatorProjection"
Diese Implementierung der Schnittstelle GProjection
für die Mercator-Projektion wird von allen vordefinierten Kartentypen verwendet.
Konstruktor
| Konstruktor | Beschreibung |
|---|---|
GMercatorProjection(zoomlevels:Number) |
Erstellt eine Mercator-Projektion für die angegebene Anzahl der Zoomstufen. |
Methoden
| Methode | Rückgabewert | Beschreibung |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng, zoom:Number)
|
GPoint |
Siehe GProjection. |
fromPixelToLatLng(pixel:GPoint, zoom:Number, unbounded?:Boolean)
|
GLatLng |
Siehe GProjection. |
tileCheckRange(tile:GPoint, zoom:Number, tilesize:Number)
|
None |
Siehe GProjection. |
getWrapWidth(zoom:Number) |
None |
Siehe GProjection. Die Mercator-Projektion
ist in Längengradrichtung regelmäßig, daher wird hiermit die Breite der
Karte der gesamten Erde auf der angegebenen Zoomstufe in Pixel zurückgegeben.
(Seit 2,46) |



