Los mismos mapas de excelente calidad, además de un acuerdo de servicio, asistencia y control sobre los anuncios.
Ahora el API de Google Maps está integrado en el cargador del API AJAX de Google, que permite crear un espacio de nombre común para cargar y utilizar varias API AJAX de Google. Este marco de trabajo te permite utilizar el espacio de nombres opcional google.maps.* en todas las clases, todos los métodos y todas las propiedades que estés utilizando en el API de Google Maps, sustituyendo el prefijo normal G por este espacio de nombres. No te preocupes: el espacio de nombres actual, G, seguirá siendo compatible.
Por ejemplo, el objeto GMap2 del API de Google Maps se podría definir también como google.maps.Map2.
Ten presente que esta documentación hace referencia únicamente al espacio de nombres existente G.
Aunque sólo quieras utilizar el mapa para que muestre tu contenido, deberás estar al tanto de cómo funcionan estas clases, tipos y funciones:
Si quieres ampliar las funciones de los mapas del API aplicando tus propios controles, superposiciones o tipos de mapas, también tienes que conocer estas clases y estos tipos:
Crea una instancia de la clase GMap2 para poder crear un mapa. Ésta es la clase central del API. Todo lo demás es auxiliar.
| Constructor | Descripción |
|---|---|
GMap2(container:Node,
opts?:GMapOptions)
|
Crea un mapa nuevo dentro del contenedor HTML en cuestión, que generalmente suele ser un elemento DIV. Si en el argumento opcional opts.mapTypes no se indica ningún tipo de mapa, se utiliza el predeterminado, G_DEFAULT_MAP_TYPES. Si no se indica ningún tamaño en el argumento opcional opts.size, se utiliza el tamaño de container. Si se especifica opts.size, el elemento contenedor del mapa cambiará de tamaño consecuentemente. Consulta class GMapOptions. Nota: a Map needs to be centered before it can be used. Se debe ejecutar GMap2.setCenter() inmediatamente para inicializar un mapa creado con este constructor.
|
| Método | Valor devuelto | Descripción |
|---|---|---|
enableDragging()
|
None |
Permite arrastrar el mapa (activado de forma predeterminada). |
disableDragging()
|
None |
Desactiva la posibilidad de arrastrar el mapa. |
draggingEnabled()
|
Boolean |
Devuelve true si está habilitada la posibilidad de arrastrar el mapa. |
enableInfoWindow()
|
None |
Activa el uso de ventanas de información en el mapa (activado de forma predeterminada). |
disableInfoWindow()
|
None |
Cierra la ventana de información, si está abierta, y desactiva la apertura de más ventanas de información. |
infoWindowEnabled()
|
Boolean |
Devuelve true si la ventana de información está habilitada. |
enableDoubleClickZoom()
|
None |
Habilita el doble clic para acercar y alejar la imagen (habilitado de forma predeterminada). (A partir de la versión 2,58). |
disableDoubleClickZoom()
|
None |
Desactiva la posibilidad de hacer doble clic para acercar o alejar la imagen. (A partir de la versión 2,58). |
doubleClickZoomEnabled()
|
Boolean |
Devuelve true si está habilitada la posibilidad de acercar o alejar la imagen.(A partir de la versión 2,58). |
enableContinuousZoom()
|
None |
Permite acercar y alejar la imagen de forma continua y gradual en navegadores capacitados para ello (desactivado de forma predeterminada). (A partir de la versión 2,58). |
disableContinuousZoom()
|
None |
Desactiva la posibilidad de acercar y alejar la imagen de forma continua y gradual. (A partir de la versión 2,58). |
continuousZoomEnabled()
|
Boolean |
Devuelve true si está habilitada la posibilidad de acercar y alejar la imagen de forma continua y gradual.(A partir de la versión 2,58). |
enableGoogleBar()
|
None |
Habilita GoogleBar, un control de búsqueda integrado, en el mapa. Si se habilita, este control ocupará el lugar del logotipo Con la tecnología de Google. Este control no está activado de forma predeterminada. (A partir de la versión 2,92). |
disableGoogleBar()
|
None |
Inhabilita el control de búsqueda integrado de la barra Google. Si se inhabilita, el logotipo Con la tecnología de Google predeterminado ocupará la posición anterior de este control. Este control ya está desactivado de forma predeterminada. (A partir de la versión 2,92). |
enableScrollWheelZoom()
|
None |
Permite acercar y alejar la imagen con una rueda de desplazamiento del ratón. Nota: la posibilidad de acercar y alejar la imagen con la rueda de desplazamiento está desactivada de forma predeterminada. (A partir de la versión 2,78). |
disableScrollWheelZoom()
|
None |
No permite acercar y alejar la imagen con la rueda de desplazamiento del ratón. Nota: la posibilidad de acercar y alejar la imagen con la rueda de desplazamiento está desactivada de forma predeterminada. (A partir de la versión 2,78). |
scrollWheelZoomEnabled()
|
Boolean |
Devuelve un valor booleano que indica si está habilitada la opción de acercar o alejar la imagen. (A partir de la versión 2,78). |
| Método | Valor devuelto | Descripción |
|---|---|---|
addControl(control:GControl,
position?:GControlPosition)
|
None |
Añade el control al mapa. La posición en el mapa viene determinada por el argumento opcional position. Si este argumento no está presente, se aplica la posición predeterminada del control, según determine el método GControl.getDefaultPosition(). No se debe agregar más de una instancia del control al mapa. |
removeControl(control:GControl)
|
None |
Elimina el control del mapa. Si no se ha agregado nunca el control al mapa, no hace nada. |
getContainer()
|
Node |
Devuelve el objeto DOM que contiene el mapa. Utilizada por el método GControl.initialize(). |
| Método | Valor devuelto | Descripción |
|---|---|---|
getMapTypes()
|
GMapType[] |
Devuelve la matriz de tipos de mapa que haya registrada con el mapa. |
getCurrentMapType()
|
GMapType |
Devuelve el tipo de mapa que haya seleccionado en ese momento. |
setMapType(type:GMapType)
|
None |
Selecciona el nuevo tipo de mapa en cuestión. El tipo ha de ser conocido para el mapa. Consulta el constructor y el método addMapType(). |
addMapType(type:GMapType)
|
None |
Añade un tipo de mapa nuevo al mapa. Consulta la sección GMapType para ver cómo se definen los tipos de mapa personalizados. |
removeMapType(type:GMapType)
|
None |
Elimina el tipo de mapa del mapa. Actualizará el conjunto de botones que muestran GMapTypeControl oGHierarchicalMapTypeControl y activa el evento removemaptype. |
| Método | Valor devuelto | Descripción |
|---|---|---|
isLoaded()
|
Boolean |
Devuelve true si setCenter() inicializó el mapa desde el momento en que se creó. |
getCenter()
|
GLatLng |
Devuelve las coordenadas geográficas del punto central de la vista del mapa. |
getBounds()
|
GLatLngBounds |
Devuelve la región rectangular visible de la vista del mapa en coordenadas geográficas. |
getBoundsZoomLevel(bounds:GLatLngBounds)
|
Number |
Devuelve el nivel de acercamiento en el que una región rectangular concreta se ajusta a la vista del mapa. El nivel de acercamiento se calcula según el tipo de mapa seleccionado en ese momento. Si no se ha seleccionado ningún tipo de mapa, se utiliza el primero que aparezca en la matriz de tipos de mapa. |
getSize()
|
GSize |
Devuelve el tamaño de la vista del mapa en píxeles. |
getZoom()
|
Number |
Devuelve el nivel de acercamiento en uso. |
getDragObject()
|
GDraggableObject |
Devuelve el objeto arrastrable que utiliza el mapa. (A partir de la versión 2,93). |
getEarthInstance(callback:Function(instance: GEPlugin))
|
None |
Recupera la instancia del complemento de navegación de Google Earth adjunto a este mapa y ejecuta la función de devolución de llamada transmitida una vez que la instancia está lista para recibir comandos, transmitiendo la instancia de Google Earth (un objeto GEPlugin) como un parámetro. Esta función de devolución de llamada se puede activar inmediatamente si se ha creado anteriormente la instancia de Google Earth mediante el establecimiento del tipo de mapa de Google Earth a través de GMap2.setMapType(G_SATELLITE_3D_MAP). Si la instancia no se ha creado aún, al ejecutar getEarthInstance se inicializará el complemento de Google Earth. (Este comportamiento asíncrono es la razón por la que este método precisa una devolución de llamada). Nota: si se produce un error durante la inicialización, la función de devolución de llamada transmitirá un parámetro null. Ten en cuenta que aunque este método creará una instancia de Google Earth, no establecerá el tipo de mapa de Google Earth como la vista actual. Para hacerlo, ejecuta GMap2.setMapType(G_SATELLITE_3D_MAP) específicamente o permite que el usuario seleccione este tipo de mapa a través de MapTypeControl. Consulta la Guía del desarrollador de Google Earth para obtener información detallada sobre cómo utilizar el objeto GEPlugin.(A partir de la versión 2,113). |
| Método | Valor devuelto | Descripción |
|---|---|---|
setCenter(center:GLatLng,
zoom?:Number,
type?:GMapType)
|
None |
Define la vista del mapa de acuerdo al centro especificado. También define opcionalmente el nivel de acercamiento y el tipo de mapa. El tipo de mapa ha de ser conocido para el mapa. Consulta el constructor y el método addMapType(). Este debe ser el primer método que se llame después del constructor del mapa, para definir su estado inicial. No se deben ejecutar operaciones en un objeto GMap2 recién creado hasta que no se ejecute esta función.
|
panTo(center:GLatLng)
|
None |
Cambia el punto central del mapa al punto que se indique. Si este punto ya puede verse en la vista del mapa en uso, cambie el centro con una animación progresiva. |
panBy(distance:GSize)
|
None |
Inicia una animación panorámica según la distancia en píxeles indicada. |
panDirection(dx:one of -1 0 +1,
dy:one of -1 0 +1)
|
None |
Inicia una animación de vista panorámica con la mitad del ancho del mapa en las direcciones indicadas. +1 indica hacia la derecha y hacia abajo y -1 indica hacia la izquierda y hacia arriba, respectivamente. |
setZoom(level:Number)
|
None |
Define el nivel de acercamiento para el nuevo valor que se proporcione. |
zoomIn()
|
None |
Aumenta el nivel de acercamiento en uno. |
zoomOut()
|
None |
Reduce el nivel de acercamiento en uno. |
savePosition()
|
None |
Almacena la posición del mapa y el nivel de acercamiento en ese momento para volver a llamarlo posteriormente con returnToSavedPosition(). |
returnToSavedPosition()
|
None |
Restaura la vista de mapa guardada por savePosition(). |
checkResize()
|
None |
Notifica al mapa si se ha producido un cambio en el tamaño de su contenedor. Llama a este método cuando el tamaño del objeto DOM del contenedor cambie, de modo que el mapa se pueda ajustar a sí mismo según el nuevo tamaño. |
| Método | Valor devuelto | Descripción |
|---|---|---|
addOverlay(overlay:GOverlay)
|
None |
Añade una superposición al mapa y activa el evento addoverlay. |
removeOverlay(overlay:GOverlay)
|
None |
Elimina la superposición del mapa. No se debe intentar eliminar una superposición que no está en el mapa. Si la llamada se realiza correctamente, se activará el evento removeoverlay. |
clearOverlays()
|
None |
Elimina todas las superposiciones del mapa y activa el evento clearoverlays. |
getPane(pane:GMapPane)
|
Node |
Devuelve un elemento DIV que mantiene el objeto en la capa que identifica pane. Lo utilizan las instancias de GOverlay en el método GOverlay.initialize() para dibujarse a sí mismas en el mapa. |
| Método | Valor devuelto | Descripción |
|---|---|---|
openInfoWindow(latlng:GLatLng,
node:Node,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información sencilla en el punto que se indique. Traslada el mapa de forma que la ventana de información que se abra quede totalmente visible. El contenido de la ventana de información se indica como nodo DOM. |
openInfoWindowHtml(latlng:GLatLng,
html:String,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información sencilla en el punto que se indique. Traslada el mapa de forma que la ventana de información que se abra quede totalmente visible. El contenido de la ventana de información se indica como texto HTML. |
openInfoWindowTabs(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GinfoWindowOptions)
|
None |
Abre una ventana de información con pestañas en el punto que se indique. Traslada el mapa de forma que la ventana de información que se abra quede totalmente visible. El contenido de la ventana de información se indica como nodos DOM. |
openInfoWindowTabsHtml(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información con pestañas en el punto que se indique. Traslada el mapa de forma que la ventana de información que se abra quede totalmente visible. El contenido de la ventana de información se indica como texto HTML. |
showMapBlowup(latlng:GLatLng,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información en el punto que se indique que contiene una vista ampliada del mapa alrededor de este punto. |
updateInfoWindow(tabs:GInfoWindowTab[],
onupdate?:Function)
|
None |
Actualiza el contenido del objeto GInfoWindowabierto en ese momento, sin cambiarlo de posición. El tamaño de la ventana de información se cambia para ajustarse al nuevo contenido. Cuando cambie el contenido de la ventana de información, se llama a la función de devolución de llamada opcional onupdate.
(A partir de la versión 2,85). |
updateCurrentTab(modifier:Function,
onupdate?:Function)
|
None |
Actualiza la pestaña seleccionada en ese momento haciendo que cambie el tamaño del objeto GInfoWindow y sin cambiarlo de posición. La función modifier se utiliza para modificar la pestaña seleccionada en ese momento, pasándosele GInfoWindowTab como argumento. Cuando la ventana de información muestre el nuevo contenido, se llama a la función de devolución de llamada opcional onupdate.(A partir de la versión 2,85). |
closeInfoWindow()
|
None |
Cierra la ventana de información que haya abierta. |
getInfoWindow()
|
GInfoWindow |
Devuelve el objeto de ventana de información del mapa. Si no hay aún ninguna ventana de información, se crea, pero no se muestra. Esta operación no se ve afectada por enableInfoWindow(). |
| Método | Valor devuelto | Descripción |
|---|---|---|
fromContainerPixelToLatLng(pixel:GPoint)
|
GLatLng |
Calcula las coordenadas geográficas del punto en las coordenadas de píxeles indicadas en el elemento DOM que incluye el mapa en la página. Esto resulta útil a la hora de implementar la interacción de controles personalizados con el mapa. |
fromLatLngToContainerPixel(latlng:GLatLng)
|
GPoint |
Calcula las coordenadas en píxeles de un punto geográfico concreto en el elemento DOM que incluye el mapa en la página.
(A partir de la versión 2,100). |
fromLatLngToDivPixel(latlng:GLatLng)
|
GPoint |
Calcula las coordenadas en píxeles de un punto geográfico concreto en el elemento DOM que incluye el mapa arrastrable. Este método es necesario para colocar una superposición personalizada al implementar el método GOverlay.redraw() para una superposición personalizada. |
fromDivPixelToLatLng(pixel:GPoint)
|
GLatLng |
Calcula las coordenadas geográficas a partir de coordenadas de píxeles en el elemento DIV que incluye el mapa arrastrable. Puede ser útil a la hora de implementar interacción con superposiciones personalizadas que no amplían la interfaz GOverlay. Si no produce los resultados esperados, prueba con el método fromContainerPixelToLatLng. |
| Evento | Descripción |
|---|---|
addmaptype(type:GMapType)
|
Este evento se activa cuando se agrega un tipo de mapa al mapa. |
removemaptype(type:GMapType)
|
Este evento se activa cuando se elimina un tipo de mapa del mapa. |
click(overlay:GOverlay,
latlng:GLatLng,
overlaylatlng:GLatLng)
|
Este evento se activa cuando el usuario hace clic en el mapa con el ratón. Un evento click transmite distintos argumentos en función del contexto en el que se ha hecho clic y de si se ha hecho clic en una superposición habilitada para clic. Si se ha hecho clic en una superposición habilitada para clic, el argumento overlay será null y el argumento latlng contendrá las coordenadas geográficas del punto en el que se ha hecho clic. Si el usuario hace clic en una superposición clickable (como GMarker, GPolygon, GPolyline o GInfoWindow), el argumento overlay contendrá el objeto de la superposición, mientras que el argumento overlaylatlng contendrá las coordenadas de la superposición en la que se ha hecho clic. Además, también se activará un evento click en la misma superposición.
|
dblclick(overlay:GOverlay,
latlng:GLatLng)
|
Este evento se activa cuando se hace doble clic en el mapa. Ten en cuenta que este evento no se activará si el doble clic se hace en un marcador o en otra superposición en la que se puede hacer clic. Se pasan las coordenadas geográficas del punto en el que se hace doble clic en el argumento latlng. El argumento overlay siempre está definido en null.
(A partir de la versión 2,83). |
singlerightclick(point:GPoint,
src:Element,
overlay?:GOverlay)
|
Este evento se activa cuando el evento DOM contextmenu se activa en el contenedor de mapa. Si has hecho clic con el botón derecho del ratón en un marcador o en otra superposición en la que se pueda hacer clic, la superposición se pasa al gestor de eventos en el argumento overlay. Las coordenadas de píxeles (en el elemento DOM que incluye al mapa) del punto en el que se hizo clic con el botón derecho y el elemento de origen del evento DOM se pasan en los argumentos point y srcrespectivamente. Ten en cuenta que si se hace doble clic con el botón derecho del ratón y está activada la posibilidad de hacer doble clic para acercar y alejar la imagen, lo que sucederá será que la imagen del mapa se alejará y no se activará el evento singlerightclick. Si, no obstante, está deshabilitada la posibilidad de hacer doble clic para acercar o alejar la imagen, se activarán dos eventos singlerightclick.(A partir de la versión 2,84). |
movestart()
|
Este evento se activa cuando la vista del mapa empieza a cambiar. Esto puede producirse porque se esté arrastrando el mapa, en cuyo caso se activa también un evento dragstart, o porque se invoque a un método que cambie la vista del mapa. |
move()
|
Este evento se activa cuando la vista del mapa empieza a cambiar. |
moveend()
|
Este evento se activa cuando termina de cambiar la vista del mapa. |
zoomend(oldLevel:Number,
newLevel:Number)
|
Este evento se activa cuando se aplica un nivel de acercamiento nuevo en el mapa. El gestor de eventos recibe los niveles de acercamiento anterior y nuevo como argumentos. |
maptypechanged()
|
Este evento se activa cuando se selecciona otro tipo de mapa. |
infowindowopen()
|
Este evento se activa cuando se abre la ventana de información. |
infowindowbeforeclose()
|
Este evento se activa antes de que se cierre la ventana de información. (A partir de la versión 2,83). |
infowindowclose()
|
Este evento se activa cuando se cierra la ventana de información. El evento infowindowbeforeclose se activa antes que este evento. Si se vuelve a abrir en un punto diferente una ventana de información que esté abierta en esos momentos mediante otra llamada a openInfoWindow*(), se activan los eventos infowindowbeforeclose, infowindowclosey infowindowopen, en este orden. |
addoverlay(overlay:GOverlay)
|
Este evento se activa cuando se agrega una única superposición al mapa mediante el método addOverlay(). La nueva superposición se pasa como argumento overlay al gestor de eventos. |
removeoverlay(overlay:GOverlay)
|
Este evento se activa cuando se elimina una única superposición mediante el método removeOverlay(). La superposición eliminada se pasa como argumento overlay al gestor de eventos. |
clearoverlays()
|
Este evento se activa cuando se eliminan de una vez todas las superposiciones mediante el método clearOverlays(). |
mouseover(latlng:GLatLng)
|
Este evento se activa cuando el usuario mueve el ratón sobre el mapa desde fuera del mapa. |
mouseout(latlng:GLatLng)
|
Este evento se activa cuando el usuario mueve el ratón fuera del mapa. |
mousemove(latlng:GLatLng)
|
Este evento se activa cuando el usuario mueve el ratón dentro del mapa. |
dragstart()
|
Este evento se activa cuando el usuario empieza a arrastrar el mapa. |
drag()
|
Este evento se activa repetidamente mientras el usuario arrastra el mapa. |
dragend()
|
Este evento se activa cuando el usuario termina de arrastrar el mapa. |
load()
|
Este evento se activa cuando se termina de configurar el mapa, e isLoaded() devolvería true. Esto significa que se inicializarán la posición, el acercamiento y el tipo de mapa, pero puede que sigan cargándose las imágenes de mosaico.(A partir de la versión 2,52). |
Esta clase representa argumentos opcionales para el constructor de GMap2. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
size
|
GSize |
Define el tamaño del mapa en píxeles. El tamaño del contenedor que se pasa al constructor del mapa se cambiará de acuerdo con el tamaño que se indique. De forma predeterminada, el mapa asumirá el tamaño de su contenedor. |
mapTypes
|
GMapType[] |
Matriz de tipos de mapa que debe usar el mapa. De forma predeterminada, se utiliza, G_DEFAULT_MAP_TYPES. Puedes emplear esta opción para restringir el conjunto de tipos de mapas predeterminados que aparecen en el mapa, o pasar tus propios tipos de mapas al mapa. Consulta también GMap2.addMapType(). |
draggableCursor
|
String |
El cursor que se muestra cuando el mapa sea arrastrable. (A partir de la versión 2,59). |
draggingCursor
|
String |
El cursor que se debe mostrar mientras se está arrastrando el mapa. (A partir de la versión 2,59). |
googleBarOptions
|
GGoogleBarOptions |
Esta propiedad especifica las opciones para configurar el control de búsqueda GGoogleBar. Estas opciones se pasan al objeto literal GMapOptions cuando se construye el mapa y sirven para construir el control local GGoogleBar cuando se llama a GMap2.enableGoogleBar().(A partir de la versión 2,95). |
backgroundColor
|
String |
Esta propiedad especifica el color que se mostrará detrás de los mosaicos de mapas. El color puede ser cualquier valor de color estándar W3C. (A partir de la versión 2,119). |
Esta clase representa opciones que se han pasado dentro del parámetro googleBarOptions al objeto GMapOptions. Aunque no tiene constructor, se crea instancia como un objeto literal. Ten en cuenta que el objeto GGoogleBar, al igual que GInfoWindow, no se crea, sino que se adjunta automáticamente al objeto de mapa y se habilita a través de las propiedades descritas aquí.
| Propiedad | Tipo | Descripción |
|---|---|---|
showOnLoad
|
Boolean |
Cuando se define como verdadero ( true ), esta propiedad muestra el cuadro de búsqueda dentro de GoogleBar (siempre y cuando el control esté activado y el mapa esté cargado). De forma predeterminada, el cuadro de búsqueda dentro del control permanece oculto y sólo se amplía al hacer clic en la lupa del control.(A partir de la versión 2,95). |
linkTarget
|
GGoogleBarLinkTarget |
Esta propiedad te permite especificar el destino de los enlaces incrustados dentro de los resultados de búsqueda de GoogleBar. El valor predeterminado, G_GOOGLEBAR_LINK_TARGET_BLANK, especifica que los enlaces se abrirán dentro de una ventana aparte.(A partir de la versión 2,95). |
resultList
|
GGoogleBarResultList or Element |
Esta propiedad te permite especificar el estilo de la lista de resultados de búsqueda para GoogleBar, que puede corresponder a uno de los siguientes: G_GOOGLEBAR_RESULT_LIST_INLINE (default) places the result list in a table above the search box, G_GOOGLEBAR_RESULT_LIST_SUPPRESS replaces the list with a set of next/previous buttons, and passing a block-level DOM Element places the list within a container of your choice (typically a <div> element).(A partir de la versión 2,95). |
suppressInitialResultSelection
|
Boolean |
Esta propiedad hace que no se vea el primer resultado dentro de su propia ventana de información cuando se termina una búsqueda en GoogleBar (éste es el comportamiento predeterminado).(A partir de la versión 2,95). |
suppressZoomToBounds
|
Boolean |
Esta propiedad suprime la ampliación y el desplazamiento automáticos hacia los resultados tras terminar una búsqueda en GoogleBar. Esta propiedad suprime el comportamiento predeterminado.(A partir de la versión 2,95). |
onIdleCallback
|
Function |
Esta propiedad especifica una función de devolución de llamada que se ha de invocar cuando GoogleBar termine de buscar y se cierren los resultados de la búsqueda.(A partir de la versión 2,95). |
onSearchCompleteCallback
|
Function |
Esta propiedad especifica una función de devolución de llamada que se ha de invocar cuando GoogleBar termine de buscar y se termine la búsqueda. Se transmite el objeto GlocalSearch asociado al control de búsqueda. A esta función de devolución de llamada se le llama antes de que se coloquen los resultados en el mapa o en la lista de resultados.(A partir de la versión 2,95). |
onGenerateMarkerHtmlCallback
|
Function |
Esta propiedad te permite especificar una función de devolución de llamada que ha de invocarse cuando se abra la ventana de información para un marcador de resultados de búsqueda. A esta función debe pasársele un marcador GMarker, una cadena HTML generada y un valor GlocalSearchResult (en ese mismo orden), y debe devolver la cadena HTML modificada que ha de mostrarse en la ventana de información.(A partir de la versión 2,95). |
onMarkersSetCallback
|
Function |
Esta propiedad te permite especificar una función de devolución de llamada que se debe invocar cuando GGoogleBar termine de crear sus marcadores y los coloque en el mapa. A esta función debe pasársele una matriz de objetos de la forma {result: GlocalSearch, marker: GMarker}.(A partir de la versión 2,95). |
Estas constantes restringen el tipo de resultados obtenidos con las búsquedas locales realizadas con GGoogleBar. Este comportamiento de las búsquedas se establece en la propiedad GGoogleBarOptions.listingTypes.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_TYPE_BLENDED_RESULTS
|
Esta constante indica que las búsquedas realizadas en la barra GGoogleBar del mapa deben devolver todos los tipos de resultados (KML, empresas, códigos geográficos, etc.).(A partir de la versión 2,113). |
G_GOOGLEBAR_TYPE_KMLONLY_RESULTS
|
Esta constante indica que las búsquedas realizadas en la barra GGoogleBar del mapa deben devolver sólo los resultados de los archivos KML/KMZ/GeoRSS indexados.(A partir de la versión 2,113). |
G_GOOGLEBAR_TYPE_LOCALONLY_RESULTS
|
Esta constante indica que las búsquedas realizadas en la barra GGoogleBar del mapa deben devolver sólo los resultados de empresas y códigos geográficos.(A partir de la versión 2,113). |
Estas constantes se pasan en GGoogleBarOptions.linkTarget y definen el destino predeterminado para los enlaces en ventanas de información.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_LINK_TARGET_BLANK
|
Se corresponde al destino = "_blank". |
G_GOOGLEBAR_LINK_TARGET_PARENT
|
Se corresponde al destino = "_parent". |
G_GOOGLEBAR_LINK_TARGET_SELF
|
Se corresponde al destino = "_self". |
G_GOOGLEBAR_LINK_TARGET_TOP
|
Se corresponde al destino = "_top". |
Estas constantes se pasan en GGoogleBarOptions.resultList y definen cómo se muestra la lista de resultados.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_RESULT_LIST_INLINE
|
Éste es el estilo predeterminado, según el cual la lista de resultados se muestra en forma de tabla en el mapa. |
G_GOOGLEBAR_RESULT_LIST_SUPPRESS
|
Se corresponde al estilo predeterminado, donde la lista de resultados está oculta y se sustituye por los botones siguiente/anterior. |
Estas constantes definen el orden de pila (orden Z) utilizado por el mapa y por los objetos del mapa con fines de visualización. Cada panel define un conjunto de objetos de visualización similar que incluir en el mapa y cada panel define un orden Z único en el mapa. Los panales con un orden z superior se muestran "superpuestos" a otros paneles con un orden Z inferior. (Ten en cuenta que los objetos incluidos en un determinado panel también pueden mostrar su propio orden Z; algunos objetos pueden aparecer superpuestos a otros objetos dentro del mismo panel).
Es necesario utilizar constantes si se establecen subclases de GOverlay para poder colocar una superposición personalizada en uno de los paneles.
Las siguientes constantes aparecen ordenadas desde el orden z más bajo (inferior) hasta el más alto (superior).
| Constante | Descripción |
|---|---|
G_MAP_MAP_PANE
|
Este panel es el panel inferior y se encuentra justo encima de los mosaicos. |
G_MAP_OVERLAY_LAYER_PANE
|
Este panel contiene polilíneas, polígonos, superposiciones de suelo y superposiciones de capa de mosaico.
(A partir de la versión 2,127). |
G_MAP_MARKER_SHADOW_PANE
|
Este panel contiene el sombreado del marcador. |
G_MAP_MARKER_PANE
|
Este panel contiene las imágenes en primer plano del marcador. |
G_MAP_FLOAT_SHADOW_PANE
|
Este panel contiene el sombreado de la ventana de información. y queda por encima de G_MAP_MARKER_PANE, de modo de que los marcadores puedan quedar en la sombra de las ventanas de información. |
G_MAP_MARKER_MOUSE_TARGET_PANE
|
Este panel contiene elementos transparentes que reciben eventos de ratón DOM para los marcadores y queda por encima de G_MAP_FLOAT_SHADOW_PANE, de modo que se pueda hacer clic en los marcadores en la sombra de las ventanas de información. |
G_MAP_FLOAT_PANE
|
Este panel contiene la ventana de información Se sitúa sobre todas las superposiciones del mapa. |
Crea una instancia de esta clase para agregar enlaces de teclado a un mapa. Los enlaces clave son los mismos que los de la aplicación de mapas.
| Teclas | Acción |
|---|---|
| Arriba, abajo, izquierda y derecha | Mueve el mapa de forma continua mientras se pulsa la tecla. Se pueden pulsar dos teclas simultáneamente para mover el mapa en diagonal. |
| AvPág, RePág, Inicio y Fin | Desplaza el mapa 3/4 partes de su tamaño en la dirección correspondiente con una suave animación. Este movimiento corresponde a los botones de flecha en GLargeMapControl y GSmallMapControl. |
| +, - | Acerca o aleja la imagen un nivel respectivamente. Se corresponde con el signo +. y los botones de GLargeMapControl y GSmallMapControl. |
| Constructor | Descripción |
|---|---|
GKeyboardHandler(map:GMap2)
|
Instala el gestor de eventos del teclado para el mapa que se ha pasado como argumento. |
Esta interfaz se implementa mediante las clases GMarker, GPolyline, GTileLayerOverlay y GInfoWindow en bibliotecas del API de Google Maps. Puedes implementarla si quieres mostrar tipos personalizados de objetos de superposición en el mapa. Se puede poner en el mapa una instancia de GOverlay con el método GMap2.addOverlay(). El mapa llamará entonces al método GOverlay.initialize() en la instancia de la superposición para mostrarse a sí mismo inicialmente en el mapa. Cuando cambie el aspecto del mapa, éste llamará a GOverlay.redraw() para que la superposición se pueda volver a colocar a sí misma, de ser necesario. La instancia de superposición puede utilizar el método GMap2.getPane() para mantener uno o más elementos contenedores DOM a los que adjuntarse.
| Constructor | Descripción |
|---|---|
GOverlay()
|
Este constructor crea implementaciones simuladas de los métodos. Aún así, al heredar de esta clase, tu constructor de clase derivado deberá llamar a este constructor para poder terminar su trabajo. |
| Método | Valor devuelto | Descripción |
|---|---|---|
GOverlay.getZIndex(latitude:Number)
|
Number |
Devuelve un valor z-index de CSS para una latitud determinada. Calcula un índice z de modo que las superposiciones más al sur queden encima de las superposiciones más al norte, creando así el aspecto 3D de las superposiciones de marcador. |
| Método | Valor devuelto | Descripción |
|---|---|---|
initialize(map:GMap2)
|
None |
El mapa lo llama después de agregar la superposición al mapa con GMap2.addOverlay(). El objeto de superposición se puede dibujar a sí mismo en diferentes paneles del mapa que se pueden obtener con GMap2.getPane(). |
remove()
|
None |
El mapa lo llama después de eliminar la superposición del mapa con GMap2.removeOverlay() o GMap2.clearOverlays(). La superposición se debe eliminar a sí misma de los paneles del mapa aquí. |
copy()
|
GOverlay |
Devuelve una copia de sí mismo sin inicializar que se puede agregar al mapa. |
redraw(force:Boolean)
|
None |
Lo llama el mapa cuando cambia su aspecto. El argumento force será true si cambia el nivel de acercamiento o el desplazamiento de píxeles de la vista del mapa, de modo que haya que volver a calcular las coordenadas de píxeles. |
GInfoWindow no tiene constructor. La crea el mapa y se accede a ella a través de su método GMap2.getInfoWindow().
| Método | Valor devuelto | Descripción |
|---|---|---|
selectTab(index:Number)
|
None |
Selecciona la pestaña con el índice indicado. El resultado es igual a hacer clic en la pestaña correspondiente. |
hide()
|
None |
Hace invisible la ventana de información. NOTA: este método no cierra la ventana de información, la cual se puede volver a ver con show(). |
show()
|
None |
Hace visible la ventana de información si no está visible en ese momento. |
isHidden()
|
Boolean |
Devuelve true si la ventana de información está oculta. Aquí se incluye cuando está cerrada. |
reset(latlng:GLatLng,
tabs:GInfoWindowTab[],
size:GSize,
offset?:GSize,
selectedTab?:Number)
|
None |
Restablece el estado de la ventana de información. Los argumentos pueden ser todos null, con lo que su valor no cambiará con respecto al valor en uso. |
getPoint()
|
GLatLng |
Devuelve el punto geográfico en el que se ancla la ventana de información. La punta de la ventana apunta a este punto en el mapa, coeficiente del desplazamiento de píxeles. |
getPixelOffset()
|
GSize |
Devuelve el desplazamiento, en píxeles, de la punta de la ventana de información desde el punto en el mapa en cuyas coordenadas geográficas se haya anclado la ventana de información. |
getSelectedTab()
|
Number |
Devuelve el índice, empezando por 0, de la pestaña seleccionada en ese momento. |
getTabs()
|
GInfoWindowTabs[] |
Devuelve la matriz de las pestañas en la ventana de información. (A partir de la versión 2,59). |
getContentContainers()
|
Node[] |
Devuelve la matriz de nodos DOM que guardan el contenido de las pestañas de la ventana de información. (A partir de la versión 2,59). |
enableMaximize()
|
None |
Permite maximizar la ventana de información. Una ventana de información maximizable se amplía hasta llenar casi la totalidad del mapa con el contenido especificado con las propiedades maxContent y maxTitlede GInfoWindowOptions. La ventana de información debe haberse abierto con las opciones maxContent o maxTitle para que enableMaximize() o disableMaximize puedan surtir efecto. Las ventanas de información que se abran con maxContent o maxTitle tendrán habilitada la posibilidad de maximizarse de forma predeterminada.
(A partir de la versión 2,93). |
disableMaximize()
|
None |
Impide maximizar la ventana de información. La ventana de información debe haberse abierto con las opciones maxContent o maxTitle. Ten en cuenta que, si la ventana de información está abierta en ese momento, esta función eliminará el botón para maximizar la ventana, si bien no la restaurará a su estado minimizado.
(A partir de la versión 2,93). |
maximize()
|
None |
Maximiza la ventana de información. La ventana de información debe haberse abierto con las opciones maxContent o maxTitle y no debe haberse inhabilitado la posibilidad de maximizarse con disableMaximize.
(A partir de la versión 2,93). |
restore()
|
None |
Restaura la ventana de información a su estado predeterminado (sin maximizar). La ventana de información debe haberse abierto con las opciones maxContent o maxTitle.(A partir de la versión 2,93). |
| Evento | Descripción |
|---|---|
closeclick()
|
Este evento se activa cuando se hace clic en el botón para cerrar la ventana de información. |
maximizeclick()
|
Indica que se está a punto de maximizar la ventana de información. (A partir de la versión 2,93). |
maximizeend()
|
Indica que la ventana de información ha terminado de maximizarse. (A partir de la versión 2,93). |
restoreclick()
|
Indica que la ventana de información está a punto de restaurarse al estado sin minimizar. (A partir de la versión 2,93). |
restoreend()
|
Indica que la ventana de información ha terminado de restaurarse al estado sin minimizar.
(A partir de la versión 2,93). |
Se puede transmitir un conjunto de instancias de esta clase como argumento tabs a los métodos GMap2.openInfoWindowTabs(), GMap2.openInfoWindowTabsHtml(), GMarker.openInfoWindowTabs() y GMarker.openInfoWindowTabsHtml() y a la variante GMarker.bindInfoWindow*(). Si la matriz contiene más de un elemento, la ventana de información se mostrará con pestañas. Cada objeto InfoWindowTab incluye dos elementos: content define el contenido de la ventana de información cuando se selecciona la pestaña y label define la etiqueta de la pestaña. Las propiedades se pasan como argumentos al constructor. En los métodos openInfoWindowTabs(), content es un nodo DOM. En los métodos openInfoWindowTabsHtml(), content es una cadena que contiene texto HTML.
| Constructor | Descripción |
|---|---|
GInfoWindowTab(label:String,
content:Node or String)
|
Crea una estructura de datos de pestañas para las ventanas de información que se puede pasar en el argumento tabs a métodos openInfoWindowTabs*(). |
Las instancias de esta clase se utilizan en el argumento opts? para los métodos openInfoWindow(), openInfoWindowHtml(), openInfoWindowTabs(), openInfoWindowTabsHtml() y las variantes bindInfoWindow*() y showMapBlowup() de las clases GMap2 y GMarker. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
selectedTab
|
Number |
Selecciona la pestaña con el índice indicado, empezando por 0, en lugar de la primera pestaña (con índice 0). |
maxWidth
|
Number |
Anchura máxima del contenido de la ventana de información, en píxeles. |
noCloseOnClick
|
Boolean |
Indica si la ventana de información debe cerrarse o no al hacer clic en el mapa en un lugar diferente a un marcador. Si se define en true, la ventana de información no se cierra cuando se hace clic en el mapa. El valor predeterminado es false.
(A partir de la versión 2,83). |
onOpenFn
|
Function |
Se llama a la función después de que se haya abierto la ventana de información y se pueda ver el contenido. |
onCloseFn
|
Function |
Se llama a la función cuando se cierra la ventana de información. |
zoomLevel
|
Number |
Únicamente pertinente para showMapBlowup(). El nivel de acercamiento del mapa ampliado en la ventana de información. |
mapType
|
GMapType |
Únicamente pertinente para showMapBlowup(). El tipo de mapa ampliado en la ventana de información. |
maxContent
|
String |
Especifica que el contenido tiene que verse cuando se maximice la ventana de información. El contenido puede ser una cadena HTML o un elemento DOM HTML.
(A partir de la versión 2,93). |
maxTitle
|
String |
Especifica que el título tiene que verse cuando se maximice la ventana de información. El contenido puede ser una cadena HTML o un elemento DOM HTML.
(A partir de la versión 2,93). |
pixelOffset
|
GSize |
Especifica un número de píxeles en la dirección hacia arriba (x) y hacia la derecha (y) según el cual mover la matriz de la ventana de información con respecto al valor proporcionado para GLatLng.
(A partir de la versión 2,98). |
GMarker marca una posición en el mapa. Implementa la interfaz de GOverlay y después se agrega al mapa mediante el método GMap2.addOverlay().
Los objetos de marcador tienen elementos latlng correspondientes a la posición geográfica en la que los marcadores se anclan en el mapa, así como un elemento icon. Si en el constructor no se define la clase icon, se utiliza el icono predeterminado G_DEFAULT_ICON.
Tras agregarse a un mapa, la ventana de información se podrá abrir a través del marcador. El objeto marcador activará eventos de ratón y eventos de ventana de información.
| Constructor | Descripción |
|---|---|
GMarker(latlng:GLatLng,
icon?:GIcon,
inert?:Boolean)
|
Crea un marcador en el elemento latlng transmitido de GPoint o GLatLng con icon o G_DEFAULT_ICON. Si la marca de inert es true, entonces no se puede hacer clic en el marcador y no se activa ningún evento.(Obsoleto desde la versión 2,50). |
GMarker(latlng:GLatLng,
opts?:GMarkerOptions)
|
Crea un marcador en latlng con las opciones especificadas en GMarkerOptions. De forma predeterminada, se puede hacer clic en los marcadores y tienen el icono predeterminado G_DEFAULT_ICON.(A partir de la versión 2,50). |
Antes de invocar a estos métodos, es necesario haber agregado el marcador al mapa.
| Método | Valor devuelto | Descripción |
|---|---|---|
openInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información sobre el icono del marcador. El contenido de la ventana de información se indica como nodo DOM. Sólo es aplicable la opción GInfoWindowOptions.maxWidth. |
openInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información sobre el icono del marcador. El contenido de la ventana de información se indica como una cadena que contiene texto HTML. Sólo es aplicable la opción GInfoWindowOptions.maxWidth. |
openInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información con pestañas sobre el icono del marcador. El contenido de la ventana de información se indica como un conjunto de fichas que incluyen su contenido en forma de nodos DOM. Sólo son aplicables las opciones GInfoWindowOptions.maxWidth y InfoWindowOptions.selectedTab. |
openInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información con pestañas sobre el icono del marcador. El contenido de la ventana de información se indica como un conjunto de fichas que incluyen su contenido en forma de texto HTML. Sólo son aplicables las opciones InfoWindowOptions.maxWidth y InfoWindowOptions.selectedTab. |
bindInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Vincula el nodo DOM en cuestión a este marcador. El contenido dentro de este nodo se mostrará automáticamente en la ventana de información cuando se haga clic en el marcador. Pasa content como null para anular el enlace.(A partir de la versión 2,85). |
bindInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Enlaza el HTML en cuestión con este marcador. El contenido HTML se mostrará automáticamente en la ventana de información cuando se haga clic en el marcador. Pasa content como null para anular el enlace.(A partir de la versión 2,85). |
bindInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Enlaza las clases GInfoWindowTab proporcionadas (indicadas como nodos DOM) con este marcador. El contenido dentro de estos nodos de pestaña se muestra automáticamente en la ventana de información cuando se hace clic en el marcador. Pasa tabs como null para anular el enlace.(A partir de la versión 2,85). |
bindInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Enlaza las clases GInfoWindowTab proporcionadas (indicadas como cadenas de HTML) con este marcador. El contenido HTML dentro de estas pestañas se muestra automáticamente en la ventana de información cuando se hace clic en el marcador. Pasa tabs como null para anular el enlace.(A partir de la versión 2,85). |
closeInfoWindow()
|
None |
Cierra la ventana de información sólo si pertenece a este marcador. (A partir de la versión 2,85). |
showMapBlowup(opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información sobre el icono del marcador. El contenido de la ventana de información corresponde a un mapa de cerca alrededor de la posición del marcador. Sólo son aplicables las opciones InfoWindowOptions.zoomLevel y InfoWindowOptions.mapType. |
getIcon()
|
GIcon |
Devuelve icon para este marcador, tal y como lo haya definido el constructor. |
getTitle()
|
String |
Devuelve el título de este marcador tal y como lo haya definido el constructor a través de la propiedad GMarkerOptions.title. Devuelve un valor sin definir si no se transmite ningún mosaico.(A partir de la versión 2,85). |
getPoint()
|
GLatLng |
Devuelve las coordenadas geográficas en las que se ancla el marcador, tal y como las defina el constructor o la clase setPoint().(Obsoleto desde la versión 2,88). |
getLatLng()
|
GLatLng |
Devuelve las coordenadas geográficas en las que se ancla el marcador, tal y como las defina el constructor o la clase setLatLng().(A partir de la versión 2,88). |
setPoint(latlng:GLatLng)
|
None |
Define las coordenadas geográficas del punto en el cual está anclado el marcador. (Obsoleto desde la versión 2,88). |
setLatLng(latlng:GLatLng)
|
None |
Define las coordenadas geográficas del punto en el cual está anclado el marcador. (A partir de la versión 2,88). |
enableDragging()
|
None |
Permite arrastrar el marcador y soltarlo alrededor del mapa. Para que funcione, es necesario que el marcador se haya inicializado ya con GMarkerOptions.draggable = true. |
disableDragging()
|
None |
Impide que se pueda arrastrar el marcador y soltarlo alrededor del mapa. |
draggable()
|
Boolean |
Devuelve true si el marcador se ha inicializado a través del constructor utilizando GMarkerOptions.draggable =
true. Si no, devuelve false.
|
draggingEnabled()
|
Boolean |
Devuelve true si el marcador está habilitado en ese momento para que el usuario pueda arrastrarlo en el mapa.
|
setImage(url:String)
|
None |
Solicita que se defina como imagen en primer plano para el marcador la imagen que especifique url. Ten en cuenta que no se ajustan ni la imagen de impresión ni la imagen de sombra, por lo que el objetivo principal de este método es aplicar efectos de brillo o atenuación del brillo, en lugar de cambios drásticos en el aspecto del marcador.
(A partir de la versión 2,75). |
hide()
|
None |
Oculta el marcador si está visible en ese momento. Ten en cuenta que esta función activa el evento GMarker.visibilitychanged si el marcador está visible en ese momento. (A partir de la versión 2,77). |
show()
|
None |
Muestra el marcador si está oculto en ese momento. Ten en cuenta que esta función activa el evento GMarker.visibilitychanged si el marcador está oculto en ese momento. (A partir de la versión 2,77). |
isHidden()
|
Boolean |
Devuelve true si el marcador está oculto en ese momento. Si no, devuelve false. (A partir de la versión 2,77). |
Todos estos eventos se activan únicamente si el marcador no es inerte (inert) (consulta el constructor).
| Evento | Descripción |
|---|---|
click(latlng:GLatLng)
|
Este evento se activa cuando se ha hecho clic en el icono del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. Ten en cuenta que este evento irá también dirigido al mapa, pasando el marcador como primer argumento a su gestor de eventos. |
dblclick(latlng:GLatLng)
|
Este evento se activa cuando se ha hecho doble clic en el icono del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. Ten en cuenta que este evento no irá dirigido al mapa, ya que el mapa considera el doble clic como un comportamiento cableado. |
mousedown(latlng:GLatLng)
|
Este evento se activa cuando el evento mousedown DOM se activa en el icono del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. Ten en cuenta que el marcador detendrá el evento DOM MouseDown para que no se empiece a arrastrar el mapa. |
mouseup(latlng:GLatLng)
|
Este evento se activa para el evento mouseup DOM del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. Ten en cuenta que el marcador no detendrá el evento mousedown DOM para no confundir al controlador de arrastre del mapa. |
mouseover(latlng:GLatLng)
|
Este evento se activa cuando el evento penetra en el área del icono del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. |
mouseout(latlng:GLatLng)
|
Este evento se activa cuando el evento sale del área del icono del marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. |
infowindowopen()
|
Este evento se activa si la ventana de información del mapa se abrió a través del marcador. |
infowindowbeforeclose()
|
Este evento se activa antes de que se cierre la ventana de información del mapa que se abrió a través del marcador. (A partir de la versión 2,83). |
infowindowclose()
|
Este evento se activa cuando se cierra la ventana de información del mapa que se abrió a través del marcador. Esto ocurre cuando se ha cerrado la ventana de información o cuando se ha abierto en otro marcador o en el mapa. El evento infowindowbeforeclose se activa antes que este evento. |
remove()
|
Este evento se activa cuando se elimina el marcador del mapa mediante GMap2.removeOverlay() o GMap2.clearOverlays(). |
dragstart(latlng:GLatLng)
|
Si el marcador está habilitado para arrastre, este evento se activará al empezar a arrastrar el marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. |
drag(latlng:GLatLng)
|
Si el marcador está habilitado para arrastre, este evento se activará mientras se arrastra el marcador, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. |
dragend(latlng:GLatLng)
|
Si el marcador está habilitado para arrastre, este evento se activará cuando el marcador deje de arrastrarse, transmitiendo la coordenada actual del marcador dentro de su argumento latlng. |
visibilitychanged(isVisible:Boolean)
|
Este evento se activará cuando se modifique la visibilidad del marcador (es decir, cuando se cambie de visible a oculto o viceversa). isVisible hace referencia al estado del marcador después de modificar la visibilidad.
(A partir de la versión 2,77). |
Las instancias de esta clase se usan en el argumento opts? en el constructor de la clase GMarker. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
icon
|
GIcon |
Elige el icono para esta clase. Si no se especifica ninguno, se usará G_DEFAULT_ICON.(A partir de la versión 2,50). |
dragCrossMove
|
Boolean |
Al arrastrar marcadores siguiendo el procedimiento normal, el marcador flota por encima del cursor, lejos de él. Si se define este valor en true, el marcador se mantendrá debajo del cursor y desplazará la cruz hacia abajo. El valor predeterminado para esta opción es false.(A partir de la versión 2,63). |
title
|
String |
Esta cadena aparecerá como información de herramienta en el marcador, es decir, que funcionará como el atributo title en los elementos HTML.(A partir de la versión 2,50). |
clickable
|
Boolean |
Habilita o deshabilita alternativamente la posibilidad de hacer clic en el marcador. Los marcadores en los que no puede hacerse clic o que no se pueden arrastrar son inertes, consumen menos recursos y no responden a ningún evento. El valor predeterminado para esta opción es true, es decir, que si no se especifica ninguna opción, se podrá hacer clic en el marcador.(A partir de la versión 2,50). |
draggable
|
Boolean |
Habilita o deshabilita alternativamente la posibilidad de que los usuarios puedan arrastrar el marcador. Los marcadores configurados para poder arrastrarse requieren más recursos que los marcadores en los que se puede hacer clic. De forma predeterminada, si un marcador se puede arrastrar, también se puede hacer clic en él, al igual que puede rebotar y desplazarse automáticamente. El valor predeterminado para esta opción es false.(A partir de la versión 2,61). |
bouncy
|
Boolean |
Habilita o deshabilita alternativamente si el marcador debe rebotar hacia arriba y hacia abajo cuando termine de arrastrarse. El valor predeterminado para esta opción es false.(A partir de la versión 2,61). |
bounceGravity
|
Number |
Cuando se termina de arrastrar, este número sirve para definir la tasa de aceleración del marcador durante el rebote hacia tierra. El valor predeterminado para esta opción es 1.(A partir de la versión 2,61). |
autoPan
|
Boolean |
Desplaza automáticamente el mapa al arrastrar el marcador cerca del borde. Si el marcador se puede arrastrar, el valor predeterminado para esta opción es true.(A partir de la versión 2.87). |
zIndexProcess
|
Function |
Esta función se utiliza para cambiar el orden de índice z de los marcadores cuando se superponen en el mapa y se le llama también cuando se abre su ventana de información. El orden predeterminado es que los marcadores más al sur se coloquen más arriba que los marcadores más al norte. Esta función se pasa en el objeto GMarker y devuelve un número que indica el nuevo índice z.(A partir de la versión 2,98). |
hide
|
Boolean |
Si se establece en "true", indica que en principio el mapa no debe mostrar GMarker. Para activar la superposición, ejecuta GMarker.show(). De forma predeterminada, este valor está establecido en "false".
(A partir de la versión 2,139). |
Esta es una superposición de mapa que dibuja una polilínea en el mapa utilizando para ello las funciones de dibujo vectorial del navegador si las hay o, si no, una superposición de imagen desde los servidores Google.
| Constructor | Descripción |
|---|---|
GPolyline(latlngs:GLatLng[],
color?:String,
weight?:Number,
opacity?:Number,
opts?:GPolylineOptions)
|
Crea una polilínea a partir de una matriz de vértices. El valor de color se indica como una cadena que contiene el color en estilo HTML numérico hexadecimal, por ejemplo, #RRGGBB. El valor de weight corresponde a la anchura de la línea en píxeles. El nivel de opacity se representa como un número entre 0 y 1. La línea será una semitransparente y suavizada. |
| Método | Valor devuelto | Descripción |
|---|---|---|
GPolyline.fromEncoded(color?:String,
weight?:Number,
opacity?:Number,
latlngs:String,
zoomFactor:Number,
levels:String,
numLevels:Number)
|
GPolyline |
Crea una polilínea de cadenas codificadas de coordenadas y niveles acumulados. color es una cadena que contiene un estilo de código HTML numérico hexadecimal, como #RRGGBB. El valor de weight corresponde a la anchura de la línea en píxeles. El valor de opacity corresponde a un número entre 0 y 1. latlngs es una cadena que contiene las coordenadas de latitud y longitud codificadas. levels es una cadena que contiene los grupos de nivel de zoom de las polilíneas codificadas. numLevels es un número de niveles de zoom que contiene la cadena levels codificada. zoomFactor es la magnificación entre conjuntos adyacentes de niveles de zoom en la cadena levels codificada. Juntos, estos dos valores determinan la precisión de levels dentro de una polilínea codificada. La línea será una semitransparente y suavizada.(A partir de la versión 2,63). |
| Método | Valor devuelto | Descripción |
|---|---|---|
deleteVertex(index:Number)
|
None |
Elimina el vértice con el índice especificado en la polilínea y actualiza la forma de la polilínea debidamente. GPolyline ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
disableEditing()
|
None |
Invierte los efectos de enableEditing, eliminando todos los puntos de control de la línea e impidiendo que el usuario pueda editarla.
(A partir de la versión 2,111). |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Permite a un usuario construir (o modificar) un objeto GPolyline al hacer clic en otros puntos del mapa. GPolyline ya se debe haber añadido al mapa mediante GMap2.addOverlay(), aunque la polilínea esté inicialmente vacía y no contenga vértices. Cada clic añade un vértice adicional a la cadena de la polilínea y será posible finalizar el dibujo haciendo doble clic o clic de nuevo en el último punto añadido, momento en el que se activará un evento "endline" si la polilínea se ha completado correctamente; de lo contrario, se activará un evento "cancelline", pero la polilínea no se eliminará del mapa. Si se modifica una polilínea GPolyline existente, los vértices se conectarán desde el punto inicial o final de la polilínea existente, según se especifica en el parámetro GPolyEditingOptions.fromStart opcional.
(A partir de la versión 2,111). |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Permite una modificación de una cadena de puntos GPolyline existente. Si se habilita, los usuarios pueden seleccionar y arrastrar vértices existentes. A menos que se especifique un límite de vértices inferior al número actual de vértices divido entre maxVertices en GPolyEditingOptions, también se podrán añadir puntos "fantasma" en los puntos medios de las secciones de la polilínea, permitiendo así a los usuarios interpolar nuevos vértices al hacer clic y arrastrar estos vértices adicionales. Se activará un evento "lineupdated" cada vez que se añada o se mueva un vértice.
(A partir de la versión 2,111). |
getVertexCount()
|
Number |
Devuelve el número de vértices de la polilínea. (A partir de la versión 2,46). |
getVertex(index:Number)
|
GLatLng |
Devuelve el vértice con el índice indicado en la polilínea. (A partir de la versión 2,46). |
getLength()
|
Number |
Devuelve la longitud (en metros) de la polilínea a lo largo de la superficie de una Tierra esférica. (A partir de la versión 2,85). |
getBounds()
|
GLatLngBounds |
Devuelve los límites de la polilínea. (A partir de la versión 2,85). |
hide()
|
None |
Oculta la polilínea si está en ese momento visible y si GPolyline.supportsHide() devuelve true. Ten en cuenta que esta función activa el evento GPolyline.visibilitychanged si la polilínea está visible en ese momento.(A partir de la versión 2.87). |
insertVertex(index:Number,
latlng:GLatLng)
|
None |
Inserta un nuevo punto en el índice especificado de la polilínea y actualiza su forma. GPolyline ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
isHidden()
|
Boolean |
Devuelve true si la polilínea está oculta en ése momento. Si no, devuelve false. (A partir de la versión 2.87). |
show()
|
None |
Muestra la polilínea si está oculta en ese momento. Ten en cuenta que esta función activa el evento GPolyline.visibilitychanged si la polilínea está oculta en ese momento.(A partir de la versión 2.87). |
supportsHide()
|
Boolean |
Devuelve true si GPolyline.hide() es compatible con el entorno en uso para objetos GPolyline. Si no, devuelve false. (A partir de la versión 2.87). |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Cambia el estilo de la polilínea. GPolyline ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
| Evento | Descripción |
|---|---|
remove()
|
Este evento se activa cuando se elimina la polilínea del mapa mediante GMap2.removeOverlay() o GMap2.clearOverlays(). |
visibilitychanged(isVisible:Boolean)
|
Este evento se activa cuando el estado de visibilidad de la polilínea cambia de visible a oculta o viceversa. El argumento isVisible refleja el estado de la polilínea cuando termina de cambiar el estado de visibilidad.
(A partir de la versión 2.87). |
click(latlng:GLatLng)
|
Este evento se activa cuando se ha hecho clic en la polilínea, transmitiendo la coordenada en la que se ha hecho clic de la línea dentro de su argumento latlng. Ten en cuenta que este evento también activará posteriormente un evento "click" donde la polilínea se transmite como el argumento overlay dentro de dicho evento.
(A partir de la versión 2,88). |
mouseover()
|
Este evento se activa cuando el ratón pasa sobre la polilínea.
(A partir de la versión 2,111). |
mouseout()
|
Este evento se activa cuando el ratón se mueve fuera de la polilínea.
(A partir de la versión 2,111). |
lineupdated()
|
Este evento se activa cuando se actualiza el estilo o la forma de la polilínea.
(A partir de la versión 2,111). |
endline()
|
Este evento se activa cuando el usuario termina el dibujo de la línea (iniciado con la ejecución de GPolyline.enableDrawing).
(A partir de la versión 2,111). |
cancelline()
|
Este evento se activa cuando el usuario cancela el dibujo de la línea (iniciado con la ejecución de GPolyline.enableDrawing).
(A partir de la versión 2,111). |
Se usan instancias de esta clase en el constructor de GPolyline. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
clickable
|
Boolean |
Habilita o deshabilita alternativamente la posibilidad de hacer clic en la polilínea. El valor predeterminado para esta opción es true, es decir que, si no se especifica opción alguna, se podrá hacer clic en la polilínea.
(A partir de la versión 2,91). |
geodesic
|
Boolean |
Procesa todos los bordes de la polilínea como una línea geodésica (un segmento de un "gran círculo"). La línea geodésica corresponde a la ruta más corta entre dos puntos a lo largo de la superficie de la Tierra.
(A partir de la versión 2,84). |
Se utilizan instancias de esta clase en los métodos enableEditing de GPolyline y GPolygon. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
maxVertices
|
Number |
Esta propiedad especifica el número máximo de vértices permitidos por esta polilínea. Una vez que se alcance este número, no se podrán añadir más. (A partir de la versión 2,111). |
fromStart
|
Boolean |
Esta propiedad especifica si enableDrawing debe añadir puntos desde el principio en lugar de desde el final, que es la configuración predeterminada. (A partir de la versión 2,111). |
Se utilizan instancias de esta clase en el método setStrokeStyle de GPolyline y GPolygon y en el método setFillStyle de GPolygon. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
color
|
String |
Esta propiedad especifica una cadena que contiene un estilo de código HTML numérico hexadecimal, como #RRGGBB.
(A partir de la versión 2,111). |
weight
|
Number |
Esta propiedad especifica el ancho de la línea en píxeles. (A partir de la versión 2,111). |
opacity
|
Number |
Esta propiedad especifica la opacidad de la polilínea como un valor fraccional entre 0 (transparente) y 1 (opaca). (A partir de la versión 2,111). |
Es muy similar a GPolyline, excepto en que se puede especificar además la opacidad y un color de relleno.
| Constructor | Descripción |
|---|---|
GPolygon(latlngs:GLatLng[],
strokeColor?:String,
strokeWeight?:Number,
strokeOpacity?:Number,
fillColor?:Number,
fillOpacity?:Number,
opts?:GPolygonOptions)
|
Crea un polígono a partir de una matriz de vértices. El valor de colors se indica como una cadena que contiene el color en estilo HTML numérico hexadecimal, como #RRGGBB. El valor de weight corresponde a la anchura de la línea en píxeles. El nivel de opacities se representa como un número entre 0 y 1. La línea será una semitransparente y suavizada.(A partir de la versión 2,69). |
| Método | Valor devuelto | Descripción |
|---|---|---|
GPolygon.fromEncoded(polylines:encoded polylines[],
fill?:Boolean,
color?:String,
opacity?:Number,
outline?:Boolean)
|
GPolygon |
Crea un polígono (formado por varias polilíneas) a partir de cadenas codificadas de coordenadas y niveles acumulados. polylines contiene un conjunto asociativo de polilíneas constitutivas, codificadas con el mismo formato descrito en la GPolyline.fromEncodeddocumentación. fill especifica si rellenar el polígono con un color concreto. opacity y outline especifica si trazar el polígono con el color, el peso y la opacidad de la polilínea. Si la polilínea tiene especificados varios valores, se tomarán los primeros.
(A partir de la versión 2,78). |
| Método | Valor devuelto | Descripción |
|---|---|---|
deleteVertex(index:Number)
|
None |
Elimina con el índice especificado en el polígono y actualiza la forma del polígono debidamente. GPolygon ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
disableEditing()
|
None |
Invierte los efectos de enableEditing, eliminando todos los puntos de control de la línea e impidiendo que el usuario pueda editarla.
(A partir de la versión 2,111). |
enableDrawing(opts?:GPolyEditingOptions)
|
None |
Permite a un usuario construir un objeto GPolygon al hacer clic en otros puntos del mapa. GPolyline ya se debe haber añadido al mapa mediante GMap2.addOverlay(), aunque la polilínea esté inicialmente vacía y no contenga vértices. Cada clic añade un vértice adicional al límite del polígono y será posible finalizar el dibujo haciendo doble clic o clic en el primer punto para completar la forma, momento en el que se activará un evento "endline" si el polígono se ha completado correctamente; de lo contrario, se activará un evento "cancelline", pero la polilínea no se eliminará del mapa.
(A partir de la versión 2,111). |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Permite modificar un límite GPolygon existente. Si se habilita, los usuarios pueden seleccionar y arrastrar vértices existentes. A menos que se especifique un límite de vértices inferior al número actual de vértices divido entre maxVertices en GPolyEditingOptions, también se podrán añadir puntos "fantasma" en los puntos medios de las secciones del polígono, permitiendo así a los usuarios interpolar nuevos vértices al hacer clic y arrastrar estos vértices adicionales. Se activará un evento "lineupdated" cada vez que se añada o se mueva un vértice.
(A partir de la versión 2,111). |
getVertexCount()
|
Number |
Devuelve el número de vértices del polígono. (A partir de la versión 2,69). |
getVertex(index:Number)
|
GLatLng |
Devuelve el vértice con el índice indicado en el polígono. (A partir de la versión 2,69). |
getArea()
|
Number |
Devuelve el área (en metros cuadrados) del polígono, entendiendo que la Tierra es esférica. (A partir de la versión 2,85). |
getBounds()
|
GLatLngBounds |
Devuelve los límites del polígono. (A partir de la versión 2,85). |
hide()
|
None |
Oculta el polígono si está visible en ese momento y si GPolygon.supportsHide devuelve true. Ten en cuenta que esta función activa el evento GPolygon.visibilitychanged si el polígono está visible en ese momento.(A partir de la versión 2.87). |
insertVertex(index:Number,
latlng:GLatLng)
|
None |
Inserta un nuevo punto en el índice especificado del polígono. GPolygon ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
isHidden()
|
Boolean |
Devuelve true si el polígono está oculto en ese momento. Si no, devuelve false. (A partir de la versión 2.87). |
show()
|
None |
Muestra el polígono si está oculto en ese momento. Ten en cuenta que esta función activa el evento GPolygon.visibilitychanged si el polígono está oculto en ese momento.(A partir de la versión 2.87). |
supportsHide()
|
Boolean |
Devuelve true si GPolygon.hide() es compatible con el entorno en uso para objetos GPolygon. Si no, devuelve false. (A partir de la versión 2.87). |
setFillStyle(style:GPolyStyleOptions)
|
None |
Cambia el estilo de relleno del polígono. GPolygon ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Cambia el estilo de línea del polígono. GPolygon ya se debe haber añadido al mapa mediante GMap2.addOverlay().
(A partir de la versión 2,111). |
| Evento | Descripción |
|---|---|
remove()
|
Este evento se activa cuando se elimina el polígono del mapa mediante GMap2.removeOverlay() o GMap2.clearOverlays(). |
visibilitychanged(isVisible:Boolean)
|
Este evento se activa cuando el estado de visibilidad del polígono cambia de visible a oculto o viceversa. El argumento isVisible refleja el estado del polígono cuando termina de cambiar el estado de visibilidad.
(A partir de la versión 2.87). |
click(latlng:GLatLng)
|
Este evento se activa cuando se ha hecho clic en el polígono, transmitiendo la coordenada en la que se ha hecho clic del polígono dentro de su argumento latlng. Ten en cuenta que este evento también activará posteriormente un evento "click" donde el polígono se transmite como el argumento overlay dentro de dicho evento.
(A partir de la versión 2.88>). |
mouseover()
|
Este evento se activa cuando el ratón se desplaza sobre en la región del polígono.
(A partir de la versión 2,111). |
mouseout()
|
Este evento se activa cuando el ratón se desplaza fuera de la región del polígono.
(A partir de la versión 2,111). |
lineupdated()
|
Este evento se activa cuando se actualiza el estilo o la forma del polígono.
(A partir de la versión 2,111). |
endline()
|
Este evento se activa cuando el usuario termina el dibujo del polígono (iniciado con la ejecución de GPolyline.enableDrawing).
(A partir de la versión 2,111). |
cancelline()
|
Este evento se activa cuando el usuario cancela el dibujo del polígono (iniciado con la ejecución de GPolyline.enableDrawing).
(A partir de la versión 2,111). |
Se usan instancias de esta clase en el constructor de GPolygon. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
Tal y como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
clickable
|
Boolean |
Habilita o deshabilita alternativamente la posibilidad de hacer clic en el polígono. El valor predeterminado para esta opción es true, es decir, que si no se especifica ninguna opción, se podrá hacer clic en el polígono.
(A partir de la versión 2,91). |
Este objeto muestra una superposición de imagen rectangular en el mapa cuya posición permanece fija a medida que cambia la ventana gráfica. Algunos ejemplos de uso de las superposiciones en pantalla son las brújulas, los logotipos y la presentación de encabezados.
| Constructor | Descripción |
|---|---|
GScreenOverlay(imageUrl:String,
screenXY:GScreenPoint,
overlayXY:GScreenPoint,
size:GScreenSize)
|
Crea una superposición de pantalla desde una URL de imagen y la muestra en pantalla según lo especificado por los parámetros screenXY, overlayXY y size. El parámetro overlayXY determina el punto en la imagen de superposición (o fuera de ella) donde se asigna a la coordenada screenXY. Esto se puede utilizar para "recortar" eficazmente la imagen. El parámetro screenXY determina el punto relativo al origen de la pantalla (esquina inferior izquierda) al que se asigna la imagen superpuesta.(A partir de la versión 2,92). |
| Método | Valor devuelto | Descripción |
|---|---|---|
hide()
|
None |
Oculta la superposición de pantalla si está visible en ese momento. Ten en cuenta que esta función activa el evento GScreenOverlay.visibilitychanged si la superposición de pantalla está visible en ese momento.(A partir de la versión 2,92). |
isHidden()
|
Boolean |
Devuelve true si la superposición de pantalla está oculta en ese momento. Si no, devuelve false. (A partir de la versión 2,92). |
show()
|
None |
Muestra la superposición de pantalla si está oculta en ese momento. Ten en cuenta que esta función activa el evento GScreenOverlay.visibilitychanged si la superposición de pantalla está oculta en ese momento.(A partir de la versión 2,92). |
supportsHide()
|
Boolean |
Siempre devuelve true.(A partir de la versión 2,92). |
| Evento | Descripción |
|---|---|
visibilitychanged(isVisible:Boolean)
|
Este evento se activa cuando el estado de visibilidad de la superposición de pantalla cambia de visible a oculta o viceversa. El argumento isVisible refleja el estado de la superposición de pantalla cuando termina de cambiar el estado de visibilidad.
(A partir de la versión 2,92). |
Una clase GScreenPoint identifica un punto en la ventana gráfica del mapa mediante una coordenada X e Y, cada una de las cuales puede representar una posición fraccional o absoluta dependiendo del valor de los parámetros opcionales del constructor.
| Constructor | Descripción |
|---|---|
GScreenPoint(x:Number,
y:Number,
xunits?:String,
yunits?:String)
|
Crea un objeto GScreenPoint. Las coordenadas x e y pueden representar una posición fraccional o absoluta que se pasan en fracción o en píxeles a los parámetros xunits e yunits. El valor predeterminado de estos parámetros son píxeles.
(A partir de la versión 2,92). |
| Propiedad | Tipo | Descripción |
|---|---|---|
x
|
Number |
Coordenada x, la cual provoca un aumento hacia la izquierda. |
y
|
Number |
Coordenada y, la cual provoca un aumento hacia abajo. |
xunits
|
String |
Especifica el tipo de unidades que se debe usar en la coordenada x. Define este valor en fracción para indicar una posición fraccional relativa al tamaño del mapa, o en píxeles para indicar una posición absoluta. El valor predeterminado es la posición absoluta. |
yunits
|
String |
Especifica el tipo de unidades que se debe usar en la coordenada y. Define este valor en fracción para indicar una posición fraccional relativa al tamaño del mapa, o en píxeles para indicar una posición absoluta. El valor predeterminado es la posición absoluta. |
GScreenSize indica el tamaño de un área rectangular del mapa, determinada por los parámetros width y height. Cada uno de esos parámetros puede representar un tamaño fraccional o en píxeles según el valor de los parámetros opcionales del constructor.
| Constructor | Descripción |
|---|---|
GScreenSize(width:Number,
height:Number,
xunits?:String,
yunits?:String)
|
Crea un objeto GScreenSize. Las coordenadas width y height pueden representar un tamaño fraccional o en píxeles mediante la transmisión en fracción o en píxeles a los parámetros xunits y yunits. El valor predeterminado de los argumentos width y height es "pixel."
(A partir de la versión 2,92). |
| Propiedad | Tipo | Descripción |
|---|---|---|
width
|
Number |
El parámetro de la anchura del espacio real en pantalla. Ten en cuenta que este valor representa un valor fraccional o uno de píxeles absolutos dependiendo del valor de la propiedad GScreen.yunits. |
height
|
Number |
El parámetro de la altura del espacio real en pantalla de. Ten en cuenta que este valor representa un valor fraccional o uno de píxeles absolutos dependiendo del valor de la propiedad GScreen.yunits. |
xunits
|
String |
Especifica el tipo de unidades que se debe usar en la propiedad GScreenSize.width. Define este valor en fracción para indicar una posición fraccional relativa al tamaño del mapa, o en píxeles para indicar una posición en píxeles. El valor predeterminado es la posición en píxeles. |
yunits
|
String |
Especifica el tipo de unidades que se debe usar en la propiedad GScreenSize.height. Define este valor en fracción para indicar una posición fraccional relativa al tamaño del mapa, o en píxeles para indicar una posición en píxeles. El valor predeterminado es la posición en píxeles. |
Este objeto crea una superposición de imagen rectangular en el mapa cuyos límites se definen mediante GLatLngBounds.
| Constructor | Descripción |
|---|---|
GGroundOverlay(imageUrl:String,
bounds:GLatLngBounds)
|
Crea una superposición del suelo a partir de una URL de imagen y sus bordes. (A partir de la versión 2,79). |
| Método | Valor devuelto | Descripción |
|---|---|---|
hide()
|
None |
Oculta la superposición del suelo si está visible en ese momento. Ten en cuenta que esta función activa el evento GGroundOverlay.visibilitychanged si la superposición del suelo está visible en ese momento.(A partir de la versión 2.87). |
isHidden()
|
Boolean |
Devuelve true si la superposición del suelo está oculta en ese momento. Si no, devuelve false. (A partir de la versión 2.87). |
show()
|
None |
Muestra la superposición del suelo si está oculta en ese momento. Ten en cuenta que esta función activa el evento GGroundOverlay.visibilitychanged si la superposición del suelo está oculta en ese momento.(A partir de la versión 2.87). |
supportsHide()
|
Boolean |
Siempre devuelve true.(A partir de la versión 2.87). |
| Evento | Descripción |
|---|---|
visibilitychanged(isVisible:Boolean)
|
Este evento se activa cuando el estado de visibilidad de la superposición del suelo cambia de visible a oculta o viceversa. El argumento isVisible refleja el estado de la superposición del suelo cuando termina de cambiar el estado de visibilidad.
(A partir de la versión 2,77). |
Un icono especifica qué imágenes se deben utilizar para mostrar un GMarker en el mapa. Por motivos de compatibilidad con el navegador, especificar un icono es realmente complicado. Ten en cuenta que, si prefieres no especificar ninguno propio, siempre puedes utilizar el icono predeterminado de Google Maps G_DEFAULT_ICON.
| Constructor | Descripción |
|---|---|
GIcon(copy?:GIcon,
image?:String)
|
Crea un objeto de icono nuevo. Si se indica otro icono en el argumento opcional copy, se copiarán sus propiedades. Si no, se dejarán vacías. El argumento opcional image define el valor de la propiedad image. |
| Constante | Descripción |
|---|---|
G_DEFAULT_ICON
|
El icono predeterminado para los marcadores. |
| Propiedad | Tipo | Descripción |
|---|---|---|
image
|
String |
La URL de la imagen en primer plano del icono. |
shadow
|
String |
La URL de la imagen de sombra del icono. |
iconSize
|
GSize |
El tamaño en píxeles de la imagen en primer plano del icono. |
shadowSize
|
GSize |
El tamaño en píxeles de la imagen de sombra. |
iconAnchor
|
GPoint |
Las coordenadas en píxeles relativas a la esquina superior izquierda de la imagen del icono en la que éste queda anclada al mapa. |
infoWindowAnchor
|
GPoint |
Las coordenadas en píxeles relativa a la esquina superior izquierda de la imagen del icono en la que la ventana de información queda anclada al icono. |
printImage
|
String |
La URL de la imagen del icono en primer plano que se utilizará para los mapas impresos. Esta imagen ha de tener el mismo tamaño que la imagen del icono principal indicado mediante image. |
mozPrintImage
|
String |
La URL de la imagen del icono en primer plano que se utilizará para los mapas impresos en Firefox/Mozilla. Esta imagen ha de tener el mismo tamaño que la imagen del icono principal indicado mediante image. |
printShadow
|
String |
La URL de la imagen de sombra que se utilizará para los mapas impresos. Ésta ha de ser una imagen GIF, ya que la mayoría de los navegadores no pueden imprimir imágenes PNG. |
transparent
|
String |
La URL de una versión virtualmente transparente de la imagen del icono en primer plano empleada para capturar eventos de "click" en Internet Explorer. Esta imagen debe ser una versión PNG de 24 bits de la imagen del icono principal con una opacidad del 1%, pero ha de tener la misma forma y el mismo tamaño que el icono principal. |
imageMap
|
Number[] |
En navegadores distintos a Internet Explorer, para especificar la parte de la imagen del icono en la que se puede hacer clic, debe usarse una matriz de números enteros que representen a las coordenadas x/y del mapa de imagen. |
maxHeight
|
Integer |
Especifica la distancia en píxeles en la que un marcador "subirá" verticalmente al arrastrarse. (A partir de la versión 2,79). |
dragCrossImage
|
String |
Especifica la URL de la imagen de cruz que aparece cuando se arrastra un icono. (A partir de la versión 2,79). |
dragCrossSize
|
GSize |
Especifica el tamaño en píxeles de la imagen de cruz que aparece cuando se arrastra un icono. (A partir de la versión 2,79). |
dragCrossAnchor
|
GPoint |
Especifica los desplazamientos de coordenadas en píxeles (relativos al lugar de ancla del icono) de la imagen de cruz que aparece cuando se arrastra un icono. (A partir de la versión 2,79). |
Una clase GPoint representa un punto en el mapa según sus coordenadas en píxeles. Ten en cuenta que en la versión 2 ya no representa un punto de la Tierra de acuerdo a sus coordenadas geográficas. Las coordenadas geográficas se representan ahora con GLatLng.
En el sistema de coordenadas de Google Maps, la coordenada x aumenta hacia la derecha y la coordenada y aumenta hacia abajo, aunque puedes utilizar las coordenadas GPoint como prefieras.
Ten en cuenta que, mientras los dos parámetros de GPoint quedarán accesibles como propiedades x y y, es mejor no modificarlos nunca y, en su lugar, conviene más crear un objeto nuevo con parámetros diferentes.
| Constructor | Descripción |
|---|---|
GPoint(x:Number,
y:Number)
|
Crea un objeto GPoint. |
| Propiedad | Tipo | Descripción |
|---|---|---|
x
|
Number |
Coordenada x. (Este valor provoca un aumento hacia la derecha en el sistema de coordenadas de Google Maps). |
y
|
Number |
Coordenada y. (Este valor provoca un aumento hacia abajo en el sistema de coordenadas de Google Maps). |
| Método | Valor devuelto | Descripción |
|---|---|---|
equals(other:GPoint)
|
Boolean |
Devuelve true si el otro punto tiene las mismas coordenadas. |
toString()
|
String |
Devuelve una cadena que contiene las coordenadas x e y, en este orden, separadas por coma. |
La clase GSize corresponde al tamaño en píxeles de un área rectangular del mapa. El objeto de tamaño tiene dos parámetros, width y height. La anchura corresponde a una diferencia de puntos en la coordenada x; la altura a una diferencia de puntos en la coordenada y.
Ten en cuenta que, mientras los dos parámetros de GSize quedarán accesibles como propiedades width y height, es mejor no modificarlos nunca y, en su lugar, conviene más crear un objeto nuevo con parámetros diferentes.
| Constructor | Descripción |
|---|---|
GSize(width:Number,
height:Number)
|
Crea un objeto GSize. |
| Propiedad | Tipo | Descripción |
|---|---|---|
width
|
Number |
El parámetro de anchura. |
height
|
Number |
El parámetro de altura. |
| Método | Valor devuelto | Descripción |
|---|---|---|
equals(other:GSize)
|
Boolean |
Devuelve true si los componentes del otro tamaño son exactamente iguales. |
toString()
|
String |
Devuelve una cadena que contiene los parámetros de anchura y altura, en este orden, separados por coma. |
GBounds corresponde a un área rectangular del mapa en coordenadas de píxeles. Ten en cuenta que los rectángulos en coordenadas geográficas se representan con un objeto GLatLngBounds.
| Constructor | Descripción |
|---|---|
GBounds(points:GPoint[])
|
Construye un rectángulo que contiene todos los valores proporcionados para points. |
| Propiedad | Tipo | Descripción |
|---|---|---|
minX
|
Number |
La coordenada x del borde izquierdo del rectángulo. |
minY
|
Number |
La coordenada y del borde superior del rectángulo. |
maxX
|
Number |
La coordenada x del borde derecho del rectángulo. |
maxY
|
Number |
La coordenada y del borde inferior del rectángulo. |
| Método | Valor devuelto | Descripción |
|---|---|---|
toString()
|
String |
Devuelve una cadena que contiene las coordenadas de los puntos que forman las esquinas superior izquierda e inferior derecha del cuadro, en este orden, separadas por coma y encerradas entre paréntesis. |
equals(other:GBounds)
|
Boolean |
Devuelve true si todos los parámetros de este rectángulo son iguales los parámetros del otro. (A partir de la versión 2,98). |
mid()
|
GPoint |
Devuelve las coordenadas en píxeles del centro del área rectangular. (A partir de la versión 2,88). |
min()
|
GPoint |
Devuelve las coordenadas en píxeles de la esquina superior izquierda del área rectangular. |
max()
|
GPoint |
Devuelve las coordenadas en píxeles de la esquina inferior derecha del área rectangular. |
containsBounds(other:GBounds)
|
Boolean |
Devuelve true si el área rectangular que se ha pasado está incluida totalmente en este área rectangular. |
containsPoint(point:GPoint)
|
Boolean |
Devuelve true si el área rectangular (incluida) contiene las coordenadas en píxeles.(A partir de la versión 2,88). |
extend(point:GPoint)
|
None |
Amplía el cuadro de modo que el punto quede también dentro. |
GLatLng es un punto de acuerdo a una longitud y una latitud de coordenadas geográficas.
Ten en cuenta que, aunque las proyecciones de mapas suelen asociar la longitud con la coordenada x del mapa y la latitud con la coordenada y, la coordenada de latitud siempre se escribe primero, seguida por la longitud, según es costumbre en cartografía.
Ten en cuenta también que no se pueden modificar las coordenadas de GLatLng. Si quieres calcular otro punto, tienes que crear uno nuevo.
| Constructor | Descripción |
|---|---|
GLatLng(lat:Number,
lng:Number,
unbounded?:Boolean)
|
Observa el orden de los valores de latitud y la longitud. Si la etiqueta unbounded es true, los números se utilizarán según se transmitan, de lo contrario la latitud quedará entre -90 grados y +90 grados y la longitud quedará entre -180 grados y +180 grados. |
| Método | Valor devuelto | Descripción |
|---|---|---|
lat()
|
Number |
Devuelve la coordenada de latitud en grados, como un número entre -90 y +90. Si se ha definido la marca unbounded en el constructor, esta coordenada puede estar fuera de este intervalo. |
lng()
|
Number |
Devuelve la coordenada de longitud en grados, como un número entre -180 y +180. Si se ha definido la marca unbounded en el constructor, esta coordenada puede estar fuera de este intervalo. |
latRadians()
|
Number |
Devuelve la coordenada de latitud en radianes, como un número entre -PI/2 y +PI/2. Si se ha definido la marca unbounded en el constructor, esta coordenada puede estar fuera de este intervalo. |
lngRadians()
|
Number |
Devuelve la coordenada de longitud en radianes, como un número entre -PI y +PI. Si se ha definido la marca unbounded en el constructor, esta coordenada puede estar fuera de este intervalo. |
equals(other:GLatLng)
|
Boolean |
Devuelve true si el otro tamaño tiene componentes iguales, dentro de ciertos márgenes redondeados. |
distanceFrom(other:GLatLng)
|
Number |
Devuelve la distancia en metros desde este punto al punto indicado. La Tierra es casi una esfera, por lo que la distancia podría desplazarse hasta un 0,3%. Consulta la información que aparece a continuación. (Obsoleto desde la versión 2,89). |
distanceFrom(other:GLatLng,
radius?:Number)
|
Number |
Devuelve la distancia en metros desde este punto al punto indicado. De forma predeterminada, esta distancia se calcula de acuerdo con el radio del ecuador de la Tierra predeterminado (6.378.137 metros). La Tierra es casi una esfera, por lo que la distancia podría variar hasta un 0,3%, especialmente en los extremos polares. También puede pasar un argumento opcional radius para calcular las distancias entre las coordenadas GLatLng en esferas de radio diferente al de la Tierra.(A partir de la versión 2,89). |
toUrlValue()
|
String |
Esta versión del método ha quedado obsoleta a favor de la versión revisada (abajo), la cual pasa un parámetro precision opcional.(Obsoleto desde la versión 2.78). |
toUrlValue(precision?:Number)
|
String |
Devuelve una cadena que representa al punto en cuestión en un formato adecuado para usarse como valor de parámetro URL, separado por una coma, sin espacio en blanco. De forma predeterminada, la precisión se devuelve en 6 dígitos, los cuales corresponden a una resolución de 11 centímetros. Con un parámetro precision opcional podrás especificar una precisión inferior para reducir así la carga que debe afrontar el servidor. Nota: antes de la versión 2.78, no existía este parámetro
precision.(A partir de la versión 2,78). |
Estas propiedades son compatibles retroactivamente sólo con las funciones de la versión 1 del gestor de eventos. No deberían utilizarse.
Estas propiedades reflejan los valores de devolución de los métodos de acceso lng() y lat() y permiten que aparezca GLatLng en lugares donde un cliente de la versión 1 esperaría GPoint. Esto es necesario cuando aparece GLatLng en los detalles de un evento (es decir, en argumentos de funciones del gestor de eventos). A diferencia de los contenedores de métodos, en la infraestructura actual no es posible crear contenedores de eventos.
| Propiedad | Tipo | Descripción |
|---|---|---|
x
|
Number |
Desaprobado. |
y
|
Number |
Desaprobado. |
Una instancia de GLatLngBounds representa un rectángulo en coordenadas geográficas, incluido uno que cruza el meridiano de 180 grados.
| Constructor | Descripción |
|---|---|
GLatLngBounds(sw?:GLatLng,
ne?:GLatLng)
|
Construye un rectángulo desde los puntos en las esquinas suroeste y noreste. |
| Método | Valor devuelto | Descripción |
|---|---|---|
equals(other:GLatLngBounds)
|
Boolean |
Devuelve true si todos los parámetros en el rectángulo son iguales a los parámetros del otro, dentro de cierto margen de redondeo. |
contains(latlng:GLatLng)
|
Boolean |
Devuelve true si las coordenadas geográficas del punto quedan dentro del rectángulo.(Obsoleto desde la versión 2,88). |
containsLatLng(latlng:GLatLng)
|
Boolean |
Devuelve true si las coordenadas geográficas del punto quedan dentro del rectángulo.(A partir de la versión 2,88). |
intersects(other:GLatLngBounds)
|
Boolean |
Informa de si hay límites. |
containsBounds(other:GLatLngBounds)
|
Boolean |
Informa de si hay límites. |
extend(latlng:GLatLng)
|
None |
Amplía este rectángulo de modo que contenga el punto proporcionado. En sentido longitudinal, se amplía en la dirección más pequeña de las dos posibles. Si son iguales, se amplía en el límite este. |
getSouthWest()
|
GLatLng |
Devuelve el punto en la esquina suroeste del rectángulo. |
getNorthEast()
|
GLatLng |
Devuelve el punto en la esquina noreste del rectángulo. |
toSpan()
|
GLatLng |
Devuelve un valor GLatLng cuyas coordenadas representan el tamaño del rectángulo. |
isFullLat()
|
Boolean |
Devuelve true si el rectángulo se extiende desde el Polo Sur al Norte. |
isFullLng()
|
Boolean |
Devuelve true si el rectángulo se extiende totalmente alrededor de la Tierra longitudinalmente. |
isEmpty()
|
Boolean |
Devuelve true si el rectángulo está vacío. |
getCenter()
|
GLatLng |
Devuelve el punto en el centro del rectángulo. (A partir de la versión 2,52). |
Esta interfaz la implementan todos los controles. Puedes implementarla para indicar un control personalizado para el mapa. Para añadir controles al mapa se utiliza el método GMap2.addControl().
En contraste con las superposiciones, que se colocan en relación al mapa, los controles se colocan en relación a la vista del mapa, es decir, que no se mueven cuando se mueve el mapa.
| Constructor | Descripción |
|---|---|
GControl(printable?:Boolean,
selectable?:Boolean)
|
Crea la instancia prototipo para una clase de control nueva. La marca printable indica que el control debe estar visible en el mapa impreso. La marca selectable indica que el control contendrá texto seleccionable. |
El mapa ejecutará estos métodos si se añade el control al mapa mediante GMap2.addControl(). Por tanto, el usuario no ejecutará estos métodos, sino que los implementará.
| Método | Valor devuelto | Descripción |
|---|---|---|
printable()
|
Boolean |
Indica al mapa si el control debe ser imprimible. |
selectable()
|
Boolean |
Indica al mapa si el control contiene texto seleccionable. |
initialize(map:GMap2)
|
Node |
El mapa lo llamará para que el control se pueda inicializar a sí mismo. El control utilizará el método GMap2.getContainer() para obtener el elemento DOM que contiene el mapa y agregarse a sí mismo a éste. Devuelve el elemento agregado. |
getDefaultPosition()
|
GControlPosition |
Indica al mapa la posición en la vista de mapa en la que aparecerá de forma predeterminada el control. El segundo argumento para GMap2.addControl() sobrescribirá este valor. |
Esta clase describe la posición de un control en la vista de mapa. Consiste en una esquina en relación a la posición del control y un desplazamiento que determina esta posición. Se puede pasar como argumento opcional position al método GMap2.addControl() y la devuelve el método GControl.getDefaultPosition().
| Constructor | Descripción |
|---|---|
GControlPosition(anchor:enum GControlAnchor,
offset:GSize)
|
Crea una especificación para una posición de un control. |
| Constante | Descripción |
|---|---|
G_ANCHOR_TOP_RIGHT
|
El control se anclará en la esquina superior derecha del mapa. |
G_ANCHOR_TOP_LEFT
|
El control se anclará en la esquina superior izquierda del mapa. |
G_ANCHOR_BOTTOM_RIGHT
|
El control se anclará en la esquina inferior derecha del mapa. |
G_ANCHOR_BOTTOM_LEFT
|
El control se anclará en la esquina inferior izquierda del mapa. |
Están disponibles estas implementaciones de interface
GControl.
| Constructor | Descripción |
|---|---|
GSmallMapControl()
|
Crea un control con botones para hacer desplazamientos en cuatro direcciones y para acercar y alejar la imagen. |
GLargeMapControl()
|
Crea un control con botones para hacer desplazamientos en cuatro direcciones y para acercar y alejar la imagen, así como una barra deslizante para usar el acercamiento. |
GSmallZoomControl()
|
Crea un control con botones para acercar y alejar la imagen. |
GScaleControl()
|
Crea un control que muestra la escala del mapa. |
GMapTypeControl()
|
Crea un control de tipo de mapa estándar para seleccionar tipos de mapas admitidos y pasar de uno a otro a través de botones. |
GMenuMapTypeControl()
|
Crea un control de tipo de mapa desplegable para pasar de un tipo de mapa admitido a otro. |
GHierarchicalMapTypeControl()
|
Crea un control de tipo de mapa "anidado" para seleccionar tipos de mapas admitidos y pasar de uno a otro a través de botones y casillas de verificación anidadas. |
GOverviewMapControl()
|
Crea una vista general de minimapa de resumen plegable en la esquina del mapa principal que se puede usar como ubicación de referencia y para navegar (arrastrando el cursor). GOverviewMapControl crea una vista general del mapa con un borde negro de un píxel. Nota: Unlike other controls, you can only place this control in the bottom right corner of the map (G_ANCHOR_BOTTOM_RIGHT).
|
La clase GMapTypeControl proporciona un control para seleccionar tipos de mapas admitidos y pasar de uno a otro a través de botones. Tendrás disponibles controles para todos los tipos de mapas que haya adjuntos al mapa en el momento de construir el control.
De forma predeterminada, los mapas admiten un conjunto de tipos de mapas G_DEFAULT_MAP_TYPES; los mapas pueden también agregar tipos de mapas de forma explícita mediante GMap2.addMapType(). Para conservar espacio en el mapa, en su lugar puedes utilizar GHierarchicalMapTypeControl para mostrar tipos de mapa "anidados" o GMenuMapTypeControl para mostrar un menú desplegable con los tipos de mapa.
| Constructor | Descripción |
|---|---|
GMapTypeControl(useShortNames?:Boolean)
|
Crea una clase GMapTypeControl para los tipos de mapa con los nombres largos de forma predeterminada y los nombres cortos (alt) si useShortNames se define en "true". |
Una clase GMenuMapTypeControl proporciona un control para seleccionar tipos de mapas admitidos y pasar de uno a otro mediante un menú desplegable. Tendrás disponibles controles para todos los tipos de mapas que haya adjuntos al mapa en el momento de construir el control.
De forma predeterminada, los mapas admiten un conjunto de tipos de mapas G_DEFAULT_MAP_TYPES; los mapas pueden también agregar tipos de mapas de forma explícita mediante GMap2.addMapType().
| Constructor | Descripción |
|---|---|
GMenuMapTypeControl(useShortNames?:Boolean)
|
Crea una clase GMenuMapTypeControl para los tipos de mapa con los nombres largos de forma predeterminada y los nombres cortos (alt) si useShortNames se define en "true". |
GHierarchicalMapTypeControl proporciona un control de tipo de mapa "anidado" para seleccionar tipos de mapas admitidos y pasar de uno a otro mediante botones y casillas de verificación anidadas. Tendrás disponibles controles para todos los tipos de mapas que haya adjuntos al mapa en el momento de construir el control.
Los tipos de mapas agregados al mapa aparecen como botones, como con la clase normal GMapTypeControl. No obstante, los tipos de mapas definidos como subtipos de otros tipos de mapa (consulta el método addRelationship() más abajo), aparecerán como elementos de submenú con casilla de verificación bajo el botón principal.
De forma predeterminada, los mapas admiten el conjunto de G_DEFAULT_MAP_TYPES, aunque los mapas también pueden añadir tipos de mapa de forma explícita a través de GMap2.addMapType(). Tendrás disponibles controles para todos los tipos de mapas que haya adjuntos al mapa en el momento de construir el control. Ten en cuenta que, dado que los subtipos aparecen como casillas de verificación, puedes hacer que aparezcan con sus tipos principales o secundarios dentro del submenú, o viceversa.
| Constructor | Descripción |
|---|---|
GHierarchicalMapTypeControl()
|
Construye el control. De forma predeterminada, el tipo de mapa G_HYBRID_MAP se convierte en elemento secundario del tipo de mapa G_SATELLITE_MAP. Si no desea hacer esto, puede ejecutar el método clearRelationships() para eliminar esta relación. |
| Método | Valor devuelto | Descripción |
|---|---|---|
addRelationship(parentType:GMapType,
childType:GMapType,
childText?:String,
isDefault?:Boolean)
|
None |
Registra una relación padre/hijo entre tipos de mapa con el control. Si se indica childText, se mostrará junto a la casilla de verificación correspondiente al tipo de mapa secundario en lugar de su nombre. Si se estable el valor "true" en isDefault, se seleccionará el tipo de mapa secundario de forma predeterminada. Ten en cuenta que, antes de agregar el control, deberás haber configurado todas las relaciones. Si agregas las relaciones después de haber añadido el control, el efecto será nulo.(A partir de la versión 2,94). |
removeRelationship(mapType:GMapType)
|
None |
Elimina del control todas las relaciones que tengan que ver con un tipo de mapa. (A partir de la versión 2,94). |
clearRelationships()
|
None |
Elimina del control todas las relaciones. (A partir de la versión 2,94). |
Google proporciona algunos tipos de mapa predefinidos. Esta clase se utiliza para definir los personalizados. Para poder mostrarlos en un mapa, utiliza el constructor GMap2 o el método GMap2.addMapType(). Consulta también GTileLayerOverlay para agregar capas de mosaicos al mapa (en lugar de hacer una sustitución total).
Esta clase también puede utilizarse como subclase. Se pueden omitir los argumentos del constructor si se inicializa como prototipo. Un constructor de subclase debe invocar al constructor de GMapType mediante call().
| Constructor | Descripción |
|---|---|
GMapType(layers:GTileLayer[],
projection:GProjection,
name:String,
opts?:GMapTypeOptions)
|
Construye un tipo de mapa con las capas de mosaico que se indiquen, la proyección, los nombres y los parámetros opcionales. |
Generalmente es el mapa al que se pasa este tipo de mapa el que llama a estos métodos, aunque también se puede llamar a algunos métodos desde fuera del mapa. Por ejemplo, getBoundsZoomLevel().
| Método | Valor devuelto | Descripción |
|---|---|---|
getSpanZoomLevel(center:GLatLng,
span:GLatLng,
viewSize:GSize)
|
Number |
Devuelve al mapa el nivel de acercamiento en el que la sección del mapa definida por las opciones "center" y "span" se ajustan a la vista del mapa del tamaño indicado en píxeles. |
getBoundsZoomLevel(bounds:GLatLngBounds,
viewSize:GSize)
|
None |
Devuelve al mapa el nivel de acercamiento en el que la sección del mapa definida por "bounds" se ajusta a la vista del mapa del tamaño indicado en píxeles. |
getName(short?:Boolean)
|
String |
Devuelve al mapa el nombre del tipo de mapa que ha de utilizarse como etiqueta de botón en GMapTypeControl. |
getProjection()
|
GProjection |
Devuelve al mapa la proyección del tipo de mapa en cuestión. |
getTileSize()
|
Number |
Devuelve al mapa el tamaño en píxeles del mosaico de mapa correspondiente al tipo de mapa concreto. Se entiende que los mosaicos tienen valores cuadráticos. Todas las capas de mosaico tienen el mismo tamaño de tesela. |
getTileLayers()
|
GTileLayer[] |
Devuelve al mapa la matriz de capas de mosaico. |
getMinimumResolution()
|
Number |
Devuelve al mapa el nivel de acercamiento más bajo en el que está definido el tipo de mapa en cuestión. |
getMaximumResolution()
|
Number |
Devuelve al mapa el nivel de acercamiento más alto en el que está definido el tipo de mapa en cuestión. |
getTextColor()
|
String |
Devuelve al mapa el mejor color para el texto superpuesto en el mapa. Se utiliza para el color del texto de los mensajes de derechos de autor que muestra el control de derechos de autor. |
getLinkColor()
|
String |
Devuelve al mapa el mejor color para los hiperenlaces superpuestos en el mapa. Se utiliza para el color del enlace de las condiciones del servicio que muestra el control de derechos de autor. |
getErrorMessage()
|
String |
Devuelve al mapa el mensaje de error que se muestra en áreas o niveles de acercamiento donde el tipo de mapa en cuestión no tiene mosaicos. |
getCopyrights(bounds:GLatLngBounds,
zoom:Number)
|
String[] |
Devuelve al mapa los mensajes de derechos de autor correspondientes para la región descrita por bounds en el nivel de zoom especificado. Lo utiliza el mensaje de derechos de autor en el mapa. |
getUrlArg()
|
String |
Devuelve al mapa un valor que se usa como valor de parámetro URL para identificar al tipo de mapa en cuestión en enlaces permanentes a la vista de mapa en uso. Actualmente sólo lo usa la aplicación de mapas. |
getAlt()
|
String |
Devuelve al mapa el texto alternativo del tipo de mapa en cuestión. (A partir de la versión 2,86). |
| Constante | Descripción |
|---|---|
G_NORMAL_MAP
|
Este tipo de mapa (el predeterminado) muestra un callejero normal. |
G_SATELLITE_MAP
|
Este tipo de mapa muestra imágenes por satélite. |
G_HYBRID_MAP
|
Este tipo de mapa muestra una capa transparente de calles principales en imágenes por satélite. |
G_PHYSICAL_MAP
|
Este tipo de mapa muestra mapas con ciertos rasgos físicos, como el relieve y la vegetación. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. (A partir de la versión 2,94). |
G_MOON_ELEVATION_MAP
|
Este tipo de mapa muestra un mapa del relieve con sombras de la superficie de la Luna, codificado por altitudes mediante diferentes colores. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. (A partir de la versión 2,95). |
G_MOON_VISIBLE_MAP
|
Este tipo de mapa muestra fotografías tomadas desde la órbita alrededor de la Luna. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. (A partir de la versión 2,95). |
G_MARS_ELEVATION_MAP
|
Este tipo de mapa muestra un mapa del relieve con sombras de la superficie de Marte, codificada por altitudes mediante diferentes colores. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. (A partir de la versión 2,95). |
G_MARS_VISIBLE_MAP
|
Este tipo de mapa muestra fotografías tomadas desde la órbita alrededor de Marte. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. (A partir de la versión 2,95). |
G_MARS_INFRARED_MAP
|
Este tipo de mapa muestra un mapa de infrarrojos con sombras de la superficie de Marte, donde las áreas más calientes aparecen más brillantes y las más frías más oscuras.
(A partir de la versión 2,95). |
G_SKY_VISIBLE_MAP
|
Este tipo de mapa muestra un mosaico del firmamento que cubre la totalidad de la esfera celeste.
(A partir de la versión 2,95). |
G_SATELLITE_3D_MAP
|
Este tipo de mapa, junto con el complemento de navegación de Google Earth, muestra un modelo 3D totalmente interactivo de la Tierra con imágenes de satélites. Este tipo de mapa no se muestra dentro de los controles de tipo de mapa de forma predeterminada. Si añades este tipo de mapa a tu mapa, no sólo se añadirá un control para Google Earth, sino que también se controlará la inicialización del tipo de mapa cuando un usuario haga clic en el control. Si un usuario no tiene instalado en su navegador el complemento de Google Earth, la primera vez que un usuario seleccione este tipo de mapa, se mostrará un mensaje indicando al usuario que debe descargar e instalar el complemento y reiniciar el navegador. Si el usuario ya ha instalado el complemento, al seleccionar este tipo de mapa se creará una instancia de Google Earth para el mapa y se mostrará una vista en 3D de la Tierra. Puede utilizar GMap2.getEarthInstance() para recuperar esta instancia de Google Earth y manipularla con el API de Google Earth. Actualmente, los marcadores, las ventanas de información y las polilíneas funcionan con este tipo de mapa en 3D, pero otras funciones aún no son compatibles. Entre nuestros planes se encuentra el añadir más funciones en futuras versiones. (A partir de la versión 2,113). |
G_DEFAULT_MAP_TYPES
|
Un conjunto de los primeros tres tipos predefinidos de mapas descritos anteriormente (G_NORMAL_MAP, G_SATELLITE_MAP y G_HYBRID_MAP). |
G_MOON_MAP_TYPES
|
Un conjunto de los dos tipos de luna definidos anteriormente (G_MOON_ELEVATION_MAP y G_MOON_VISIBLE_MAP). |
G_MARS_MAP_TYPES
|
Un conjunto de los tres tipos de mapas de Marte definidos anteriormente (G_MARS_ELEVATION_MAP, G_MARS_VISIBLE_MAP y G_MARS_INFRARED_MAP). |
G_SKY_MAP_TYPES
|
Un conjunto del mapa del cielo definido anteriormente (G_SKY_VISIBLE_MAP). |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se agregan derechos de autor nuevos a la recopilación de derechos de autor de una de las capas de mosaico que incluye el tipo de mapa en cuestión. |
Las instancias de esta clase se utilizan como el argumento opts? para el constructor GMapType. No hay constructor para esta clase. En su lugar, las instancias de esta clase se crean como un objeto literal de JavaScript.
| Propiedad | Tipo | Descripción |
|---|---|---|
shortName
|
String |
Define el nombre corto del tipo de mapa que se devuelve desde GMapType.getName(true). El valor predeterminado es el mismo que name. |
urlArg
|
String |
Define el argumento url del tipo de mapa que se devuelve desde GMapType.getUrlArg(). El valor predeterminado es la cadena vacía. |
maxResolution
|
Number |
Define el nivel máximo de acercamiento de este tipo de mapa que devuelve GMapType.getMaximumResolution(). El valor predeterminado es el máximo de todas las capas de mosaico. |
minResolution
|
Number |
Define el nivel mínimo de acercamiento de este tipo de mapa que devuelve GMapType.getMinimumResolution(). El valor predeterminado es el mínimo de todas las capas de mosaico. |
tileSize
|
Number |
Define el tamaño de mosaico que devuelve GMapType.getTileSize(). El valor predeterminado es "256". |
textColor
|
String |
Define el color de texto que devuelve GMapType.getTextColor(). El valor predeterminado es ""black"". |
linkColor
|
String |
Define el color de texto que devuelve GMapType.getLinkColor(). El valor predeterminado es ""#7777cc"". |
errorMessage
|
String |
Define el mensaje de error que devuelve GMapType.getErrorMessage(). El valor predeterminado es la cadena vacía. |
alt
|
String |
Define el texto alternativo para el tipo de mapa que devuelve GMapType.getAlt(). El valor predeterminado es la cadena vacía.(A partir de la versión 2,64). |
radius
|
Number |
Establece el radio del tipo de mapa según el número Number medido en metros. El valor predeterminado es 6378137, el radio del ecuador de la Tierra en metros.(A partir de la versión 2,89). |
Esta clase activa una superposición de "capa" predefinida formada por un conjunto de elementos relacionados. Implementa la interfaz de GOverlay y después se agrega al mapa mediante el método GMap2.addOverlay().
| Constructor | Descripción |
|---|---|
GLayer(layerId:String)
|
Crea una capa que utiliza la ID de capa única especificada. http://spreadsheets.google.com/pub?key=p9pdwsai2hDN-cAocTLhnag contiene una lista de las capas admitidas actualmente. |
| Método | Valor devuelto | Descripción |
|---|---|---|
hide()
|
None |
Oculta esta superposición de modo que no sea visible pero manteniendo su posición en la pila de superposiciones. |
show()
|
None |
Muestra una superposición GLayer anteriormente oculta. |
| Método | Valor devuelto | Descripción |
|---|---|---|
GLayer.isHidden(layerId:String)
|
None |
Devuelve true si la superposición de capa está oculta o no se ha añadido al mapa mediante el método GMap2.addOverlay(). Si no, devuelve false. |
Implementar esta interfaz sirve para poder proporcionar capas de mosaico de mapa personalizadas, bien a través de GMapType o de GTileLayerOverlay. Tu implementación de esta interfaz debe utilizar una instancia de GTileLayer como prototipo, ya que así se implementa automáticamente la gestión de los avisos de derechos de autor.
| Constructor | Descripción |
|---|---|
GTileLayer(copyrights:GCopyrightCollection,
minResolution:Number,
maxResolution:Number,
options?:GTileLayerOptions)
|
Se pueden omitir los argumentos del constructor si se inicializa como prototipo. Un constructor de subclase debe invocar a este constructor con call(). El parámetro opcional options especifica un juego de opciones GTileLayerOptions que deben pasarse como un objeto literal. |
El mapa y el tipo de mapa al que se pasa esta capa de mosaico llaman a estos métodos. Es necesario implementar los métodos marcados como abstractos al implementar una capa de mosaico personalizada.
| Método | Valor devuelto | Descripción |
|---|---|---|
minResolution()
|
Number |
Devuelve al tipo de mapa el nivel de acercamiento más bajo de la capa de mosaico en cuestión. |
maxResolution()
|
Number |
Devuelve al tipo de mapa el nivel de acercamiento más elevado de la capa de mosaico en cuestión. |
getTileUrl(tile:GPoint,
zoom:Number)
|
String |
Abstracto. Devuelve al mapa la URL del mosaico del mapa con los índices de mosaico según las propiedades x e y de GPoint y según el nivel de zoom especificado. |
isPng()
|
Boolean |
Abstracto. Determina si los mosaicos del mapa utilizarán el formato de imagen PNG y, por tanto, pueden ser transparentes. Si no, se entiende que el formato es GIF. |
getOpacity()
|
Number |
Abstracto. Devuelve al mapa la opacidad con la que se mostrará esta capa de mosaico. 1.0 es opaca y 0.0 transparente. |
getCopyright(bounds:GLatLngBounds,
zoom:Number)
|
String |
Abstracto. Devuelve al mapa los mensajes de derechos de autor para esta capa de mosaico que son pertinentes para la región de mapa especificada en el nivel de zoom especificado. Se utiliza para generar el mensaje de derechos de autor de GMapType al que pertenece la capa de mosaico.(A partir de la versión 2,89). |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se añaden nuevos derechos de autor a la recopilación de derechos de autor de la capa de mosaico. |
Esta clase representa argumentos opcionales para la interfaz GTileLayer. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
opacity
|
Number |
Define la opacidad del mosaico entre 0.0 (invisible) y 1.0 (opaca). El valor predeterminado es 1.0. |
isPng
|
Boolean |
Indica si las teselas están o no en formato PNG. |
tileUrlTemplate
|
String |
Especifica una plantilla para las URL de las teselas que se ampliará cuando las solicitudes de teselas hagan referencia a una tesela única basada en un sistema de coordenadas de teselas existente. Colocar una plantilla en el constructor GTileLayer te permite recuperar teselas dinámicamente con este sistema de coordenadas, parecido a la forma en que Google Maps recupera teselas. Las plantillas deben seguir la siguiente forma: http://host/tile?x={X}&y={Y}&z={Z}.png donde X e Y hacen referencia a las coordenadas latitudinal y longitudinal y Z al nivel de zoom. Por ejemplo. http://host/tile?x=3&y=27&z=5.png. |
draggingCursor
|
String |
El cursor que se debe mostrar mientras se está arrastrando el mapa. (A partir de la versión 2,59). |
GTileLayerOverlay aumenta el mapa con un valor GTileLayer. Implementa la interfaz de GOverlay y después se agrega al mapa mediante el método GMap2.addOverlay(). GTileLayer se coloca encima de las imágenes que ya existen en el mapa. Si en lugar de esto, prefieres sustituirlas, coloca GTileLayer dentro de una clase GMapType personalizada.
| Constructor | Descripción |
|---|---|
GTileLayerOverlay(tileLayer:GTileLayer,
opts?:GTileLayerOverlayOptions)
|
Crea una clase GOverlay que contendrá el valor de tileLayer.(A partir de la versión 2,61). |
| Método | Valor devuelto | Descripción |
|---|---|---|
hide()
|
None |
Oculta esta superposición de modo que no sea visible pero manteniendo su posición en la pila de superposiciones. (A partir de la versión 2,71). |
isHidden()
|
None |
Devuelve true si la superposición de capa de mosaico está oculta. Si no, devuelve false.(A partir de la versión 2.87). |
show()
|
None |
Muestra una superposición anteriormente oculta GTileLayerOverlay.(A partir de la versión 2,71). |
refresh()
|
None |
Vuelve a cargar todos los mosaicos visibles adjuntos a GTileLayerOverlay.(A partir de la versión 2,132). |
supportsHide()
|
None |
Siempre devuelve true.(A partir de la versión 2.87). |
getTileLayer()
|
None |
Devuelve la capa de mosaico que utiliza la superposición. (A partir de la versión 2,83). |
Esta clase representa argumentos opcionales para el constructor de GTileLayerOverlayOptions. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
zPriority
|
Number |
zPriority contiene un valor que determina el orden Z relativo a TileLayerOverlay. Las capas de mosaico de mayor prioridad se representarán sobre las capas de mosaico con una prioridad inferior.(A partir de la versión 2,110). |
Esta clase sirve para gestionar mensajes de derechos de autor que aparecen en mapas de tipo personalizado. Si no implementas tipos de mapas personalizados, no necesitas utilizar esta clase. Las recopilaciones de derechos de autor contienen información acerca de qué derechos de autor se deben mostrar según la región del mapa y el nivel de acercamiento. Esto es muy importante en los tipos de mapas con datos heterogéneos, como los mapas por satélite.
| Constructor | Descripción |
|---|---|
GCopyrightCollection(prefix?:String)
|
Los mensajes de derechos de autor que se generen a partir de esta recopilación de derechos de autor tendrán el prefijo común que se haya indicado como argumento. Example: "Imagery (C) 2006" |
| Método | Valor devuelto | Descripción |
|---|---|---|
addCopyright(copyright:GCopyright)
|
None |
Agrega un objeto de información de derechos de autor a la recopilación. |
getCopyrights(bounds:GLatLngBounds,
zoom:Number)
|
String[] |
Devuelve todas las cadenas de derechos de autor pertinentes para una región del mapa en un nivel de acercamiento concreto. Example: [ "Google", "Keyhole" ]. |
getCopyrightNotice(bounds:GLatLngBounds,
zoom:Number)
|
String |
Devuelve el prefijo y todas las cadenas de derechos de autor pertinentes para una región del mapa en un nivel de acercamiento concreto. Example: "Imagery (C) 2006 Google, Keyhole". |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se agregan derechos de autor nuevos a la recopilación de derechos de autor en cuestión. |
Los objetos de derechos de autor contienen información acerca de qué mensajes de derechos de autor se aplican a las diferentes regiones del mapa divididas en rectángulos, en determinados niveles de acercamiento. Sólo necesitas este objeto si vas a implementar tipos de mapa o capas de mosaico personalizados.
| Constructor | Descripción |
|---|---|
GCopyright(id:Number,
bounds:GLatLngBounds,
minZoom:Number,
text:String)
|
Crea un objeto de información de derechos de autor con las propiedades indicadas. |
| Propiedad | Tipo | Descripción |
|---|---|---|
id
|
Number |
Un identificador único para la información de derechos de autor concreta. |
minZoom
|
Number |
El nivel de acercamiento más bajo en el que se aplica esta información. |
bounds
|
GLatLngBounds |
La región a la que se aplica esta información. |
text
|
String |
El texto del mensaje de derechos de autor. |
Esta es la interfaz para proyecciones de mapas. Se pasa una instancia de proyección de mapa al constructor de GMapType. Esta interfaz se implementa mediante class GMercatorProjection, clase que utilizan todos los tipos de mapa predefinidos. Puedes implementar esta interfaz si quieres definir tipos de mapa con diferentes proyecciones de mapa.
El mapa llama a estos métodos y tú los implementas.
| Método | Valor devuelto | Descripción |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Devuelve coordenadas de mapa en píxeles para un punto en las coordenadas geográficas y el nivel de acercamiento en cuestión. |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Devuelve coordenadas geográficas para un punto en las coordenadas del mapa en píxeles y el nivel de acercamiento en cuestión. La marca unbounded hace que la coordenada de longitud no se envuelva cuando se sobrepase el meridiano de -180 o 180 grados. |
tileCheckRange(tile:GPoint,
zoom:Number,
tilesize:Number)
|
Boolean |
Vuelve al mapa si el índice de mosaicos está en un intervalo válido para el tipo de mapa. Si no, el mapa mostrará un mosaico vacío. También puede modificar el índice tile para que apunte a otra instancia del mismo mosaico en caso de que el mapa contenga más de una copia de la Tierra, y por lo tanto el mismo mosaico esté en diferentes coordenadas. |
getWrapWidth(zoom:Number)
|
Number |
Devuelve al mapa la periodicidad en la dirección x, es decir, el número de píxeles después del cual el mapa se repite a sí mismo porque dio la vuelta una vez alrededor de la Tierra. De forma predeterminada, devuelve Infinity, es decir, que el mapa no se repetirá a sí mismo. El mapa utiliza esto para calcular la colocación de superposiciones en las vista de mapa que incluyan más de una copia de la Tierra (generalmente esto sólo sucede en los niveles de acercamiento bajos).(A partir de la versión 2,46). |
Todos los tipos de mapas predefinidos utilizan esta implementación de la interfaz GProjection para la proyección de Mercator.
| Constructor | Descripción |
|---|---|
GMercatorProjection(zoomlevels:Number)
|
Crea una proyección de Mercator para el número de niveles de acercamiento que se indiquen. |
| Método | Valor devuelto | Descripción |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Consulta GProjection. |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Consulta GProjection. |
tileCheckRange(tile:GPoint,
zoom:Number,
tilesize:Number)
|
None |
Consulta GProjection. |
getWrapWidth(zoom:Number)
|
None |
Consulta GProjection. La proyección de Mercator es periódica en la dirección longitudinal, por lo que esta clase devuelve la anchura del mapa de la Tierra completa en píxeles en el nivel de acercamiento en cuestión.(A partir de la versión 2,46). |
Este espacio de nombres contiene funciones que se utilizan para registrar gestores de eventos, tanto para eventos personalizados como para eventos DOM, así como para activar eventos personalizados. Todos los eventos definidos por esta API son eventos personalizados que activa internamente GEvent.trigger().
| Método | Valor devuelto | Descripción |
|---|---|---|
GEvent.addListener(source:Object,
event:String,
handler:Function)
|
GEventListener |
Registra un gestor de eventos para un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del gestor. Se llamará al gestor de eventos con this definido en el objeto de origen. |
GEvent.addDomListener(source:Node,
event:String,
handler:Function)
|
GEventListener |
Registra un gestor de eventos para un evento DOM en el objeto de origen. El objeto de origen debe ser un nodo DOM. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del gestor. Se llamará al gestor de eventos con this definido en el objeto de origen. Esta función utiliza los métodos DOM para el navegador en uso para poder registrar el gestor de eventos. |
GEvent.removeListener(handle:GEventListener)
|
None |
Elimina un gestor instalado con addListener() o con addDomListener(). |
GEvent.clearListeners(source:Object or Node,
event:String)
|
None |
Elimina todos los gestores en el objeto indicado para el evento en cuestión que se instalaron con addListener() o con addDomListener(). |
GEvent.clearInstanceListeners(source:Object or Node)
|
None |
Elimina todos los gestores en el objeto indicado para todos los eventos que se instalaron con addListener() o con addDomListener(). |
GEvent.clearNode(source:Node)
|
None |
Llama repetidamente a clearInstanceListeners en un nodo y en todos sus nodos hijos. |
GEvent.trigger(source:Object,
event:String,
...)
|
None |
Activa un evento personalizado en el objeto de origen. El resto de los argumentos opcionales después de event se pasan a su vez como argumentos a las funciones del gestor de eventos. |
GEvent.bind(source:Object,
event:String,
object:Object,
method:Function)
|
GEventListener |
Registra una invocación del método en el objeto indicado como el gestor de eventos para un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del gestor. |
GEvent.bindDom(source:Node,
event:String,
object:Object,
method:Function)
|
GEventListener |
Registra una invocación del método en el objeto indicado como el gestor de eventos para un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del gestor. |
GEvent.callback(object:Object,
method:Function)
|
Function |
Devuelve un cierre que llama a method en object. |
GEvent.callbackArgs(object:Object,
method:Function,
...)
|
Function |
Devuelve un cierre que llama a method en object. Los argumentos opcionales restantes después de method se transmiten uno a uno como argumentos method cuando se ejecuta la función devuelta. |
| Evento | Descripción |
|---|---|
clearlisteners(event?:String)
|
Este evento se activa en el objeto cuando se llama a clearListeners() o a clearInstanceListeners() en ese objeto. Por supuesto, este evento se activa antes de que se ejecuten las funciones. |
Esta clase es opaca, no tiene ni métodos ni constructor. Sus instancias vienen de GEvent.addListener() o GEvent.addDomListener() y terminan volviéndose a pasar a GEvent.removeListener().
Este espacio de nombres proporciona un método predeterminado para crear instancias de XmlHttpRequest con independencia del navegador.
| Método | Valor devuelto | Descripción |
|---|---|---|
GXmlHttp.create()
|
GXmlHttp |
Método predeterminado para crear una instancia nueva de XmlHttpRequest. |
Este espacio de nombres proporciona métodos estáticos para gestionar documentos XML y fragmentos de documentos.
| Método | Valor devuelto | Descripción |
|---|---|---|
GXml.parse(xmltext:String)
|
Node |
Analiza la cadena en cuestión como texto XML y devuelve una representación DOM. Si el navegador no admite analizar el texto XML de forma nativa, se devuelve el nodo DOM de un elemento DIV vacío. |
GXml.value(xmlnode:Node)
|
String |
Devuelve el valor de texto (es decir, sólo el contenido de texto sin formato) del fragmento de documento XML en cuestión en una representación DOM. |
Esta clase proporciona métodos para aplicar XSLT a XML con independencia del navegador.
| Método | Valor devuelto | Descripción |
|---|---|---|
GXslt.create(xsltnode:Node)
|
GXslt |
Crea una instancia de GXslt a partir de la hoja de estilo XSLT indicada como representación DOM. |
GXslt.transformToHtml(xmlnode:Node,
htmlnode:Node)
|
Boolean |
Utiliza la hoja de estilo XSLT indicada en el constructor de esta instancia GXslt para transformar el documento XML en cuestión en representación DOM en xmlnode. Anexa el fragmento de documento HTML resultante al nodo htmlnode especificado. Esto sólo funciona si el navegador admite por su lado transformaciones XSL, en cuyo caso devolverá true. Si no, esta función no hará nada y devolverá false. |
Este espacio de nombres contiene algunos métodos estáticos para ayudarte a depurar aplicaciones web. La primera vez que se usa uno de los métodos write*(), se abre en la pagina una ventana flotante con los mensajes escritos.
| Método | Valor devuelto | Descripción |
|---|---|---|
GLog.write(message:String,
color?:String)
|
None |
Escribe el mensaje en texto sin formato en la ventana de registro. Las marcas HTML deben llevar caracteres de salida para que se puedan ver como caracteres normales. |
GLog.writeUrl(url:String)
|
None |
Escribe un enlace a una URL en cuestión en la ventana de registro. |
GLog.writeHtml(html:String)
|
None |
Escribe texto como HTML en la ventana de registro. |
Esta clase hace que un elemento DOM se pueda arrastrar. Los miembros estáticos para cambiar los cursores de arrastre afectan a todos los objetos arrastrables creados posteriormente, como el mapa, la barra deslizante para el control de acercamiento y los rectángulos de mapa de vista general. Los miembros por instancia (dinámicos) afectan sólo a su instancia particular. Por ejemplo, antes de crear el mapa, puedes llamar a GDraggableObject.setDraggableCursor('default') y GDraggableObject.setDraggingCursor('move') para obtener el estilo 2.56 pre-API. Otra posibilidad es que el constructor del mapa tome opciones para definir su estilo de cursor DraggableObject. Consulta los valores de cursor permitidos en la especificación W3C CSS.
| Constructor | Descripción |
|---|---|
GDraggableObject(src:Node,
opts?:GDraggableObjectOptions)
|
Configura gestores de eventos de modo que se pueda arrastrar el elemento de origen. Hacia la izquierda y hacia arriba son colocaciones opcionales del elemento y el contenedor opcional sirve como cuadro de límites.
(A partir de la versión 2,59). |
| Método | Valor devuelto | Descripción |
|---|---|---|
GDraggableObject.setDraggableCursor(cursor:String)
|
None |
Define el cursor arrastrable para objetos arrastrables que se creen después. (A partir de la versión 2,59). |
GDraggableObject.setDraggingCursor(cursor:String)
|
None |
Define el cursor de arrastre para objetos arrastrables que se creen después. (A partir de la versión 2,59). |
GDraggableObject.getDraggingCursor()
|
String |
Devuelve el cursor de arrastre en uso en el mapa. Si no se define mediante el método estático setDraggingCursor(), devuelve el cursor predeterminado que utiliza el mapa en sus controles y marcadores.
(A partir de la versión 2.87). |
GDraggableObject.getDraggableCursor()
|
String |
Devuelve el cursor arrastrable en uso en el mapa. Si no se define mediante el método estático setDraggableCursor(), devuelve el cursor predeterminado que utiliza el mapa en sus controles y marcadores.
(A partir de la versión 2.87). |
| Método | Valor devuelto | Descripción |
|---|---|---|
setDraggableCursor(cursor:String)
|
None |
Define el cursor cuando el ratón está encima del objeto arrastrable. (A partir de la versión 2,59). |
setDraggingCursor(cursor:String)
|
None |
Define el cursor cuando se mantiene pulsado el ratón y se arrastra el objeto arrastrable. (A partir de la versión 2,59). |
moveTo(point:GPoint)
|
None |
Desplaza GDraggableObject a una posición absoluta concreta. La posición en coordenadas de píxeles relativa al nodo padre. Este método utiliza el sistema de coordenadas DOM, es decir, que la coordenada X aumenta hacia la izquierda y la Y aumenta hacia abajo.(A partir de la versión 2,89). |
moveBy(size:GSize)
|
None |
Mueve GDraggableObject el tamaño de desplazamiento indicado. Este método utiliza el sistema de coordenadas DOM, es decir, que la anchura aumenta hacia la izquierda y la altura aumenta hacia abajo.(A partir de la versión 2,89). |
| Evento | Descripción |
|---|---|
mousedown()
|
Este evento se activa en respuesta al evento DOM mousedown. La gestión de este evento evitará que se produzca la acción predeterminada del evento DOM mousedown.(A partir de la versión 2,84). |
mouseup()
|
Este evento se activa en respuesta al evento DOM mouseup en un objeto arrastrable. La gestión de este evento evitará que se produzca la acción predeterminada del evento DOM mouseup.(A partir de la versión 2,84). |
click()
|
Este evento se activa cuando se hace clic en un objeto arrastrable. (A partir de la versión 2,84). |
dragstart()
|
Este evento se activa en el inicio de un evento de arrastre de un objeto arrastrable (cuando el usuario empieza a arrastrar un objeto arrastrable haciendo clic en él y arrastrándolo). (A partir de la versión 2,84). |
drag()
|
Este evento se activa repetidamente cuando el usuario arrastra el objeto arrastrable. (A partir de la versión 2,84). |
dragend()
|
Este evento se activa al final de un evento de arrastre de un objeto arrastrable (cuando el usuario deja de arrastrar el objeto). (A partir de la versión 2,84). |
Esta clase representa argumentos opcionales para el constructor de GDraggableObject. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
left
|
Number |
La posición de inicio a la izquierda del objeto. (A partir de la versión 2,59). |
top
|
Number |
La posición de inicio superior del objeto. (A partir de la versión 2,59). |
container
|
Node |
Un elemento DOM que actuará como cuadro delimitador para el objeto arrastrable. (A partir de la versión 2,59). |
draggableCursor
|
String |
El cursor que aparece al pasar el ratón. (A partir de la versión 2,59). |
draggingCursor
|
String |
El cursor que aparece al arrastrar. (A partir de la versión 2,59). |
delayDrag
|
Boolean |
De forma predeterminada, se activa el evento dragstart cuando se activa el elemento DOM mousedown en un elemento DOM arrastrable. De forma parecida, se activa el evento dragend cuando se activa el evento DOM mouseup. Al definir este valor en true, se retrasan los eventos de arrastre hasta que se mueve el ratón del lugar en el que se generó el evento mousedown o mouseup. El valor predeterminado para esta propiedad es false.
(A partir de la versión 2,84). |
Los equivalentes numéricos de cada constante simbólica se especifican entre paréntesis.
| Constante | Descripción |
|---|---|
G_GEO_SUCCESS |
No se han producido errores, la dirección se analizó correctamente y se devolvió su código geográfico.
(A partir de la versión 2,55). |
G_GEO_BAD_REQUEST |
No se ha podido analizar correctamente la solicitud de ruta. Por ejemplo, la solicitud se puede haber rechazado si contenía más del número máximo de hitos permitidos.
(A partir de la versión 2,81). |
G_GEO_SERVER_ERROR |
No se ha podido procesar correctamente la solicitud de ruta o de códigos geográficos, sin saberse el motivo exacto del fallo.
(A partir de la versión 2,55). |
G_GEO_MISSING_QUERY |
Falta el parámetro HTTP q o no tiene valor alguno. En las solicitudes de códigos geográficos, esto significa que se ha especificado una dirección vacía. En las solicitudes de ruta, esto significa que no se ha especificado ninguna consulta.
(A partir de la versión 2,81). |
G_GEO_MISSING_ADDRESS |
Sinónimo de G_GEO_MISSING_QUERY.
(A partir de la versión 2,55). |
G_GEO_UNKNOWN_ADDRESS |
No se ha encontrado una ubicación geográfica que se corresponda con la dirección especificada. Esto puede deberse a que la dirección sea relativamente nueva o a que no sea correcta.
(A partir de la versión 2,55). |
G_GEO_UNAVAILABLE_ADDRESS |
El código geográfico de la dirección indicada o de la ruta para la consulta de ruta proporcionada no puede devolverse por motivos jurídicos o contractuales.
(A partir de la versión 2,55). |
G_GEO_UNKNOWN_DIRECTIONS |
El objeto GDirections no pudo calcular la ruta entre los puntos mencionados en la consulta. Esto suele deberse a que no hay ninguna ruta disponible entre los dos puntos o a que no tenemos datos para extraer rutas en la región en cuestión.
(A partir de la versión 2,81). |
G_GEO_BAD_KEY |
La clave proporcionada no es válida o no coincide con el dominio para el cual se ha indicado.
(A partir de la versión 2,55). |
G_GEO_TOO_MANY_QUERIES |
La clave especificada ha superado el límite de solicitudes en un período de 24 horas o ha enviado demasiadas solicitudes en un período de tiempo demasiado breve. Si vas a enviar varias solicitudes en un bucle o en un período de tiempo muy reducido, utiliza un temporizador o pausa tu código para asegurarte de que no envías las solicitudes demasiado rápido.
(A partir de la versión 2,55). |
Esta enumeración no tiene definidas constantes simbólicas.
| Constante | Descripción |
|---|---|
0
|
Ubicación desconocida.
(A partir de la versión 2,59). |
1
|
Precisión a nivel de país.
(A partir de la versión 2,59). |
2
|
Región (estado, provincia, prefectura, etc.) precisión de nivel.
(A partir de la versión 2,59). |
3
|
Subregión (condado, municipalidad, etc.) municipalidad, etc.)
(A partir de la versión 2,59). |
4
|
Precisión a nivel de ciudad o pueblo.
(A partir de la versión 2,59). |
5
|
Precisión a nivel de código postal.
(A partir de la versión 2,59). |
6
|
Precisión a nivel de calle.
(A partir de la versión 2,59). |
7
|
Precisión a nivel de intersección.
(A partir de la versión 2,59). |
8
|
Precisión a nivel de dirección.
(A partir de la versión 2,59). |
9
|
Instalaciones (nombre del edificio, nombre de la propiedad, centro comercial, etc.) municipalidad, etc.)
(A partir de la versión 2,105). |
Esta clase se utiliza para comunicarse directamente con los servidores de Google con objeto de obtener códigos geográficos para las direcciones que especifique el usuario. Además, los códigos geográficos mantienen su propia memoria caché de direcciones, con lo cual se pueden responder consultas repetidas sin tener que volver a ir al servidor. En general, no es recomendable utilizar GClientGeocoder funciones en un bucle. Los desarrolladores que quieran establecer los códigos geográficos de varias direcciones probablemente deban utilizar nuestro geocoder HTTP.
| Constructor | Descripción |
|---|---|
GClientGeocoder(cache?:GGeocodeCache)
|
Crea una instancia nueva de un codificador geográfico que se comunica directamente con los servidores de Google. El parámetro de caché (cache) opcional permite especificar una memoria caché personalizada de direcciones conocidas en el lado del cliente. Si no se especifica ninguna, se utiliza GFactualGeocodeCache.
(A partir de la versión 2,55). |
| Método | Valor devuelto | Descripción |
|---|---|---|
getLatLng(address:String,
callback:function)
|
None |
Envía una solicitud a los servidores de Google para que codifique geográficamente la dirección indicada. Si se consigue ubicar la dirección correctamente, se invoca a la función de devolución de llamada especificada por el usuario con un punto GLatLng. Si no, la función de devolución de llamada recibe un punto null. En el caso de direcciones ambiguas, sólo se pasa a la función de devolución de llamada el punto de mejor coincidencia.
(A partir de la versión 2,55). |
getLocations(query:String|GLatLng,
callback:function)
|
None |
Este método permite enviar una solicitud al servicio de asignación de identificadores geográficos, solicitando el análisis de la consulta (query) especificada y gestionando la respuesta en la devolución de llamada (callback) especificada. La asignación de identificadores geográficos hace referencia a la conversación de direcciones interpretables por humanos en valores de latitud/longitud. El servicio de asignación de identificadores geográficos de Google admite la asignación inversa de códigos geográficos, en la que un punto geográfico determinado se convierte en una dirección interpretable por humanos. Para utilizar este servicio de asignación de código geográfico, ejecuta este método convirtiendo la consulta (query) a códigos geográficos. Si la consulta se proporciona como una cadena (String) localizable, el servicio creará un código geográfico estándar. Si, en cambio, la consulta (query) contiene un elemento GLatLng, el servicio creará un código geográfico inverso. Como este método necesita enviar una llamada al servidor de Google, también debes utilizar un método callback para la respuesta. Esta respuesta contendrá un código Status y, si tiene éxito, uno o varios objetos
Placemark. Al contrario que el método GClientGeocoder.getLatLng, la función de devolución de llamada puede determinar las razones del fallo examinando el campo Status.
(A partir de la versión 2,55). |
getCache()
|
GGeocodeCache |
Devuelve la memoria caché de códigos geográficos utilizada en ese momento, o null si no se está almacenando en caché del cliente.
(A partir de la versión 2,55). |
setCache(cache:GGeocodeCache)
|
None |
Define una nueva memoria caché del cliente. Si se invoca a este método con la memoria caché definida en null, se deshabilitará el almacenamiento en memoria caché del cliente. Cuando se define una memoria caché nueva, las direcciones anteriormente guardadas se borran.
(A partir de la versión 2,55). |
setViewport(bounds:GLatLngBounds)
|
None |
Define el codificador geográfico de modo que se muestren los resultados de codificación geográfica dentro o cerca de la ventana gráfica en cuestión. La ventana gráfica se expresa como un rectángulo GLatLngBounds. Ten en cuenta que definir una ventana gráfica no restringe los resultados a ese cuadro de límites, si bien los elevará según prioridad.
(A partir de la versión 2,82). |
getViewport()
|
GLatLngBounds |
Devuelve la ventana gráfica para ampliar resultados de codificación geográfica dentro del codificador geográfico en cuestión. La ventana gráfica se expresa como un rectángulo GLatLngBounds.
(A partir de la versión 2,82). |
setBaseCountryCode(countryCode:String)
|
None |
Establece que el geocoder trate los resultados de las búsquedas como si se hubieran enviado desde el dominio especificado por el dominio de nivel superior de código de país (ccTLD). La codificación geográfica sólo funciona para países en los que Google Maps admite códigos geográficos. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD de Gran Bretaña es "uk" ( Ten en cuenta que el dominio predeterminado es el dominio desde el que cargaste inicialmente el API de Google Maps. Los códigos de los países distinguen entre mayúsculas y minúsculas. (A partir de la versión 2,82). |
getBaseCountryCode()
|
String |
Devuelve el código de país en el que se está en ese momento según el codificador geográfico en cuestión. (Si no hay código de país en vigor, el método devuelve null).
(A partir de la versión 2,82). |
reset()
|
None |
Restablece el codificador geográfico. En concreto, este método llama al método GGeocodeCache.reset() en la memoria caché del lado del cliente, en caso de que el codificador geográfico utilice una.
(A partir de la versión 2,55). |
Esta clase mantiene un mapa a partir de direcciones de ubicaciones conocidas. Si bien esta clase es totalmente funcional, la idea es que sirva de clase base desde la cual derivar memorias caché más sofisticadas.
| Constructor | Descripción |
|---|---|
GGeocodeCache()
|
Crea una caché nueva para almacenar un mapa a partir de direcciones a ubicaciones. El constructor llama al método GGeocodeCache.reset de forma inmediata.
(A partir de la versión 2,55). |
| Método | Valor devuelto | Descripción |
|---|---|---|
get(address:String)
|
Object |
Devuelve la respuesta almacenada bajo el valor address indicado. Si no se ha guardado nunca una respuesta para la dirección en cuestión, este método devuelve null.
(A partir de la versión 2,55). |
isCachable(reply:Object)
|
Boolean |
Devuelve si la respuesta que se indique debe almacenarse o no en memoria caché. De forma predeterminada, se hacen comprobaciones muy rudimentarias en el objeto reply. En concreto, esta clase asegura que el objeto no sea null y que incluya el campo name. Este método se puede sobrescribir extendiendo clases para indicar condiciones más precisas en el objeto reply.
(A partir de la versión 2,55). |
put(address:String,
reply:Object)
|
None |
Almacena el valor reply indicado bajo la dirección address proporcionada. Este método llama al método GGeocodeCache.isCachable para comprobar que la respuesta reply se pueda almacenar en memoria. Si se da el visto bueno, almacena en caché la respuesta reply bajo la dirección normalizada con la ayuda del método GGeocodeCache.toCanoninical.
(A partir de la versión 2,55). |
reset()
|
None |
Depura todas las respuestas de la memoria caché. Una vez el método devuelve un valor, la memoria caché queda vacía.
(A partir de la versión 2,55). |
toCanonical(address:String)
|
String |
Devuelve lo que se considera una versión canónica de la dirección. Convierte el parámetro address a minúsculas, sustituye las comas por espacios y sustituye varios espacios por un espacio.
(A partir de la versión 2,55). |
Esta clase afina la clase básica GGeocodeCache aplicando condiciones más estrictas en las respuestas almacenadas en memoria caché. Sólo se almacenan en memoria caché respuestas con muy poca tendencia a cambiar dentro de un período de tiempo corto.
| Constructor | Descripción |
|---|---|
GFactualGeocodeCache()
|
Crea una memoria caché nueva para almacenar sólo las respuestas que considere factuales.
(A partir de la versión 2,55). |
| Método | Valor devuelto | Descripción |
|---|---|---|
isCachable(reply:Object)
|
Boolean |
Sobrescribe la implementación predeterminada de este método para realizar una comprobación más profunda del código de estado. Sólo se consideran almacenables en caché las respuestas con estado Status.code definido en G_GEO_SUCCESS o que se sepa que no son válidas. Las respuestas vencidas o que hayan dado un error general del servidor no se almacenarán en la memoria caché.
(A partir de la versión 2,55). |
Esta clase se usa para gestionar la visibilidad de cientos de marcadores en un mapa basándose en la ventana gráfica y el nivel de acercamiento en uso en el mapa. Esta clase está obsoleta; se recomienda a los desarrolladores que en su lugar utilicen MarkerManager de software libre.
| Constructor | Descripción |
|---|---|
GMarkerManager(map:GMap,
opts?:GMarkerManagerOptions)
|
Crea un gestor de marcadores nuevo que controla la visibilidad de los marcadores en el mapa que se especifique.
(A partir de la versión 2,67). |
| Método | Valor devuelto | Descripción |
|---|---|---|
addMarkers(markers:GMarker[],
minZoom:Number,
maxZoom?:Number)
|
None |
Añade un lote de marcadores a este gestor de marcadores. Los marcadores no se agregan al mapa hasta que no se llame al código refresh(). Una vez colocados en el mapa, los marcadores aparecen en él si quedan dentro de la ventana gráfica del mapa y si el nivel de acercamiento es superior o igual al valor minZoom especificado. Si se ha indicado un valor maxZoom, los marcadores se eliminarán automáticamente cuando el nivel de acercamiento en el mapa supere al nivel especificado.
(A partir de la versión 2,67). |
addMarker(marker:GMarker,
minZoom:Number,
maxZoom?:Number)
|
None |
Agrega un único marcador a una recopilación de marcadores que controla este gestor. Si la ubicación del marcador queda dentro de la ventana gráfica en uso en el mapa y el nivel de acercamiento está dentro del intervalo de niveles de acercamiento especificado, el marcador se agregará al mapa de forma inmediata. De forma parecida a lo que ocurre con el método addMarkers, los parámetros opcionales minZoom y maxZoom especifican el intervalo de niveles de acercamiento en los que se muestra el marcador.
(A partir de la versión 2,67). |
refresh()
|
None |
Fuerza al gestor a actualizar los marcadores visibles en el mapa. Es necesario llamar a este método si los marcadores se agregaron con el método addMarkers.
(A partir de la versión 2,67). |
getMarkerCount(zoom:Number)
|
Number |
Devuelve el número total de marcadores que pueden verse en potencia con el nivel de acercamiento indicado. Esto puede incluir marcadores en los niveles de acercamiento inferiores.
(A partir de la versión 2,67). |
| Evento | Descripción |
|---|---|
changed(bounds:GBounds,
markerCount:Number)
|
Este evento se activa cuando se agregan al mapa o se eliminan de él marcadores gestionados mediante un gestor. Esta función de gestor de eventos debe aceptar dos argumentos. El primero de los rectángulos que definen los límites de la cuadrícula visible. mientras que el segundo indica el número de marcadores que pueden verse en ese momento en el mapa. |
Esta clase representa argumentos opcionales para el constructor de GMarkerManager. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
borderPadding
|
Number |
Especifica, en píxeles, el desplazamiento adicional fuera de la ventana gráfica en uso en el mapa que controla un gestor. Los marcadores que queden dentro del desplazamiento adicional se agregarán al mapa, incluso aunque no queden totalmente visibles.
(A partir de la versión 2,67). |
maxZoom
|
Number |
Define el nivel máximo de acercamiento supervisado por el gestor de marcadores. Si no se indica, el gestor asume que el nivel de acercamiento utilizado es el máximo. Este valor también se emplea cuando se agregan marcadores al gestor sin el parámetro opcional maxZoom.
(A partir de la versión 2,67). |
trackMarkers
|
Boolean |
Indica si un gestor de marcadores debe o no hacer un seguimiento de los movimientos de los marcadores. Si quieres mover marcadores gestionados con el método setPoint, tendrás que definir esta opción en true. El valor predeterminado es false.
(A partir de la versión 2,67). |
Los objetos GGeoXml añaden contenido geográfico al mapa a partir de un archivo XML (como, por ejemplo, un archivo KML) alojado en un servidor web de acceso público. Implementa la interfaz de GOverlay y después se agrega al mapa mediante el método GMap2.addOverlay().
| Constructor | Descripción |
|---|---|
GGeoXml(urlOfXml:String,
callback?:function)
|
Crea una clase GOverlay que representa al archivo XML. Cuando el objeto GGeoXml termina de cargar el archivo XML, se invoca a una función de devolución de llamada opcional.
(Obsoleto desde la versión 2,108). |
GGeoXml(urlOfXml:String)
|
Crea una clase GOverlay que representa al archivo XML.
(A partir de la versión 2,108). |
| Método | Valor devuelto | Descripción |
|---|---|---|
getTileLayerOverlay()
|
GTileLayerOverlay |
En algunos casos, los objetos GGeoXml pueden crear una superposición de mosaico para una mayor optimización. Este método devuelve esta superoposición de capa de mosaico (de estar disponible). Ten en cuenta que la superposición de mosaico puede ser null si no es necesaria, o si el archivo GGeoXml todavía no ha terminado de cargarse.(A partir de la versión 2,84). |
getDefaultCenter()
|
GLatLng |
Devuelve el centro de la ventana gráfica por defecto como latitud/longitud. Sólo se debe llamar a esta función después de haber cargado el archivo.
(A partir de la versión 2,84). |
getDefaultSpan()
|
GLatLng |
Devuelve el desplazamiento de la ventana gráfica por defecto como latitud/longitud. Sólo se debe llamar a esta función después de haber cargado el archivo.
(A partir de la versión 2,84). |
getDefaultBounds()
|
GLatLngBounds |
Devuelve el cuadro de límites de la ventana gráfica predeterminada. Sólo se debe llamar a esta función después de haber cargado el archivo.
(A partir de la versión 2,84). |
gotoDefaultViewport(map:GMap2)
|
None |
Define la ventana gráfica del mapa en la predeterminada del archivo XML.
(A partir de la versión 2,84). |
hasLoaded()
|
Boolean |
Comprueba si el archivo XML ha terminado de cargarse, en cuyo caso devuelve true. Si el archivo XML todavía no ha terminado de cargarse, este método devuelve false.
(A partir de la versión 2,84). |
hide()
|
None |
Oculta las superposiciones hijas que ha creado el objeto GGeoXml si la superposición está visible en ese momento y si su método supportsHide() devuelve "true". Ten en cuenta que este método activará el evento visibilitychanged correspondiente para cada superposición hija que active ese evento (por ejemplo, GMarker.visibilitychanged, GGroundOverlay.visibilitychanged, etc.). Si no hay superposiciones visibles en ese momento que devuelvan supportsHide() como "true", este método no surtirá efecto alguno.
(A partir de la versión 2.87). |
isHidden()
|
Boolean |
Devuelve true si el objeto GGeoXml está oculto en ese momento, tal y como haya modificado el método GGeoXml.hide(). Si no, devuelve false. (A partir de la versión 2.87). |
loadedCorrectly()
|
Boolean |
Comprueba si el archivo XML se ha cargado correctamente, en cuyo caso devuelve true. Si el archivo XML no se ha cargado correctamente, este método devuelve false. Si el archivo XML todavía no ha terminado de cargarse, el método devuelve un valor no definido.
(A partir de la versión 2,84). |
show()
|
None |
Muestra las superposiciones hijas que ha creado el objeto GGeoXml, en caso de que estén ocultas en ese momento. Ten en cuenta que este método activará el evento visibilitychanged correspondiente para cada superposición secundaria que active ese evento (por ejemplo, GMarker.visibilitychanged o GGroundOverlay.visibilitychanged).
(A partir de la versión 2.87). |
supportsHide()
|
Boolean |
Siempre devuelve true.(A partir de la versión 2.87). |
| Evento | Descripción |
|---|---|
load()
|
Este evento se activa cuando el archivo XML de GGeoXml se ha cargado completamente y todas las superposiciones asociadas se han mostrado en el mapa o si el archivo XML no se cargó correctamente.(A partir de la versión 2,108). |
Esta función proporciona una cómoda forma de recuperar asincrónicamente un recurso identificado mediante una URL. Ten presente que, al utilizarse el objeto XmlHttpRequest para ejecutar la solicitud, esta queda sujeta a la restricción de igualdad de origen de la creación de secuencias de comandos entre sitios diferentes, es decir, que la URL debe hacer referencia al mismo servidor que la URL del documento en uso que ejecute este código. Así pues, a menudo resulta innecesario utilizar una URL absoluta para el argumento url y es mejor utilizar sólo una ruta absoluta o relativa. Es responsabilidad del que invoca gestionar las excepciones que puedan producirse, como por ejemplo, los errores de seguridad.
| Método | Valor devuelto | Descripción |
|---|---|---|
GDownloadUrl(url:String,
onload:Function,
postBody?:String,
postContentType?:String)
|
None |
Recupera el recurso de la URL indicada y llama a la función onload con el texto del documento como primer argumento y el código de estado de la respuesta HTTP como segundo argumento. Si la solicitud sobrepasa el tiempo límite, es posible llamar a la función "onload" en su lugar con "null" como primer argumento y "-1" como segundo. La opción predeterminada de esta función es enviar una solicitud HTTP GET. Para enviar una solicitud HTTP POST en su lugar, pasa datos dentro del argumento opcional postBody. Si los datos que se van a mandar no son del tipo "aplicación/x-www-form-urlencoded", introduce el tipo de contenido como una cadena en el argumento postContentType. Este método está sujeto a restricciones de secuencias de comandos entre diferentes sitios. Ten en cuenta que este método utiliza la implementación subyacente XmlHttpRequest del navegador. |
Esta función decide si el API de Google Maps puede utilizarse en el navegador en uso.
| Método | Valor devuelto | Descripción |
|---|---|---|
GBrowserIsCompatible()
|
Boolean |
Devuelve true si el navegador en uso es compatible con la biblioteca del API de Google Maps. |
Esta función hace que el API de Google Maps limpie estructuras de datos internas para liberar memoria. Esto te puede ayudar a solucionar algunos problemas con el navegador que pueden provocar pérdidas de memoria en aplicaciones web. Es el gestor de eventos unload de la página el que llama a esta función. Cuando se haya llamado a esta función, los objetos del mapa creados en la página dejarán de funcionar.
| Método | Valor devuelto | Descripción |
|---|---|---|
GUnload()
|
None |
Desmonta todos los gestores de eventos registrados para evitar que haya pérdidas de memoria. Se le deberá llamar para que haga de gestor del evento unload. |
Esta clase se utiliza para obtener resultados de ruta y mostrarlos en un mapa, en un panel de texto, o en ambos.
| Constructor | Descripción |
|---|---|
GDirections(map?:GMap2,
panel?:Element)
|
Crea una instancia nueva de un objeto de ruta para solicitar y almacenar resultados de rutas. Este objeto de ruta podrá después crear rutas a través de una consulta que emplee el método GDirections.load().El constructor toma un objeto de mapa opcional (para mostrar una polilínea de la ruta calculada) o un elemento DIV de panel (para mostrar los resultados de la ruta en texto) o ambas cosas. En caso de pasarse un argumento map, siempre que se calculen resultados de rutas nuevas, la polilínea y los marcadores asociados al resultado se agregarán automáticamente al mapa como superposiciones. De forma similar, al transmitir un argumento panel, las indicaciones textuales asociadas al resultado se añaden al elemento DIV indicado, sustituyendo cualquier contenido existente en el elemento DIV.Si cualquiera de estos argumentos es nulo, los elementos asociados no se recuperarán a menos que se solicite explícitamente en el método GDirections.load(). (Consulta la información que aparece a continuación).
Además, el objeto contiene tres detectores de eventos interceptables:
(A partir de la versión 2,81). |
| Método | Valor devuelto | Descripción |
|---|---|---|
load(query:String,
queryOpts?:GDirectionsOptions)
|
None |
Este método emite una nueva consulta de ruta. El parámetro query corresponde a una cadena que contiene cualquier consulta de ruta válida, por ejemplo, "De: Seattle A: San Francisco" o "De: Toronto A: Ottawa A: Nueva York". De forma predeterminada, si durante la construcción del objeto GDirections se especificó un mapa, la consulta solicitará un resultado de polilínea. De forma parecida, si se especificó un panel de texto, la consulta solicitará resultados en texto detallados. Si no, el resultado sólo contendrá información de resumen sobre las rutas encontradas.Para poder sustituir este funcionamiento (por ejemplo, para solicitar información de polilínea incluso aunque no haya ningún mapa vinculado al objeto), se puede utilizar el parámetro opcional queryOpts. Consulta la documentación de GDirectionsOptions para obtener información detallada.
Una vez que se reciben los resultados de la ruta, el objeto borra los resultados antiguos, los sustituye con los nuevos y actualiza el mapa, el panel, o ambos, de modo que muestren los nuevos resultados. Los resultados incluyen varias rutas (objetos del tipo
Si, cuando se invoque una llamada nueva a (A partir de la versión 2,81). |
loadFromWaypoints(waypoints:Array,
queryOpts?:GDirectionsOptions)
|
None |
Emite una nueva consulta de ruta mediante una matriz de hitos como datos en lugar de una sola cadena de consulta. Este conjunto puede contener un máximo de 25 entradas de hitos. Cada entrada en la matriz es una cadena que representa una dirección de entrada o un punto de latitud/longitud. Consulta GDirections.load() para obtener más información sobre el funcionamiento de este método.
(A partir de la versión 2,81). |
clear()
|
None |
Borra todos los resultados de rutas existentes, elimina las superposiciones del mapa y el panel y cancela las solicitudes load() pendientes.
(A partir de la versión 2,81). |
getStatus()
|
Object |
Devuelve el estado de la solicitud de ruta. El objeto devuelto tiene la forma siguiente: { code: 200 request: "directions" } The status code can take any of the values defined in GGeoStatusCode.
(A partir de la versión 2,81). |
getBounds()
|
GLatLngBounds |
Este método se utiliza para obtener el cuadro de límites que incluirá el resultado de la consulta de ruta en cuestión. Devuelve un objeto GLatLngBounds o "null" si no hay disponible ningún resultado adecuado.
(A partir de la versión 2,81). |
getNumRoutes()
|
Number |
Devuelve el número de rutas disponibles en el resultado. Para que la consulta dé resultados, este valor debe ser el número total de hitos de entrada menos 1. Cuando no hay resultados disponibles (debido a que no se emitió ninguna consulta o a que la consulta anterior no dio resultados), este método devolverá un valor de 0.
(A partir de la versión 2,81). |
getRoute(i:Number)
|
GRoute |
Devuelve el objeto GRoute para la enésima ruta de la respuesta.
(A partir de la versión 2,81). |
getNumGeocodes()
|
Number |
Devuelve el número de entradas con código geográfico disponibles en el resultado. Para que la consulta dé resultados, este valor debe ser igual al número total de hitos de entrada. Cuando no hay resultados disponibles (debido a que no se emitió ninguna consulta o a que la consulta anterior no dio resultados), este método devolverá un valor de 0.
(A partir de la versión 2,81). |
getGeocode(i:Number)
|
Object |
Devuelve el resultado con código geográfico en el enésimo hito. La estructura de este objeto es idéntica a la de una marca de posición única en una respuesta del objeto GClientGeocoder.
(A partir de la versión 2,81). |
getCopyrightsHtml()
|
String |
Devuelve una cadena HTML con información de derechos de autor para el resultado.
(A partir de la versión 2,81). |
getSummaryHtml()
|
String |
Devuelve un fragmento HTML con un resumen de la distancia y el tiempo empleados en la solicitud de la ruta total. Ten en cuenta que este resumen es la única información que se devuelve a un objeto GDirections que se haya construido sin ningún mapa o elemento DIV asociado.
(A partir de la versión 2,81). |
getDistance()
|
Object |
Devuelve un objeto literal que representa la distancia total de la solicitud de ruta (a partir de todas las rutas). El objeto contiene dos campos: un número llamado "meters" que indica el valor numérico de la distancia (en metros), y una cadena llamada "html" que representa la distancia en el sistema de unidades predominantes en el país donde empieza la ruta.
(A partir de la versión 2,81). |
getDuration()
|
Object |
Devuelve un objeto literal que representa el tiempo total asociado a la solicitud de ruta (a partir de todas las rutas). El objeto contiene dos campos: un número llamado "seconds" que indica el valor numérico del tiempo (en segundos) y una cadena llamada "html" con una cadena que representa el tiempo.
(A partir de la versión 2,81). |
getPolyline()
|
GPolyline |
Devuelve el objeto GPolyline asociado con toda la respuesta de ruta. Ten en cuenta que habrá una única polilínea que representará todas las rutas en la respuesta. Este objeto sólo se definirá después de haberse cargado todos los resultados de ruta (es decir, cuando se haya activado el evento "load").
(A partir de la versión 2,81). |
getMarker(i:Number)
|
GMarker |
Devuelve el marcador asociado con el enésimo código geográfico. Este método devolverá un valor no nulo sólo después de haberse cargado todos los resultados de ruta (es decir, cuando se haya activado el evento "load").
(A partir de la versión 2,81). |
Esta clase representa argumentos opcionales para los métodos GDirections.load() y GDirections.loadFromWaypoints(). Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
locale
|
String |
El código de región que se debe usar en los resultados de la ruta. Por ejemplo, "en_US", "fr", "fr_CA", etc. |
travelMode
|
GTravelModes |
El modo de viaje, como conducir (predeterminado) o caminar. (A partir de la versión 2,129). |
avoidHighways
|
Boolean |
Si el valor es "true", las rutas intentarán excluir autopistas al generar las rutas. Ten en cuenta que las rutas pueden incluir autopistas si no hay alternativas viables.(A partir de la versión 2,124). |
getPolyline
|
Boolean |
De forma predeterminada, los métodos GDirections.load*() sólo recuperan datos de polilínea si hay un mapa adjunto al objeto GDirections. Este campo se puede utilizar para sobrescribir este funcionamiento y recuperar datos de polilínea incluso si no hay ningún mapa adjunto al objeto de ruta. |
getSteps
|
Boolean |
De forma predeterminada, los métodos GDirections.load*() sólo recuperan datos de pasos si hay un panel adjunto al objeto GDirections. Este campo se puede utilizar para sobrescribir este funcionamiento y recuperar datos de pasos incluso si no hay ningún panel adjunto al objeto de ruta. |
preserveViewport
|
Boolean |
De forma predeterminada, cuando un objeto de ruta tiene un mapa, el mapa se centra y amplía de modo que quede dentro del cuadro de límites de los resultados de la ruta. Cuando se define esta opción en true, la ventana gráfica no se toca en la solicitud (a menos que no se haya definido siquiera). |
| Constante | Descripción |
|---|---|
G_TRAVEL_MODE_WALKING
|
A pie (A partir de la versión 2,129). |
G_TRAVEL_MODE_DRIVING
|
Conducción (A partir de la versión 2,129). |
Los objetos de esta clase los crea el objeto GDirections para almacenar información sobre una ruta única en los resultados de ruta. Esta clase no tiene constructor público. Los clientes no deben crear directamente objetos de esta clase.
| Método | Valor devuelto | Descripción |
|---|---|---|
getNumSteps()
|
Number |
Devuelve el número de pasos de la ruta.
(A partir de la versión 2,81). |
getStep(i:Number)
|
GStep |
Devuelve el objeto GStep para el paso enésimo de la ruta.
(A partir de la versión 2,81). |
getStartGeocode()
|
Object |
Devuelve el resultado en código geográfico correspondiente al punto de inicio en la ruta. La estructura de este objeto es idéntica a la de una marca de posición única en una respuesta del objeto GClientGeocoder.
(A partir de la versión 2,83). |
getEndGeocode()
|
Object |
Devuelve el resultado en código geográfico correspondiente al punto de fin en la ruta. La estructura de este objeto es idéntica a la de una marca de posición única en una respuesta del objeto GClientGeocoder.
(A partir de la versión 2,83). |
getEndLatLng()
|
GLatLng |
Devuelve un objeto GLatLng correspondiente al último punto de la ruta a lo largo de la polilínea. Ten presente que este punto puede variar con respecto a la latitud/longitud en GRoute.getEndGeocode(), ya que getEndLatLng() siempre devuelve un punto partido a la red de carreteras. No hay método correspondiente getStartLatLng(), ya que es idéntico a llamar a GRoute.getStep(0).getLatLng().
(A partir de la versión 2,81). |
getSummaryHtml()
|
String |
Devuelve un fragmento HTML con un resumen de la distancia y el tiempo empleado en la ruta.
(A partir de la versión 2,81). |
getDistance()
|
Object |
Devuelve un objeto literal que representa la distancia total de la ruta. Consulta GDirections.getDistance() para ver cómo se estructura este objeto.
(A partir de la versión 2,81). |
getDuration()
|
Object |
Devuelve un objeto literal que representa el tiempo total empleado en la ruta. Consulta GDirections.getDuration() para ver cómo se estructura este objeto.
(A partir de la versión 2,81). |
Los objetos de esta clase los crea el objeto GDirections para almacenar información sobre un paso único dentro los resultados de ruta. Esta clase no tiene constructor público. Los clientes no deben crear directamente objetos de esta clase.
| Método | Valor devuelto | Descripción |
|---|---|---|
getLatLng()
|
GLatLng |
Devuelve un objeto GLatLng correspondiente al primer punto de la ruta a lo largo del paso.
(A partir de la versión 2,81). |
getPolylineIndex()
|
Number |
Devuelve el índice del primer punto correspondiente al paso en cuestión a lo largo de la polilínea.
(A partir de la versión 2,81). |
getDescriptionHtml()
|
String |
Devuelve una cadena HTML con la descripción del paso.
(A partir de la versión 2,81). |
getDistance()
|
Object |
Devuelve un objeto literal que representa la distancia total del paso. Consulta GDirections.getDistance() para ver cómo se estructura este objeto.
(A partir de la versión 2,81). |
getDuration()
|
Object |
Devuelve un objeto literal que representa el tiempo total empleado en el paso concreto. Consulta GDirections.getDuration() para ver cómo se estructura este objeto.
(A partir de la versión 2,81). |
Un objeto GTrafficOverlay agrega una superposición al mapa que muestra información acerca del tráfico rodado. Implementa la interfaz de GOverlay, agregándose así al mapa mediante el método GMap2.addOverlay() y eliminándose con el método GMap2.removeOverlay(). La clase GTrafficOverlay sólo mostrará información del tráfico para las ciudades en las que ello sea posible.
| Constructor | Descripción |
|---|---|
GTrafficOverlay(opts?:GTrafficOverlayOptions)
|
Crea un objeto GTrafficOverlay nuevo que muestra información sobre el tráfico rodado.(A partir de la versión 2,81). |
| Método | Valor devuelto | Descripción |
|---|---|---|
hide()
|
None |
Oculta la superposición del tráfico. (A partir de la versión 2,81). |
show()
|
None |
Muestra la superposición del tráfico. (A partir de la versión 2,81). |
| Evento | Descripción |
|---|---|
changed(hasTrafficInView:Boolean)
|
Este evento se activa cuando los datos del estado del tráfico cambian dentro de la ventana gráfica en uso. Este evento se puede activar bien al mover el mapa de un área a otra con o sin datos de tráfico, o bien cuando al agregar GTrafficOverlay al mapa, aparecen datos del tráfico dentro de la ventana gráfica en uso. El parámetro hasTrafficInView será true si la ventana gráfica contiene datos del tráfico. Si no, será false. El evento funciona independientemente de si la capa está oculta o visible.
(A partir de la versión 2,85). |
Esta clase representa argumentos opcionales para el constructor de GTrafficOverlay. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
incidents
|
Boolean |
Si el valor es "true", indica que GTrafficOverlay debe mostrar incidentes del tráfico en el mapa, donde corresponda. De forma predeterminada, este valor está establecido en "false".(A partir de la versión 2,121). |
hide
|
Boolean |
Si se establece en "true", indica que el mapa no debe mostrar GTrafficOverlay inicialmente. Para activar la superposición, ejecuta GTrafficOverlay.show(). De forma predeterminada, este valor está establecido en "false".
(A partir de la versión 2,121). |
Un objeto GAdsManager recupera anuncios de AdSense y los muestra en un mapa determinado. Los anuncios aparecen como elementos GMarker y se puede hacer clic en ellos para activarlos y meterlos en la ventana de información del marcador. El elemento GAdsManager selecciona anuncios de AdSense según la ventana gráfica activa y el contenido de texto de la página. No olvides que, al agregar un elemento GAdsManager a un mapa, deberás habilitarlo de forma explícita con el método enable().
| Constructor | Descripción |
|---|---|
GAdsManager(map:GMap2,
publisherId:String,
adsManagerOptions?:GAdsManagerOptions)
|
Crea un nuevo objeto GAdsManager que solicita anuncios de AdSense desde servidores de Google. El parámetro map identifica el mapa en el cual debe mostrar los anuncios el elemento GAdsManager. El parámetro publisherId especifica la cuenta de AdSense del desarrollador. El parámetro adsManagerOptions es un objeto literal GAdsManagerOptions.(A partir de la versión 2,85). |
| Método | Valor devuelto | Descripción |
|---|---|---|
enable()
|
None |
Permite recuperar anuncios. No es posible recuperar anuncios de forma predeterminada. (A partir de la versión 2,85). |
disable()
|
None |
Inhabilita la recuperación de anuncios. (A partir de la versión 2,85). |
Esta clase almacena argumentos opcionales para el constructor de GAdsManager. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
maxAdsOnMap
|
Number |
El número máximo de anuncios que se deben mostrar en el mapa en cualquier momento. El valor predeterminado es 3. (A partir de la versión 2,85). |
channel
|
Number |
El número de canal de AdSense utilizado para recuperar anuncios. Los canales son una función opcional que los usuarios de AdSense pueden utilizar para poder hacer un seguimiento de los ingresos obtenidos a través de sus anuncios desde varias fuentes. (A partir de la versión 2,85). |
minZoomLevel
|
Number |
El nivel de acercamiento mínimo en el que se pueden mostrar anuncios. El valor predeterminado es 6. (A partir de la versión 2,85). |
Un objeto GStreetviewPanorama guarda una instancia del visor Flash® panorámico de Street View. Cada uno de los objetos de esta clase puede almacenar una instancia independiente en la que se muestre una única vista. Este objeto suele incrustarse dentro de un objeto contenedor como un elemento DIV y se puede manipular para cambiar de vista mediante los métodos de esta clase. No hay datos de Street View para todos los lugares. Utiliza el objeto GStreetviewClient o el objeto GStreetviewOverlay para saber si hay datos de Street View para tu ubicación.
| Constructor | Descripción |
|---|---|
GStreetviewPanorama(container:Node,
opts?:GStreetviewPanoramaOptions)
|
Crea un nuevo objeto GStreetviewPanorama con un visor Flash en el contenedor indicado. El visor no se podrá ver hasta que se especifique una ubicación, bien en el objeto opcional GStreetviewPanoramaOptions opts, bien llamando a setLocationAndPOV.
(A partir de la versión 2,104). |
| Método | Valor devuelto | Descripción |
|---|---|---|
remove()
|
None |
Elimina la instancia del visor Flash asociada en ese momento con el objeto desde el elemento DOM. A esta función se la llama antes de eliminar el elemento contenedor de HTML. Si no, algunos navegadores no podrán recuperar automáticamente el visor Flash.
(A partir de la versión 2,104). |
setContainer(container:Node)
|
None |
Define el elemento contenedor para el visor Flash, moviendo el visor de su ubicación anterior si está abierto en ese momento.
(A partir de la versión 2,104). |
checkResize()
|
None |
Notifica al visor Flash si se ha producido un cambio en el tamaño de su contenedor. Llama a este método cuando el tamaño del objeto DOM del contenedor cambie, de modo que el visor se pueda ajustar a sí mismo según el nuevo tamaño.
(A partir de la versión 2,104). |
hide()
|
None |
Oculta el visor Flash. Para eliminar el visor, llama en su lugar a .remove().
(A partir de la versión 2,104). |
show()
|
None |
Muestra el visor Flash.
(A partir de la versión 2,104). |
isHidden()
|
boolean |
Devuelve true si el visor Flash asociado al objeto está oculto. Si no, devuelve false.(A partir de la versión 2,104). |
getPOV()
|
GPov |
Devuelve el punto de vista activo en ese momento en el visor Flash.
(A partir de la versión 2,104). |
setPOV(pov:GPov)
|
None |
Cambia el punto de vista activo en ese momento en el visor Flash sin cambiar la ubicación.
(A partir de la versión 2,104). |
panTo(pov:GPov,
opt_longRoute:Boolean)
|
None |
Cambia el punto de vista activo en ese momento en el visor Flash sin cambiar la ubicación. Realiza una animación progresiva desde el punto de vista en uso al nuevo punto de vista. Si se establece opt_longRoute, la animación seguirá una larga ruta alrededor de la esfera, de lo contrario se utilizará la ruta más corta.
(A partir de la versión 2,104). |
setLocationAndPOV(latlng:GLatLng,
opt_pov:GPov)
|
None |
Define la ubicación y el punto de vista del visor Flash. Después de ejecutar esta función, el visor mostrará la ubicación más cercana al valor de latlng proporcionado si hay uno disponible. Si no hubiera datos disponibles para la ubicación en cuestión, el reproductor permanecerá inalterado y emitirá un código de error. Consulta GStreetviewClient.ReturnValues para ver cuáles son los códigos de respuesta posibles.
(A partir de la versión 2,104). |
followLink(yaw:Number)
|
None |
Sigue un enlace desde la panorámica actual a la panorámica próxima. yaw especifica la dirección de la panorámica próxima; si existen varias panorámicas próximas, se utilizará la más cercana.(A partir de la versión 2,104). |
| Evento | Descripción |
|---|---|
yawchanged(yaw:Number)
|
Este evento se activa cuando cambia el valor de oblicuidad que se ve en el visor Flash.
(A partir de la versión 2,104). |
pitchchanged(pitch:Number)
|
Este evento se activa cuando cambia el valor de inclinación que se ve en el visor Flash.
(A partir de la versión 2,104). |
zoomchanged(zoom:Number)
|
Este evento se activa cuando cambia el valor de acercamiento que se ve en el visor Flash.
(A partir de la versión 2,104). |
error(errorCode:GStreetviewPanorama.ErrorValues)
|
Este evento se activa cuando se produce un error. Consulta GStreetviewPanorama.ErrorValues para ver la lista de tipos de errores.(A partir de la versión 2,104). |
initialized(location:GStreetviewLocation)
|
Este evento se activa cuando se inicializa la panorámica tras desplazarse a una ubicación nueva. La ubicación es un objeto GStreetviewLocation. Nota: the initialized event is not sent when the panorama is first rendered; this is a known issue and we plan to fix this in a future release.
(A partir de la versión 2,104). |
Esta clase representa las opciones que se han pasado al constructor de GStreetviewPanorama. Aunque no tiene constructor, se crea instancia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
latlng
|
GLatLng |
El valor de latlng en el que abrir el visor flash.
(A partir de la versión 2,104). |
pov
|
GPov |
La orientación de la cámara en la que se debe abrir el visor Flash.
(A partir de la versión 2,104). |
Un objeto GStreetviewOverlay es un conjunto de teselas en el que se destacan las ubicaciones para las que se cuenta con datos de Street View. Esta clase implementa la interfaz GOverlay y se puede agregar al mapa mediante map.addOverlay o eliminarse mediante map.removeOverlay.
| Constructor | Descripción |
|---|---|
GStreetviewOverlay()
|
Crea un objeto GStreetviewOverlay nuevo que implementa la interfaz GOverlay.(A partir de la versión 2,104). |
| Evento | Descripción |
|---|---|
changed(hasStreetviewData:Boolean)
|
Este evento se activa cuando los datos de Street View cambian dentro de la ventana gráfica en uso. Si se activa al mover el mapa de un área con datos de Street View a otra sin estos datos y viceversa. También se activa al añadir GStreetviewOverlay al mapa hace que los datos de Street View aparezcan en la ventana gráfica. El parámetro hasStreetviewData será true si la ventana gráfica contiene datos de Street View. Si no, será false.
(A partir de la versión 2,120). |
Un objeto GStreetviewClient realiza búsquedas de datos de Street View según los parámetros que se pasan a sus métodos.
| Constructor | Descripción |
|---|---|
GStreetviewClient()
|
Crea un nuevo GStreetviewClient.
(A partir de la versión 2,104). |
| Método | Valor devuelto | Descripción |
|---|---|---|
getNearestPanoramaLatLng(latlng:GLatLng,
callback:Function(GLatLng))
|
None |
Localiza el valor GLatLng de la panorámica más próxima a un punto concreto y se lo pasa a la devolución de llamada indicada. Si no hay panorámicas próximas, o si se produce un error del servidor, la devolución de llamada recibe en su lugar un valor "null".
(A partir de la versión 2,104). |
getNearestPanorama(latlng:GLatLng,
callback:Function(GStreetviewData))
|
None |
Recupera los datos correspondientes a la panorámica más cercana según el valor de latlng indicado y los transfiere a la devolución de llamada indicada como objeto GStreetviewData.
(A partir de la versión 2,104). |
getPanoramaById(panoId:string,
callback:Function(GStreetviewData))
|
None |
Recupera los datos correspondientes al identificador de panorámica indicados y se los pasa a la devolución de llamada indicada como objeto GStreetviewData. Los identificadores son exclusivos de cada panorámica y permanecen estables durante el tiempo que dure la sesión, si bien pueden cambiar de una sesión a otra.
(A partir de la versión 2,104). |
Los equivalentes numéricos de cada constante simbólica se especifican entre paréntesis.
| Constante | Descripción |
|---|---|
SUCCESS |
Correcto (A partir de la versión 2,104). |
SERVER_ERROR |
El servidor no responde a las consultas. (A partir de la versión 2,104). |
NO_NEARBY_PANO |
No hay datos de panorámica. (A partir de la versión 2,104). |
Esta clase representa los datos asociados a una panorámica. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
location
|
GStreetviewLocation |
Los datos de la ubicación. (A partir de la versión 2,104). |
copyright
|
String |
Derechos de autor según la ubicación. (A partir de la versión 2,104). |
links
|
GStreetviewLink[] |
Enlaces a panorámicas próximas, de haberlas. (A partir de la versión 2,104). |
code
|
GStreetviewClient.ReturnValues |
Código de estado. Consulta GStreetviewClient.ReturnValues.(A partir de la versión 2,104). |
Esta clase representa una ubicación de Street View. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
latlng
|
GLatLng |
El valor de latlng de la panorámica. (A partir de la versión 2,104). |
pov
|
GPov |
El punto de vista de inicio. (A partir de la versión 2,104). |
description
|
String |
Una cadena según la región que describe la ubicación. (A partir de la versión 2,104). |
panoId
|
String |
Un identificador único de la panorámica. Este valor permanece estable dentro de una misma sesión, pero cambia de una sesión a otra. (A partir de la versión 2,104). |
Esta clase representa un enlace desde un objeto GStreetviewLocation a otro objeto GStreetviewLocation próximo. Aunque no tiene constructor, se crea instancia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
yaw
|
Number |
La oblicuidad desde la ubicación en la que se está a la ubicación próxima. (A partir de la versión 2,104). |
description
|
String |
Una cadena según la región que describe la ubicación próxima. (A partir de la versión 2,104). |
panoId
|
String |
Un identificador único de la panorámica próxima. Este valor permanece estable dentro de una misma sesión, pero cambia de una sesión a otra. (A partir de la versión 2,104). |
Esta clase representa la estructura de un punto de vista de cámara usado en Street View. Aunque no tiene constructor, se crea instancia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
yaw
|
Number |
La oblicuidad de la cámara en grados relativos al Norte absoluto. El Norte absoluto corresponde a 0 grados, el Este a 90 grados, el Sur a 180 grados y el Oeste a 270 grados.
(A partir de la versión 2,104). |
pitch
|
Number |
La inclinación de la cámara en grados en relación con el aparato transmisor de Street View. Oscila entre los 90 grados (directamente hacia arriba) y los -90 grados (directamente hacia abajo).
(A partir de la versión 2,104). |
zoom
|
Number |
El nivel de acercamiento. El nivel de acercamiento más pequeño, es decir la vista más alejada, es el 0. Al ir acercando la imagen, el nivel de acercamiento va aumentando. (A partir de la versión 2,104). |
Los equivalentes numéricos de cada constante simbólica se especifican entre paréntesis.
| Constante | Descripción |
|---|---|
NO_NEARBY_PANO |
No hay datos de panorámica. (A partir de la versión 2,104). |
FLASH_UNAVAILABLE |
El visor Flash no está disponible, generalmente porque el navegador del usuario no es compatible con la tecnología Flash. (A partir de la versión 2,104). |