(API obsoleta)
(API obsoleta)
(API obsoleta)
API de Google Maps (edición premier)
Los mismos mapas de excelente calidad, además de un acuerdo de servicios, asistencia y control sobre los anuncios
Nota: desde el 19 de mayo de 2010, la versión 2 del API de JavaScript de Google Maps ha quedado oficialmente obsoleta. Podrás seguir utilizando la versión 2 del API de acuerdo con la política de funciones obsoletas, pero te recomendamos que realices la migración del código a la versión 3 del API de JavaScript de Google Maps.
El API de Google Maps tiene ahora integrado el cargador de API AJAX de Google, que crea un espacio de nombre común para cargar y utilizar varias API AJAX de Google. Este marco permite utilizar el espacio de nombre opcional google.maps.* para las clases, los métodos y las propiedades que estés utilizando actualmente en el API de Google Maps, sustituyendo el prefijo normal G por este espacio de nombre. No te preocupes: el espacio de nombre G actual seguirá siendo compatible.
Por ejemplo, el objeto GMap2 también se puede definir como google.maps.Map2 en el API de Google Maps.
Ten en cuenta que esta documentación de referencia solo se aplica al nombre de espacio G actual.
Esta es la clase más importante del API de Google Maps. Las demás clases de esta referencia se agrupan según su objetivo.
Crea una instancia de la clase GMap2 para crear un mapa. Esta 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 el argumento opts.mapTypes no incluye un conjunto de tipos de mapa, se utilizará el conjunto predeterminado G_DEFAULT_MAP_TYPES. Si el argumento opcional opts.size no especifica el tamaño, se utilizará el tamaño del contenedor (container). Si se especifica el valor de opts.size, se ajustará el tamaño del elemento contenedor del mapa en consecuencia. Consulta class GMapOptions. Nota: un mapa se debe centrar para poder utilizarse. Debe ejecutar GMap2.setCenter() inmediatamente para inicializar un mapa creado con este constructor.
|
| Método | Valor de retorno | Descripción |
|---|---|---|
enableDragging()
|
None |
Permite arrastrar el mapa (habilitado de forma predeterminada). |
disableDragging()
|
None |
Inhabilita la posibilidad de arrastrar el mapa. |
draggingEnabled()
|
Boolean |
Devuelve true únicamente si se habilita la posibilidad de arrastrar el mapa. |
enableInfoWindow()
|
None |
Habilita las operaciones de la ventana de información en el mapa (habilitado de forma predeterminada). |
disableInfoWindow()
|
None |
Cierra la ventana de información si está abierta e inhabilita la posibilidad de abrir una nueva ventana de información. |
infoWindowEnabled()
|
Boolean |
Devuelve true únicamente si la ventana de información está habilitada. |
enableDoubleClickZoom()
|
None |
Habilita la posibilidad de hacer doble clic para acercar y alejar la imagen (habilitado de forma predeterminada). (A partir de la versión 2.58) |
disableDoubleClickZoom()
|
None |
Inhabilita la posibilidad de hacer doble clic para acercar y alejar la imagen. (A partir de la versión 2.58) |
doubleClickZoomEnabled()
|
Boolean |
Devuelve true únicamente si la posibilidad de hacer doble clic para acercar y alejar la imagen está habilitada.(A partir de la versión 2.58) |
enableContinuousZoom()
|
None |
Habilita la posibilidad de acercar o alejar la imagen de forma continua y gradual en los navegadores seleccionados (inhabilitado de forma predeterminada). (A partir de la versión 2.58) |
disableContinuousZoom()
|
None |
Inhabilita la posibilidad de acercar o alejar la imagen de forma continua y gradual. (A partir de la versión 2.58) |
continuousZoomEnabled()
|
Boolean |
Devuelve true únicamente si la posibilidad de acercar o alejar la imagen de forma continua y gradual está habilitada.(A partir de la versión 2.58) |
enableGoogleBar()
|
None |
Habilita GoogleBar, un control de búsqueda integrado, en el mapa. Si está habilitado, este control sustituye al logotipo predeterminado con la tecnología de Google. Ten en cuenta que este control no está habilitado de forma predeterminada. Nota: actualmente, GoogleBar no es compatible con el complemento de Google Earth que utiliza el tipo de mapa GMapType.G_SATELLITE_3D_MAP, por lo que se inhabilitará mientras se muestra dicho complemento.(A partir de la versión 2.92) |
disableGoogleBar()
|
None |
Inhabilita el control de búsqueda integrado de GoogleBar. Si está inhabilitado, el logotipo predeterminado con la tecnología de Google ocupará la posición que ocupaba este control anteriormente. Ten en cuenta que este control ya está inhabilitado de forma predeterminada. (A partir de la versión 2.92) |
enableScrollWheelZoom()
|
None |
Permite acercar y alejar la imagen con la rueda de desplazamiento del ratón. Nota: la posibilidad de acercar o alejar la imagen con la rueda de desplazamiento del ratón está inhabilitada de forma predeterminada. (A partir de la versión 2.78) |
disableScrollWheelZoom()
|
None |
Inhabilita la posibilidad de acercar o alejar la imagen con la rueda de desplazamiento del ratón. Nota: la posibilidad de acercar o alejar la imagen con la rueda de desplazamiento del ratón está inhabilitada de forma predeterminada. (A partir de la versión 2.78) |
scrollWheelZoomEnabled()
|
Boolean |
Devuelve un valor booleano indicando si la posibilidad de acercar o alejar la imagen con la rueda de desplazamiento del ratón está habilitada. (A partir de la versión 2.78) |
enablePinchToZoom()
|
None |
Habilita la opción que permite utilizar el zoom al hacer clic en iPhone o en iPod touch. Nota: esta opción está habilitada de forma predeterminada. (A partir de la versión 2.143) |
disablePinchToZoom()
|
None |
Inhabilita la opción que permite utilizar el zoom al hacer clic en iPhone o en iPod touch. Nota: esta opción está habilitada de forma predeterminada. (A partir de la versión 2.143) |
pinchToZoomEnabled()
|
Boolean |
Devuelve un valor booleano que indica si la opción que permite utilizar el zoom al hacer clic está habilitada. (A partir de la versión 2.143) |
getDefaultUI()
|
Object |
Devuelve un objeto GMapUIOptions que especifica el comportamiento y los elementos de la interfaz de usuario predeterminados del mapa en función de la interfaz de usuario de maps.google.com.
(A partir de la versión 2.147) |
setUIToDefault()
|
None |
Añade el comportamiento y los elementos de la interfaz de usuario predeterminados especificados en getDefaultUI() para el mapa.
(A partir de la versión 2.147) |
setUI(ui:GMapUIOptions)
|
None |
Añade el comportamiento y los elementos de la interfaz de usuario especificados en el parámetro ui, que puede ser una versión modificada del objeto devuelto desde getDefaultUI().(A partir de la versión 2.147) |
| Método | Valor de retorno | Descripción |
|---|---|---|
addControl(control:GControl,
position?:GControlPosition)
|
None |
Añade el control al mapa. La posición del mapa está determinada por el argumento opcional position. Si no se especifica este argumento, se utilizará la posición predeterminada del control, según determine el método GControl.getDefaultPosition(). No se debe añadir más de una vez una instancia de un control al mapa. |
removeControl(control:GControl)
|
None |
Elimina el control del mapa. Si el control nunca se añadió al mapa, este método no hará nada. |
getContainer()
|
Node |
Devuelve el objeto DOM que contiene el mapa. Lo utiliza GControl.initialize(). |
| Método | Valor de retorno | Descripción |
|---|---|---|
getMapTypes()
|
GMapType[] |
Devuelve el conjunto de tipos de mapa registrado con este mapa. |
getCurrentMapType()
|
GMapType |
Devuelve el tipo de mapa seleccionado actualmente. |
setMapType(type:GMapType)
|
None |
Selecciona el nuevo tipo de mapa especificado. El tipo debe ser conocido para el mapa. Consulta el constructor y el método addMapType(). |
addMapType(type:GMapType)
|
None |
Añade un nuevo tipo de mapa al mapa. Para obtener más información sobre cómo definir los tipos de mapas personalizados, consulta la sección GMapType. |
removeMapType(type:GMapType)
|
None |
Elimina el tipo de mapa del mapa. Actualiza el conjunto de botones mostrado por GMapTypeControl o GHierarchicalMapTypeControl y activa el evento removemaptype. |
| Método | Valor de retorno | Descripción |
|---|---|---|
isLoaded()
|
Boolean |
Devuelve true únicamente si setCenter() inicializó el mapa desde que fue creado. |
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 zoom en el que una región rectangular concreta se ajusta a la vista del mapa. El nivel de zoom se calcula según el tipo de mapa seleccionado en ese momento. Si aún no se ha seleccionado ningún tipo de mapa, se utilizará el primero de la lista. |
getSize()
|
GSize |
Devuelve el tamaño de la vista del mapa en píxeles. |
getZoom()
|
Number |
Devuelve el nivel de zoom actual. |
getDragObject()
|
GDraggableObject |
Devuelve el objeto arrastrable utilizado por este 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 incorporada a este mapa y ejecuta la función de devolución de llamada transmitida una vez que la instancia está preparada 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 el motivo por el que este método necesita 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 cree una instancia de Google Earth, no establecerá el tipo de mapa de Google Earth como la vista actual. Para establecer la vista actual, 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 para desarrolladores del API 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 de retorno | Descripción |
|---|---|---|
setCenter(center:GLatLng,
zoom?:Number,
type?:GMapType)
|
None |
Configura la vista del mapa en el centro especificado. También define opcionalmente el nivel de zoom y el tipo de mapa. El tipo de mapa debe ser conocido para el mapa. Consulta el constructor y el método addMapType(). Este método se debe ejecutar en primer lugar después de la construcción para establecer el estado inicial del mapa. Es un error ejecutar operaciones en un objeto GMap2 recién creado antes de invocar esta función.
|
panTo(center:GLatLng)
|
None |
Cambia el punto central del mapa al punto especificado. Si el punto ya es visible en la vista de mapa actual, cambia el punto 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 panorámica por la mitad del ancho del mapa en las direcciones indicadas. +1 indica hacia abajo y hacia la derecha, mientras que -1 indica hacia arriba y hacia la izquierda. |
setZoom(level:Number)
|
None |
Establece el nivel de zoom en el nuevo valor proporcionado. |
zoomIn(latlng?:GLatLng,
doCenter?:Boolean,
doContinuousZoom?:Boolean)
|
None |
Aumenta el nivel de zoom en uno. Si se proporciona un argumento latlng opcional, el mapa intentará mantener la ubicación presente en el mapa al que se aplique el zoom de acercamiento. (Ten en cuenta que latlng debe estar presente actualmente en el mapa al que se aplique el zoom de alejamiento). Si se proporciona el argumento opcional doCenter, de forma adicional, el mapa se centrará en el argumento latlng proporcionado.
|
zoomOut(latlng?:GLatLng,
doContinuousZoom?:Boolean)
|
None |
Reduce el nivel de zoom en uno. Si se proporciona latlng, el mapa aplicará el zoom en ese punto. Si doContinuousZoom se establece en "true", el mapa utilizará el zoom continuo cuando aplique el zoom de alejamiento. |
savePosition()
|
None |
Almacena la posición del mapa y el nivel de zoom de ese momento para volver a ejecutarlo posteriormente con returnToSavedPosition(). |
returnToSavedPosition()
|
None |
Restaura la vista de mapa que guardó savePosition(). |
checkResize()
|
None |
Notifica al mapa un cambio en el tamaño de su contenedor. Ejecuta este método si el tamaño del objeto DOM del contenedor ha cambiado para ajustar el mapa al nuevo tamaño. |
| Método | Valor de retorno | 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. Es un error intentar eliminar una superposición que no está en el mapa. Si se ejecuta 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 de la capa identificado por pane. Utilizado por instancias de GOverlay e instancias del método GOverlay.initialize() para aparecer en el mapa |
| Método | Valor de retorno | Descripción |
|---|---|---|
openInfoWindow(latlng:GLatLng,
node:Node,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información sencilla en el punto indicado. Desplaza el mapa de tal forma que la ventana de información abierta queda completamente visible. El contenido de la ventana de información se ofrece como un nodo DOM. |
openInfoWindowHtml(latlng:GLatLng,
html:String,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información sencilla en el punto indicado. Desplaza el mapa de tal forma que la ventana de información abierta queda completamente visible. El contenido de la ventana de información se ofrece como texto HTML. |
openInfoWindowTabs(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GinfoWindowOptions)
|
None |
Abre una ventana de información con pestañas en el punto indicado. Desplaza el mapa de tal forma que la ventana de información abierta queda completamente visible. El contenido de la ventana de información se ofrece como nodos DOM. |
openInfoWindowTabsHtml(latlng:GLatLng,
tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información con pestañas en el punto indicado. Desplaza el mapa de tal forma que la ventana de información abierta queda completamente visible. El contenido de la ventana de información se ofrece como texto HTML. |
showMapBlowup(latlng:GLatLng,
opts?:GInfoWindowOptions)
|
None |
Abre una ventana de información en el punto especificado que contiene una vista en primer plano del mapa alrededor de este punto. |
updateInfoWindow(tabs:GInfoWindowTab[],
onupdate?:Function)
|
None |
Actualiza el contenido del objeto GInfoWindow abierto actualmente sin reposicionarlo. El tamaño de la ventana de información se ajustará según el nuevo contenido. La función de devolución de llamada opcional onupdate se ejecuta una vez que se cambia el contenido de la ventana de información.
(A partir de la versión 2.85) |
updateCurrentTab(modifier:Function,
onupdate?:Function)
|
None |
Actualiza la pestaña seleccionada en ese momento, lo que causa que se ajuste el tamaño del objeto GInfoWindow sin reposicionarlo. La función modifier permite modificar la pestaña seleccionada en ese momento. Se le transmite GInfoWindowTab como un argumento. La función de devolución de llamada opcional onupdate se ejecuta una vez que la ventana de información muestra el nuevo contenido.(A partir de la versión 2.85) |
closeInfoWindow()
|
None |
Cierra la ventana de información abierta actualmente. |
getInfoWindow()
|
GInfoWindow |
Devuelve el objeto de la ventana de información de este mapa. Si aún no existe ninguna ventana de información, se creará una, pero no se mostrará. enableInfoWindow() no influye en esta operación. |
| Método | Valor de retorno | Descripción |
|---|---|---|
fromContainerPixelToLatLng(pixel:GPoint)
|
GLatLng |
Calcula las coordenadas geográficas del punto situado en las coordenadas de píxeles especificadas en el elemento DOM que contiene el mapa en la página. Resulta útil cuando se implementa una interacción de controles personalizados con el mapa. |
fromLatLngToContainerPixel(latlng:GLatLng)
|
GPoint |
Calcula las coordenadas de píxeles del punto geográfico especificado en el elemento DOM que contiene el mapa en la página.
(A partir de la versión 2.100) |
fromLatLngToDivPixel(latlng:GLatLng)
|
GPoint |
Calcula las coordenadas de píxeles del punto geográfico especificado 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() de una superposición personalizada. |
fromDivPixelToLatLng(pixel:GPoint)
|
GLatLng |
Calcula las coordenadas geográficas a partir de las coordenadas de píxeles del elemento div que incluye el mapa arrastrable. Resulta útil cuando se implementa una interacción con superposiciones personalizadas que no amplían la interfaz GOverlay. Si no obtienes el resultado esperado, prueba el método fromContainerPixelToLatLng. |
| Método | Valor de retorno | Descripción |
|---|---|---|
enableRotation(level?:Number)
|
None |
Permite la rotación (visualización de imágenes aéreas rotatorias) en el mapa para todos los GMapType que admitan rotación. Si se habilita, las imágenes aéreas rotatorias estarán disponibles en las ventanas gráficas en las que existan imágenes cuando el nivel de zoom supere un determinado umbral. A partir de la versión 2.194, es posible especificar este nivel de zoom explícitamente en el parámetro opcional level. Actualmente, las imágenes aéreas solo están disponibles para G_SATELLITE_MAP y G_HYBRID_MAP.
(A partir de la versión 2.193) |
disableRotation()
|
None |
Inhabilita la rotación en el mapa. Si se están mostrando actualmente imágenes aéreas rotatorias en el mapa, en su lugar se mostrarán automáticamente imágenes a vista de pájaro.
(A partir de la versión 2.193) |
rotationEnabled()
|
Boolean |
Devuelve el valor "true" si se ha habilitado la rotación en el mapa. (A partir de la versión 2.193) |
isRotatable()
|
Boolean |
Devuelve el valor "true" si el mapa es rotatorio en la ventana gráfica actual y la rotación está habilitada en el mapa. El mapa se considera rotatorio si el tipo de mapa actual es G_SATELLITE_MAP o G_HYBRID_MAP y las imágenes aéreas rotatorias están disponibles en la ventana gráfica actual. (A partir de la versión 2.193) |
changeHeading(heading:Number)
|
None |
Intenta cambiar el tipo de mapa actual por un mapa aéreo rotatorio con el encabezado especificado. Para que el cambio tenga éxito, GMap2.isRotatable() debe devolver el valor "true".
(A partir de la versión 2.193) |
| Evento | Descripción |
|---|---|
addmaptype(type:GMapType)
|
Este evento se activa cuando se añade 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 un mapa con el ratón. Un evento click transfiere diferentes argumentos en función del contexto del clic y de si el clic se produjo en una superposición en la que se puede hacer clic. Si el clic se produjo en una superposición en la que no se puede hacer clic, el argumento overlay será null y el argumento latlng incluirá las coordenadas geográficas del punto en el que se ha hecho clic. Si el usuario hace clic en una superposición en la que se puede hacer clic (clickable), como GMarker, GPolygon, GPolyline o GInfoWindow, el argumento overlay contendrá el objeto de superposición, mientras que el argumento overlaylatlng contendrá las coordenadas de la superposición en la que se ha hecho clic. Además, a continuación 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 se hace doble clic en un marcador o en otra superposición en la que se puede hacer clic. Se transmiten las coordenadas geográficas del punto en el que se hace doble clic en el argumento latlng. El argumento overlay siempre está configurado como 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 transmite al controlador 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 incluyen en los argumentos point y srcrespectivamente. Ten en cuenta que si se hace doble clic con el botón derecho y se ha habilitado el doble clic para acercar la imagen, el mapa se alejará y no se activará ningún evento singlerightclick. No obstante, si está inhabilitada 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. La causa puede ser que se está arrastrando el mapa, en cuyo caso se activará también un evento dragstart o que se ha invocado un método que cambia la vista del mapa. |
move()
|
Este evento se activa, puede que repetidamente, mientras cambia la vista del mapa. |
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 zoom nuevo en el mapa. El controlador de eventos recibe los niveles de zoom 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 de 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 activarán los eventos infowindowbeforeclose, infowindowclose y infowindowopen en este orden. |
addoverlay(overlay:GOverlay)
|
Este evento se activará cuando se añada al mapa una superposición sencilla mediante el método addOverlay(). La nueva superposición se transmite como argumento overlay al controlador de eventos. |
removeoverlay(overlay:GOverlay)
|
Este evento se activa cuando se elimina una superposición sencilla mediante el método removeOverlay(). La superposición eliminada se transmite como un argumento overlay al controlador de eventos. |
clearoverlays()
|
Este evento se activa cuando todas las superposiciones se eliminan simultáneamente mediante el método clearOverlays(). |
mouseover(latlng:GLatLng)
|
Este evento se activa cuando el usuario desplaza el ratón sobre el mapa desde fuera. |
mouseout(latlng:GLatLng)
|
Este evento se activa cuando el usuario desplaza el ratón fuera del mapa desde dentro. |
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 completa la configuración del mapa e isLoaded() devuelve true. Esto significa se han inicializado completamente la posición, el zoom y el tipo de mapa, pero que es posible que las imágenes de mosaico sigan cargándose.(A partir de la versión 2.52) |
tilesloaded()
|
Este evento se activa cuando todos los mosaicos visibles se han terminado de cargar.
(A partir de la versión 2.140) |
headingchanged()
|
Este evento se activa cuando se cambia el valor actual de GMapType por otro con un encabezado diferente.
(A partir de la versión 2.193) |
rotatabilitychanged()
|
Este evento se activa cuando se cambia la rotabilidad del mapa.
(A partir de la versión 2.193) |
GBounds es un área rectangular del mapa en coordenadas de píxeles. Ten en cuenta que el rectángulo en coordenadas geográficas se representa mediante un objeto GLatLngBounds.
| Constructor | Descripción |
|---|---|
GBounds(points:GPoint[])
|
Crea un rectángulo que contiene todos los puntos (points) especificados. |
| Propiedad | Tipo | Descripción |
|---|---|---|
minX
|
Number |
La coordenada x del extremo izquierdo del rectángulo |
minY
|
Number |
La coordenada y del extremo superior del rectángulo |
maxX
|
Number |
La coordenada x del extremo derecho del rectángulo |
maxY
|
Number |
La coordenada y del extremo inferior del rectángulo |
| Método | Valor de retorno | Descripción |
|---|---|---|
toString()
|
String |
Devuelve una cadena que contiene las coordenadas de los puntos correspondientes a las esquinas superior izquierda e inferior derecha del cuadro, en este orden, separadas por comas y entre paréntesis. |
equals(other:GBounds)
|
Boolean |
Devuelve el valor "true" si todos los parámetros de este rectángulo son iguales a los parámetros del otro. (A partir de la versión 2.98) |
mid()
|
GPoint |
Devuelve las coordenadas de píxeles del centro del área rectangular. (A partir de la versión 2.88) |
min()
|
GPoint |
Devuelve las coordenadas de píxeles de la esquina superior izquierda del área rectangular. |
max()
|
GPoint |
Devuelve las coordenadas de píxeles de la esquina inferior derecha del área rectangular. |
containsBounds(other:GBounds)
|
Boolean |
Devuelve true únicamente si el área rectangular transmitida está comprendida completamente en esta área rectangular. |
containsPoint(point:GPoint)
|
Boolean |
Devuelve true únicamente si el área rectangular contiene (en su totalidad) las coordenadas de píxeles.(A partir de la versión 2.88) |
extend(point:GPoint)
|
None |
Aumenta el tamaño de este cuadro de forma que el punto también quede incluido en él. |
Esta función decide si el API de los mapas se puede utilizar en el navegador actual.
| Método | Valor de retorno | Descripción |
|---|---|---|
GBrowserIsCompatible()
|
Boolean |
Devuelve true únicamente si el navegador actual es compatible con la biblioteca del API de los mapas. |
Esta clase hace posible 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 zoom y los rectángulos del mapa de vista general. Los miembros por instancia (dinámicos) afectan solo a su instancia particular. Por ejemplo, antes de crear el mapa, puedes ejecutar GDraggableObject.setDraggableCursor('default') y GDraggableObject.setDraggingCursor('move') para obtener el estilo 2.56 anterior al API. De forma alternativa, algunas opciones del constructor del mapa permiten establecer el estilo del cursor de DraggableObject. Consulta los valores de cursor permitidos en la especificación W3C CSS.
| Constructor | Descripción |
|---|---|
GDraggableObject(src:Node,
opts?:GDraggableObjectOptions)
|
Configura controladores de eventos para que se pueda arrastrar el elemento de origen. La esquina superior izquierda establece opcionalmente la posición del elemento y el contenedor opcional sirve como cuadro delimitador.
(A partir de la versión 2.59) |
| Método | Valor de retorno | Descripción |
|---|---|---|
GDraggableObject.setDraggableCursor(cursor:String)
|
None |
Establece el cursor arrastrable para objetos arrastrables creados con posterioridad. (A partir de la versión 2.59) |
GDraggableObject.setDraggingCursor(cursor:String)
|
None |
Establece el cursor de arrastre para objetos arrastrables creados con posterioridad. (A partir de la versión 2.59) |
GDraggableObject.getDraggingCursor()
|
String |
Devuelve el cursor de arrastre que utiliza el mapa actualmente. Si no se configura a través del método estático setDraggingCursor(), devuelve el cursor predeterminado utilizado por el mapa para sus controles y marcadores.
(Obsoleto desde la versión 2.164) |
GDraggableObject.getDraggableCursor()
|
String |
Devuelve el cursor arrastrable que utiliza el mapa actualmente. Si no se configura a través del método estático setDraggableCursor(), devuelve el cursor predeterminado utilizado por el mapa para sus controles y marcadores.
(Obsoleto desde la versión 2.164) |
| Método | Valor de retorno | Descripción |
|---|---|---|
setDraggableCursor(cursor:String)
|
None |
Establece el cursor cuando el ratón se encuentra sobre este objeto arrastrable. (A partir de la versión 2.59) |
setDraggingCursor(cursor:String)
|
None |
Establece el cursor cuando el ratón se mantiene pulsado el botón del ratón mientras se arrastra este objeto. (A partir de la versión 2.59) |
moveTo(point:GPoint)
|
None |
Mueve GDraggableObject a una posición absoluta determinada. La posición se indica en coordenadas de píxeles respecto al nodo principal. Este método utiliza el sistema de coordenadas DOM, es decir, que la coordenada X aumenta al desplazarnos hacia la izquierda, mientras que la coordenada Y aumenta al desplazarnos hacia abajo.(A partir de la versión 2.89) |
moveBy(size:GSize)
|
None |
Mueve GDraggableObject según una determinada desviación del tamaño. Este método utiliza el sistemas de coordenadas DOM, es decir, que el ancho aumenta al desplazarnos hacia la izquierda y la altura aumenta al desplazarnos hacia abajo.(A partir de la versión 2.89) |
| Evento | Descripción |
|---|---|
mousedown()
|
Este evento se activa como respuesta al evento DOM mousedown. Gestionar este evento evita la acción predeterminada del evento DOM mousedown.(A partir de la versión 2.84) |
mouseup()
|
Este evento se activa como respuesta al evento DOM mouseup en un objeto arrastrable. Gestionar este evento evita 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 al iniciar un evento de arrastre de un objeto arrastrable (cuando el usuario hace clic en un objeto arrastrable y empieza a arrastrarlo). (A partir de la versión 2.84) |
drag()
|
Este evento se activa repetidamente mientras el usuario arrastra el objeto arrastrable. (A partir de la versión 2.84) |
dragend()
|
Este evento se activa al finalizar el evento de arrastre de un objeto arrastrable (cuando el usuario suelta el objeto que está arrastrando). (A partir de la versión 2.84) |
Esta clase representa argumentos opcionales del constructor GDraggableObject. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
left
|
Number |
La posición de inicio 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 |
Elemento DOM que actúa como cuadro delimitador del 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 se mostrará durante el arrastre (A partir de la versión 2.59) |
delayDrag
|
Boolean |
De forma predeterminada, el evento dragstart se activa cuando se activa el evento DOM mousedown en un elemento DOM arrastrable. De forma similar, el evento dragend se activa cuando se activa el evento DOM mouseup. Si se configura este valor como true, los eventos de arrastre se retrasarán hasta que se mueva el ratón de la posición donde se generó el evento mousedown o mouseup. El valor predeterminado de esta propiedad es false.
(Obsoleto desde la versión 2.146) |
GInfoWindow no tiene constructor. La crea el mapa y se accede a ella a través del método GMap2.getInfoWindow().
| Método | Valor de retorno | Descripción |
|---|---|---|
selectTab(index:Number)
|
None |
Selecciona la pestaña con el índice especificado. Tiene el mismo efecto que hacer clic en la ficha correspondiente. |
hide()
|
None |
Hace que la ventana de información sea invisible. NOTA: este método no cierra la ventana de información. Se puede volver a hacer visible mediante el método show(). |
show()
|
None |
Hace que la ventana de información sea visible si está oculta. |
isHidden()
|
Boolean |
Devuelve true únicamente si la ventana de información está oculta. Incluye el estado de que está cerrada. |
reset(latlng:GLatLng,
tabs:GInfoWindowTab[],
size:GSize,
offset?:GSize,
selectedTab?:Number)
|
None |
Restablece el estado de la ventana de información. Cada argumento puede ser null y su valor no cambiará del valor actual. |
getPoint()
|
GLatLng |
Devuelve el punto geográfico en el que se ancló la ventana de información. La punta de la ventana apunta a este punto del mapa, modulando la desviación de píxeles. |
getPixelOffset()
|
GSize |
Es la desviación, en píxeles, de la punta de la ventana de información desde el punto del mapa en cuyas coordenadas geográficas se haya anclado la ventana de información. |
getSelectedTab()
|
Number |
Devuelve el índice, a partir de 0, de la pestaña seleccionada en ese momento. |
getTabs()
|
GInfoWindowTabs[] |
Devuelve el conjunto de pestañas de esta ventana de información. (A partir de la versión 2.59) |
getContentContainers()
|
Node[] |
Devuelve el conjunto de nodos DOM que alojan el contenido de las pestañas de esta ventana de información. (A partir de la versión 2.59) |
enableMaximize()
|
None |
Habilita la maximización de la ventana de información. Una ventana de información maximizable se amplía hasta ocupar la mayor parte del mapa con contenido específico mediante las propiedades maxContent y maxTitle de GInfoWindowOptions. La ventana de información se debe haber abierto con la opción maxContent o maxTitle para que enableMaximize() o disableMaximize tenga algún efecto. Si la ventana de información se ha abierto con maxContent o maxTitle, tendrá la maximización habilitada de forma predeterminada.
(A partir de la versión 2.93) |
disableMaximize()
|
None |
Inhabilita la maximización de la ventana de información. La ventana de información se debe haber abierto con la opción maxContent o maxTitle. Ten en cuenta que si la ventana de información está abierta, esta función eliminará el botón de maximización, pero no restaurará la ventana 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 se debe haber abierto con la opción maxContent o maxTitle y no se debe haber inhabilitado su opción de maximización mediante disableMaximize.
(A partir de la versión 2.93) |
restore()
|
None |
Restaura la ventana de información a su estado predeterminado (no maximizado). La ventana de información se debe haber abierto con la opción maxContent o maxTitle. (A partir de la versión 2.93) |
| Evento | Descripción |
|---|---|
closeclick()
|
Este evento se activa al hacer clic en el botón de cierre de la ventana de información. |
maximizeclick()
|
Indica que la ventana de información está a punto de maximizarse. (A partir de la versión 2.93) |
maximizeend()
|
Indica que la ventana de información ha completado la maximización. (A partir de la versión 2.93) |
restoreclick()
|
Indica que la ventana de información está a punto de restaurarse al estado no maximizado. (A partir de la versión 2.93) |
restoreend()
|
Indica que la ventana de información ha completado la operación de restauración al estado no maximizado.
(A partir de la versión 2.93) |
Las instancias de esta clase se utilizan en el argumento opts? para los métodos openInfoWindow(), openInfoWindowHtml(), openInfoWindowTabs() y openInfoWindowTabsHtml(), así como para las variantes bindInfoWindow*() y showMapBlowup() de las clases GMap2 y GMarker. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
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 especificado, a partir de 0, en lugar de la primera pestaña (con índice 0). |
maxWidth
|
Number |
Ancho máximo del contenido de la ventana de información (en píxeles). Ten en cuenta que esta propiedad no tiene ningún efecto en las ventanas de información maximizadas. |
noCloseOnClick
|
Boolean |
Indica si la ventana de información se debe cerrar al hacer clic en un punto del mapa que no sea un marcador. Si se establece el valor true, la ventana de información no se cerrará al hacer clic en el mapa. El valor predeterminado es false.
(A partir de la versión 2.83) |
onOpenFn
|
Function |
La función se ejecuta después de abrir la ventana de información y mostrar su contenido. |
onCloseFn
|
Function |
La función se ejecuta cuando se cierra la ventana de información. |
zoomLevel
|
Number |
Solo se aplica a showMapBlowup(). El nivel de zoom del mapa ampliado en la ventana de información |
mapType
|
GMapType |
Solo se aplica a showMapBlowup(). El tipo de mapa del mapa ampliado en la ventana de información. |
maxContent
|
String |
Especifica el contenido que se va a mostrar 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 el título que se va a mostrar 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 el número de píxeles hacia arriba (x) y hacia la derecha (y) que se debe desplazar la ventana de información desde el GLatLng especificado.
(A partir de la versión 2.98) |
Se puede transferir un conjunto de instancias de esta clase como el argumento tabs a los métodos GMap2.openInfoWindowTabs(), GMap2.openInfoWindowTabsHtml(), GMarker.openInfoWindowTabs() y GMarker.openInfoWindowTabsHtml(), así como a las variantes de GMarker.bindInfoWindow*(). Si el conjunto contiene más de un elemento, la ventana de información se mostrará con pestañas. Cada InfoWindowTab contiene 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 transmiten como argumentos al constructor. Para los métodos openInfoWindowTabs(), content es un nodo DOM. Para 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 incluir en el argumento tabs para métodos openInfoWindowTabs*(). |
Crea una instancia de esta clase para añadir enlaces de teclado a un mapa. Los enlaces clave son los mismos que los de la aplicación de mapas.
| Teclas | Acción |
|---|---|
| Flechas arriba, abajo, izquierda, derecha | Desplaza el mapa de forma continua mientras se pulsa la tecla. Se pueden pulsar dos teclas de forma simultánea para desplazar el mapa en diagonal. |
| Re Pág, Av Pág, Inicio, Fin | Desplaza el mapa 3/4 de su tamaño en la dirección correspondiente, con una atractiva animación. Se corresponde a los botones de flecha en GLargeMapControl y GSmallMapControl. |
| +, - | Acerca o aleja la imagen un nivel, respectivamente. Se corresponde a los botones + y - en GLargeMapControl y GSmallMapControl. |
| Constructor | Descripción |
|---|---|
GKeyboardHandler(map:GMap2)
|
Instala el controlador de eventos del teclado del mapa que se ha transmitido como argumento. |
Este espacio de nombre contiene métodos útiles para identificar la configuración de idioma que actualmente utiliza una aplicación. La configuración de idioma se suele establecer según la preferencia del navegador pero se puede anular en la secuencia de comandos de carga del API de Google Maps a través del parámetro hl. (Para obtener más información, consulta la sección Localización del API de Google Maps).
Nota: dado que los idiomas bidireccionales (por ejemplo, el árabe y el hebreo) afectan al diseño del objeto GInfoWindow, se seleccionan solo si se han solicitado de forma específica a través de un parámetro hl aplicable o mediante la adición del parámetro allow_bidi=true a la solicitud de inicialización del API.
Para obtener más información sobre BCP 47, consulta la documentación W3.
| Método | Valor de retorno | Descripción |
|---|---|---|
GLanguage.getLanguageCode()
|
String |
Devuelve el código de idioma BCP 47 (por ejemplo, "en" o "pt-BR") que utiliza la aplicación. (A partir de la versión 2.148) |
GLanguage.isRtl()
|
boolean |
Devuelve true únicamente si el diseño de la interfaz de usuario de la aplicación es de derecha a izquierda en los idiomas bidireccionales como el árabe o el hebreo.(A partir de la versión 2.148) |
La clase GLatLng es un punto en las coordenadas geográficas con longitud y latitud.
Ten en cuenta que aunque las proyecciones de mapas normales asocian la longitud con la coordenada x del mapa y la latitud con la coordenada y, la coordenada de latitud siempre se escribe primero, seguida de la longitud, según la costumbre en cartografía.
Además, debes tener en cuenta que no puedes modificar las coordenadas de GLatLng. Si deseas calcular otro punto, deberás crear uno nuevo.
| Constructor | Descripción |
|---|---|
GLatLng(lat:Number,
lng:Number,
unbounded?:Boolean)
|
Fíjate en el orden de la latitud y de la longitud. Si la etiqueta unbounded es true, los números se utilizarán según el orden de transferencia, de lo contrario la latitud se establecerá entre -90 y +90 grados, mientras que la longitud oscilará entre -180 y +180 grados. |
| Método | Valor de retorno | Descripción |
|---|---|---|
lat()
|
Number |
Devuelve la coordenada de latitud en grados como un número entre -90 y +90. Si la etiqueta unbounded se estableció en el constructor, se podrá utilizar un valor fuera de este intervalo para esta coordenada. |
lng()
|
Number |
Devuelve la coordenada de longitud en grados como un número entre -180 y +180. Si la etiqueta unbounded se estableció en el constructor, se podrá utilizar un valor fuera de este intervalo para esta coordenada. |
latRadians()
|
Number |
Devuelve la coordenada de latitud en radianes como un número entre -PI/2 y +PI/2. Si la etiqueta unbounded se estableció en el constructor, se podrá utilizar un valor fuera de este intervalo para esta coordenada. |
lngRadians()
|
Number |
Devuelve la coordenada de longitud en radianes como un número entre -PI y +PI. Si la etiqueta unbounded se estableció en el constructor, se podrá utilizar un valor fuera de este intervalo para esta coordenada. |
equals(other:GLatLng)
|
Boolean |
Devuelve true únicamente si el otro tamaño tiene los mismos componentes, dentro de determinados márgenes de redondeo. |
distanceFrom(other:GLatLng,
radius?:Number)
|
Number |
Devuelve la distancia en metros desde esta ubicación a la ubicación indicada. De forma predeterminada, esta distancia se calcula a partir del radio ecuatorial estándar de la Tierra de 6378137 metros. La Tierra no es una esfera exacta, por lo que la distancia podría variar hasta en un 0,3%, especialmente en los extremos polares. También puede transmitir un argumento opcional radius para calcular las distancias entre las coordenadas GLatLng en esferas de un radio diferente al de la Tierra.(A partir de la versión 2.89) |
toUrlValue(precision?:Number)
|
String |
Devuelve una cadena que representa la ubicación en cuestión en un formato adecuado para utilizarlo como valor de parámetro URL, separado por una coma y sin espacio en blanco. De forma predeterminada, la precisión se devuelve en seis dígitos, los cuales corresponden a una resolución de 11 centímetros. Un parámetro opcional precision permite especificar una menor precisión para reducir la carga del servidor. Nota: antes de la versión 2.78, el parámetro
precision no estaba disponible.(A partir de la versión 2.78) |
| Método | Valor de retorno | Descripción |
|---|---|---|
GLatLng.fromUrlValue(latlng:String)
|
GLatLng |
Convierte el valor String de latitud/longitud proporcionado en un objeto GLatLng. La cadena transmitida debe estar en el formato "latitud,longitud". Los espacios entre los valores de latitud y longitud se ignorarán. Este método devolverá GLatLng con precisión para seis dígitos.(A partir de la versión 2.78) |
Estas propiedades son compatibles retroactivamente solo con las funciones de la versión 1 del controlador de eventos. No se deben utilizar.
Estas propiedades reflejan los valores de retorno de los métodos de acceso lng() y lat() y permiten que GLatLng aparezca en lugares donde un cliente de la versión 1 espera un objeto GPoint. Esto es necesario cuando aparece GLatLng en los detalles de un evento (es decir, en argumentos de funciones del controlador de eventos). Al contrario que los envoltorios de métodos, resulta imposible crear envoltorios de eventos con la infraestructura actual.
| Propiedad | Tipo | Descripción |
|---|---|---|
x
|
Number |
Obsoleta |
y
|
Number |
Obsoleta |
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 a partir de los puntos situados en las esquinas suroccidental y nororiental. |
| Método | Valor de retorno | Descripción |
|---|---|---|
equals(other:GLatLngBounds)
|
Boolean |
Devuelve true únicamente si todos los parámetros de este rectángulo son iguales a los parámetros del otro, dentro de un determinado margen de redondeo. |
containsLatLng(latlng:GLatLng)
|
Boolean |
Devuelve true únicamente si las coordenadas geográficas del punto se encuentran dentro de este rectángulo.(A partir de la versión 2.88) |
intersects(other:GLatLngBounds)
|
Boolean |
Devuelve true únicamente si el valor transferido de GLatLngBounds crea una intersección con el valor actual de GLatLngBounds. Los extremos compartidos cuentan como intersecciones. |
containsBounds(other:GLatLngBounds)
|
Boolean |
Devuelve true únicamente si el valor transferido de GLatLngBounds está completamente dentro de los límites actuales de GLatLngBounds. Los extremos compartidos cuentan como límites "dentro" de otros límites. |
extend(latlng:GLatLng)
|
None |
Amplía este rectángulo hasta incluir el punto especificado. En dirección longitudinal, se amplía de la forma más pequeña de las dos posibles. Si ambas son iguales, se amplía por el límite oriental. |
getSouthWest()
|
GLatLng |
Devuelve el punto de la esquina sudoeste del rectángulo. |
getNorthEast()
|
GLatLng |
Devuelve el punto de la esquina nordeste del rectángulo. |
toSpan()
|
GLatLng |
Devuelve un objeto GLatLng cuyas coordenadas representan el tamaño de este rectángulo. |
isFullLat()
|
Boolean |
Devuelve true únicamente si este rectángulo se extiende desde el Polo Sur hasta el Polo Norte. |
isFullLng()
|
Boolean |
Devuelve true únicamente si este rectángulo se extiende completamente alrededor de la Tierra en dirección longitudinal. |
isEmpty()
|
Boolean |
Devuelve true únicamente si este rectángulo está vacío. |
getCenter()
|
GLatLng |
Devuelve el punto del centro del rectángulo. (A partir de la versión 2.52) |
Este espacio de nombre contiene algunos métodos estáticos que ayudan a depurar aplicaciones web. Al utilizar uno de los métodos write*() por primera vez, se abre una ventana flotante en la página con los mensajes escritos.
| Método | Valor de retorno | Descripción |
|---|---|---|
GLog.write(message:String,
color?:String)
|
None |
Escribe el mensaje como texto sin formato en la ventana de registro. Se aplicará el formato de escape adecuado a los caracteres de marcado HTML, de forma que aparezcan como caracteres. |
GLog.writeUrl(url:String)
|
None |
Escribe un enlace a la URL especificada en la ventana de registro. |
GLog.writeHtml(html:String)
|
None |
Escribe texto como HTML en la ventana de registro. |
Esta clase representa argumentos opcionales del constructor GMap2. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
size
|
GSize |
Establece el tamaño en píxeles del mapa. El tamaño del contenedor que se transmite al constructor del mapa se cambiará de acuerdo con el tamaño que se indique. De forma predeterminada, el mapa adoptará el tamaño de su contenedor. |
mapTypes
|
GMapType[] |
Conjunto de tipos de mapa que se utilizarán en este mapa. De forma predeterminada se utilizará G_DEFAULT_MAP_TYPES. Puedes emplear esta opción para restringir el conjunto de tipos de mapas predeterminados que aparecen en el mapa o para transmitir tus propios tipos de mapas al mapa. Consulta también GMap2.addMapType(). |
draggableCursor
|
String |
El cursor que se mostrará cuando el mapa se pueda arrastrar. (A partir de la versión 2.59) |
draggingCursor
|
String |
El cursor que se mostrará mientras se arrastra el mapa. (A partir de la versión 2.59) |
googleBarOptions
|
GGoogleBarOptions |
Esta propiedad especifica las opciones para configurar el control de búsqueda de GoogleBar. Estas opciones se transmiten al objeto literal GMapOptions cuando se construye el mapa y se utilizan para crear el control de GoogleBar cuando se ejecuta 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 del mapa. El color puede ser cualquier valor de color estándar W3C válido. (A partir de la versión 2.119) |
Estas constantes definen el orden de colocación (orden z) utilizado por el mapa y los objetos del mapa con fines de visualización. Cada panel define un conjunto de objetos de visualización similares para mostrar en el mapa, además de un orden z único en el mapa. Los paneles con un orden z superior se mostrarán "sobre" los paneles con un orden z inferior. (Ten en cuenta que los objetos de un determinado panel también pueden mostrar su propio orden z de precedencia; algunos objetos pueden aparecer sobre otros objetos dentro de ese panel).
Es necesario utilizar estas constantes si se establecen subclases de GOverlay para poder colocar una superposición personalizada en uno de los paneles.
Las siguientes constantes aparecen en orden desde el orden z más bajo (parte inferior) hasta el más alto (parte superior).
| Constante | Descripción |
|---|---|
G_MAP_MAP_PANE
|
Este panel es el panel inferior y queda por encima de los mosaicos |
G_MAP_OVERLAY_LAYER_PANE
|
Este panel contiene polilíneas, polígonos, superposiciones de suelo y superposiciones de capas de mosaicos
(A partir de la versión 2.127) |
G_MAP_MARKER_SHADOW_PANE
|
Este panel contiene las sombras de los marcadores |
G_MAP_MARKER_PANE
|
Este panel contiene las imágenes de marcador en primer plano |
G_MAP_FLOAT_SHADOW_PANE
|
Este panel contiene la sombra de la ventana de información. Queda por encima de G_MAP_MARKER_PANE, de modo 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 y queda por encima de todas las superposiciones del mapa |
GPoint representa un punto del mapa mediante sus coordenadas de píxeles. Ten en cuenta que en la versión 2, ya no representa un punto de la Tierra según sus coordenadas geográficas. Las coordenadas geográficas ahora se representan mediante 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 de GPoint de la forma que quieras.
Ten en cuenta que aunque se puede acceder a los dos parámetros de un punto GPoint mediante las propiedades x e y, es mejor que nunca los modifiques, sino que crees un nuevo objeto 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 aumenta hacia la derecha en el sistema de coordenadas de Google Maps). |
y
|
Number |
Coordenada y. (Este valor aumenta hacia abajo en el sistema de coordenadas de Google Maps). |
| Método | Valor de retorno | Descripción |
|---|---|---|
equals(other:GPoint)
|
Boolean |
Devuelve true únicamente 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 comas. |
| Constante | Descripción |
|---|---|
ORIGIN
|
La constante new GPoint(0, 0) |
GSize es el tamaño en píxeles de un área rectangular del mapa. Este objeto de tamaño dispone de dos parámetros, width y height. El ancho (width) es una diferencia de puntos en la coordenada x, mientras que la altura (height) es una diferencia de puntos en la coordenada y.
Ten en cuenta que aunque se puede acceder a los dos parámetros de un punto GSize mediante las propiedades width e height, es mejor que nunca los modifiques, sino que crees un nuevo objeto 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 de retorno | Descripción |
|---|---|---|
equals(other:GSize)
|
Boolean |
Devuelve true únicamente si el otro tamaño tiene exactamente los mismos componentes. |
toString()
|
String |
Devuelve una cadena que contiene los parámetros de altura y ancho, en este orden, separados por comas. |
| Constante | Descripción |
|---|---|
ZERO
|
La constante new GSize(0, 0) |
Esta función hace que el API de mapas limpie las estructuras de datos internas para liberar memoria. Esto resulta útil para solucionar varios errores de navegador que causan la pérdida de memoria en las aplicaciones web. Debes ejecutar esta función en el controlador de eventos unload de la página. Tras ejecutar esta función, los objetos del mapa que hayas creado en esta página dejarán de funcionar.
| Método | Valor de retorno | Descripción |
|---|---|---|
GUnload()
|
None |
Desmonta todos los controladores de eventos registrados para evitar que haya pérdidas de memoria. Se debe ejecutar como un controlador del evento unload. |
Esta constante especifica la versión del API que se está utilizando actualmente en tu página. Para obtener más información sobre la versión, consulta las actualizaciones del API.
| Método | Valor de retorno | Descripción |
|---|---|---|
()
|
None |
Devuelve la versión del API que se utiliza actualmente en tu página. |
Este espacio de nombres contiene funciones que se utilizan para registrar controladores 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 GEvent.trigger() activa internamente.
| Método | Valor de retorno | Descripción |
|---|---|---|
GEvent.addListener(source:Object,
event:String,
handler:Function)
|
GEventListener |
Registra un controlador de eventos de un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del controlador. Se llamará al controlador de eventos con this definido en el objeto de origen. |
GEvent.addDomListener(source:Node,
event:String,
handler:Function)
|
GEventListener |
Registra un controlador 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 controlador. Se ejecutará el controlador de eventos con this establecido en el objeto de origen. Esta función utiliza los métodos DOM del navegador en uso para poder registrar el controlador de eventos. |
GEvent.removeListener(handle:GEventListener)
|
None |
Elimina un controlador instalado con addListener() o con addDomListener(). |
GEvent.clearListeners(source:Object or Node,
event:String)
|
None |
Elimina todos los controladores en el objeto indicado del evento en cuestión que se instalaron con addListener() o con addDomListener(). |
GEvent.clearInstanceListeners(source:Object or Node)
|
None |
Elimina todos los controladores en el objeto indicado de todos los eventos que se instalaron con addListener() o con addDomListener(). |
GEvent.clearNode(source:Node)
|
None |
Ejecuta clearInstanceListeners en un nodo y todos sus subnodos recursivamente. |
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 transmiten a su vez como argumentos a las funciones del controlador 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 controlador de eventos de un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del controlador. |
GEvent.bindDom(source:Node,
event:String,
object:Object,
method:Function)
|
GEventListener |
Registra una invocación del método en el objeto indicado como el controlador de eventos de un evento personalizado en el objeto de origen. Devuelve una instrucción que se puede utilizar en otro momento para anular el registro del controlador. |
GEvent.callback(object:Object,
method:Function)
|
Function |
Devuelve un cierre que ejecuta method en object. |
GEvent.callbackArgs(object:Object,
method:Function,
...)
|
Function |
Devuelve un cierre que ejecuta method en object. El resto de los argumentos opcionales después de method se transmiten a su vez como argumentos a method cuando se ejecuta la función devuelta. |
| Evento | Descripción |
|---|---|
clearlisteners(event?:String)
|
Este evento se activa en un objeto cuando se ejecuta clearListeners() o clearInstanceListeners() en ese objeto. Por supuesto, el evento se activa antes de que se ejecuten las funciones. |
Esta clase es opaca. No incluye ningún método ni ningún constructor. Sus instancias proceden de GEvent.addListener() o de GEvent.addDomListener() y se vuelven a transmitir a GEvent.removeListener().
Esta interfaz se implementa mediante todos los controles. Puedes implementarla para ofrecer un control personalizado sobre el mapa. Para añadir controles al mapa se utiliza el método GMap2.addControl().
Al contrario que las superposiciones, que se colocan en relación al mapa, los controles se colocan en relación a la vista de mapa, es decir, que no se mueven cuando se mueve el mapa.
| Constructor | Descripción |
|---|---|
GControl(printable?:Boolean,
selectable?:Boolean)
|
Crea la instancia de prototipo para una nueva clase de control. La etiqueta printable indica que el control debe ser visible cuando se imprima el mapa. La etiqueta selectable indica que el texto del control debe ser seleccionable. |
El mapa ejecutará estos métodos cuando el control se añada al mapa mediante GMap2.addControl(). Por tanto, tú no ejecutas estos métodos, solo los implementas.
| Método | Valor de retorno | Descripción |
|---|---|---|
printable()
|
Boolean |
Devuelve al mapa si el control debe ser imprimible. |
selectable()
|
Boolean |
Devuelve al mapa si el control contiene texto seleccionable. |
initialize(map:GMap2)
|
Node |
El mapa ejecutará este método para que el control pueda inicializarse. El control utilizará el método GMap2.getContainer() para obtener el elemento DOM que contiene el mapa y agregarse a sí mismo a este. Devuelve el elemento añadido. |
getDefaultPosition()
|
GControlPosition |
Devuelve al mapa la posición de la vista de mapa en la que aparece el control de forma predeterminada. Se anula con el segundo argumento de GMap2.addControl(). |
| 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. |
Estas implementaciones de interface
GControl están disponibles.
| Constructor | Descripción |
|---|---|
GSmallMapControl()
|
Crea un control con botones para desplazarse en cuatro direcciones y para acercar y alejar la imagen. |
GLargeMapControl()
|
Crea un control con botones para desplazarse en cuatro direcciones y para acercar y alejar la imagen y un control deslizante de zoom. |
GSmallZoomControl()
|
Crea un control con botones para acercar y alejar la imagen. |
GLargeMapControl3D()
|
Crea un nuevo control de estilo en 3D con botones para desplazarse en cuatro direcciones y para acercar y alejar la imagen y un control deslizante de zoom. Cuando el mapa se hace rotatorio por primera vez, GLargeMapControl3D cambiará de posición para incluir un anillo con brújula que se puede girar para cambiar el tipo de mapa actual por otro con un encabezado diferente. |
GSmallZoomControl3D()
|
Crea un nuevo control de estilo en 3D 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 para pasar de uno a otro a través de botones y casillas de verificación anidadas. |
GOverviewMapControl()
|
Crea un minimapa de vista general que se puede contraer en la esquina del mapa principal como referencia para navegación y ubicación (mediante arrastre). GOverviewMapControl crea un mapa de vista general con un borde negro de un píxel. Nota: a diferencia de otros controles, únicamente puedes colocar este control en la esquina inferior derecha del mapa (G_ANCHOR_BOTTOM_RIGHT).
|
GNavLabelControl()
|
Crea una etiqueta "breadcrumb" (ruta de acceso) dinámica que indica la dirección de la ventana gráfica actual como una serie de componentes de dirección anidados. Además, este control proporciona enlaces de navegación para cada subcomponente de dirección individual.
(A partir de la versión 2.141) |
Esta clase describe la posición de un control en la vista de mapa. Consiste en una esquina relativa a la posición del control y una desviación que determina esta posición. Se puede transmitir como argumento opcional position al método GMap2.addControl() y devolverse con el método GControl.getDefaultPosition().
| Constructor | Descripción |
|---|---|
GControlPosition(anchor:enum GControlAnchor,
offset:GSize)
|
Crea una especificación para la posición de un control. |
GHierarchicalMapTypeControl proporciona un control de tipo de mapa "anidado" para seleccionar tipos de mapas admitidos y para 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 mapa añadidos al mapa aparecen como botones, como en el control GMapTypeControl normal. Sin embargo, los tipos de mapa establecidos como subtipos de otros tipos de mapa (consulta el método addRelationship() a continuación) aparecerán como elementos de submenú de casillas de verificación debajo del botón principal.
De forma predeterminada, los mapas admiten el conjunto de G_DEFAULT_MAP_TYPES, aunque también pueden añadir tipos de mapa explícitamente 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 como los subtipos aparecen en forma de casillas de verificación, puedes cambiar su apariencia respecto a la del tipo principal o a la del resto de subtipos.
| Constructor | Descripción |
|---|---|
GHierarchicalMapTypeControl()
|
Construye el control. De forma predeterminada, el tipo de mapa G_HYBRID_MAP se convierte en subtipo del tipo de mapa G_SATELLITE_MAP. Si no deseas esto, ejecuta el método clearRelationships() para eliminar esta relación. |
| Método | Valor de retorno | Descripción |
|---|---|---|
addRelationship(parentType:GMapType,
childType:GMapType,
childText?:String,
isDefault?:Boolean)
|
None |
Registra una relación tipo/subtipo entre tipos de mapa con el control. Si se especifica childText, se mostrará junto a la casilla de verificación del subtipo de mapa en lugar de su nombre. Si isDefault es verdadero, el subtipo de mapa se seleccionará de forma predeterminada. Ten en cuenta que todas las relaciones se deben configurar antes de que se añada el control. (Las relaciones que se añadan después de añadir el control no tendrás efecto).(A partir de la versión 2.94) |
removeRelationship(mapType:GMapType)
|
None |
Elimina del control todas las relaciones que impliquen un tipo de mapa. (A partir de la versión 2.94) |
clearRelationships()
|
None |
Elimina todas las relaciones del control. (A partir de la versión 2.94) |
Google ofrece algunos tipos de mapa predefinidos (esta clase permite definir tipos personalizados). Para que aparezcan en el mapa, utiliza el constructor GMap2 o el método GMap2.addMapType(). Consulta también GTileLayerOverlay para añadir capas de mosaicos al mapa (en lugar de sustituirlas por completo).
Esta clase también se puede dividir en subclases. Los argumentos del constructor se pueden omitir si crean instancias como un prototipo. El constructor de una subclase debe ejecutar el constructor GMapType con call().
| Constructor | Descripción |
|---|---|
GMapType(layers:GTileLayer[],
projection:GProjection,
name:String,
opts?:GMapTypeOptions)
|
Construye un tipo de mapa con las capas de mosaico, la proyección, el nombre y parámetros opcionales especificados. |
Estos métodos se suelen ejecutar con el mapa al que se transmite este tipo de mapa, aunque algunos métodos también se pueden ejecutar desde fuera del mapa (por ejemplo, getBoundsZoomLevel()).
| Método | Valor de retorno | Descripción |
|---|---|---|
getSpanZoomLevel(center:GLatLng,
span:GLatLng,
viewSize:GSize)
|
Number |
Devuelve al mapa el nivel de zoom en el que la sección del mapa definida por las opciones "center" y "span" se ajusta a la vista del mapa del tamaño indicado en píxeles. |
getBoundsZoomLevel(bounds:GLatLngBounds,
viewSize:GSize)
|
None |
Devuelve al mapa el nivel de zoom 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 se va a utilizar como etiqueta del botón en GMapTypeControl. |
getProjection()
|
GProjection |
Devuelve al mapa la proyección de este tipo de mapa. |
getTileSize()
|
Number |
Devuelve al mapa el tamaño de mosaico del mapa en píxeles de este tipo de mapa. Se asume que los mosaicos son cuadráticos. Todas las capas de mosaico tienen el mismo tamaño de mosaico. |
getTileLayers()
|
GTileLayer[] |
Devuelve al mapa el conjunto de capas de mosaico. |
getMinimumResolution()
|
Number |
Devuelve al mapa el nivel de zoom más bajo en el que está definido el tipo de mapa en cuestión. |
getMaximumResolution()
|
Number |
Devuelve al mapa el nivel de zoom más alto en el que está definido el tipo de mapa en cuestión. |
getMaxZoomAtLatLng(latlng:GLatLng,
callback:Function,
opt_targetZoom:number)
|
None |
Envía una solicitud a los servidores de Google para buscar el nivel de zoom máximo del que existen imágenes para este tipo de mapa en el GLatLng determinado. La función de devolución de llamada se ejecutará con una respuesta que contiene un código status y, en caso correcto, un valor zoom del nivel de zoom máximo. Si se establece opt_targetZoom, solo se tendrán en cuenta los niveles de zoom hasta opt_targetZoom. Nota: esta función solo se implementa para las imágenes de satélite, para el tipo de mapa G_SATELLITE_MAP y para el tipo de mapa G_HYBRID_MAP.(A partir de la versión 2.158) |
getTextColor()
|
String |
Devuelve al mapa el color más adecuado para texto superpuesto al mapa. Se utiliza para el color del texto del mensaje de derechos de autor que muestra el control de los derechos de autor. |
getLinkColor()
|
String |
Devuelve al mapa el color más adecuado para un hipervínculo superpuesto al mapa. Permite establecer el color del enlace a los Términos de uso del control de derechos de autor. |
getErrorMessage()
|
String |
Devuelve al mapa el mensaje de error que se muestra en áreas o en niveles de zoom 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 adecuados para la región descrita por bounds en el nivel de zoom especificado. Esto se utiliza en el mensaje de derechos de autor del mapa. |
getUrlArg()
|
String |
Devuelve al mapa un valor que se utiliza como parámetro de URL para identificar el tipo de este mapa en enlaces permanentes a la vista de mapa actual. Actualmente solo lo usa la aplicación de mapas. (Obsoleto desde la versión 2.210) |
getAlt()
|
String |
Devuelve al mapa el texto alternativo de este tipo de mapa. (A partir de la versión 2.86) |
getHeading()
|
Number |
Devuelve el encabezado de este tipo de mapa. El encabezado se define como el ángulo de visualización del tipo de mapa, medido en el sentido de las agujas del reloj en ángulos de la cuadrícula norte, que es 0. (A partir de la versión 2.193) |
| Constante | Descripción |
|---|---|
G_NORMAL_MAP
|
Este tipo de mapa (que es el predeterminado) muestra un callejero normal. |
G_SATELLITE_MAP
|
Este tipo de mapa muestra imágenes vía satélite. |
G_AERIAL_MAP
|
Este tipo de mapa muestra imágenes aéreas. (A partir de la versión 2.193) |
G_HYBRID_MAP
|
Este tipo de mapa muestra una capa transparente de calles principales en imágenes por satélite. |
G_AERIAL_HYBRID_MAP
|
Este tipo de mapa muestra una capa transparente con calles principales sobre imágenes aéreas. (A partir de la versión 2.193) |
G_PHYSICAL_MAP
|
Este tipo de mapa muestra mapas con ciertos rasgos físicos como, por ejemplo, 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_MAPMAKER_NORMAL_MAP
|
Este tipo de mapa muestra un callejero que incluye mosaicos creados con Google Map Maker.
Nota: cuando utilices un tipo de mapa de Google Map Maker, los usuarios solo verán los mapas de los países en los que se haya lanzado Google Map Maker. (A partir de la versión 2.145) |
G_MAPMAKER_HYBRID_MAP
|
Este tipo de mapa muestra una capa transparente de las principales calles creadas con Google Map Maker en imágenes de satélite.
Nota: cuando utilices un tipo de mapa de Google Map Maker, los usuarios solo verán los mapas de los países en los que se haya lanzado Google Map Maker. (A partir de la versión 2.145) |
G_MOON_ELEVATION_MAP
|
Este tipo de mapa muestra un mapa de relieve con sombras de la superficie de la Luna, con las altitudes codificadas mediante 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 realizadas desde una ó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 de relieve con sombras de la superficie de Marte, con las altitudes codificadas mediante 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 realizadas desde una ó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, en el que 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 cielo que abarca toda 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 de la Tierra en 3D y totalmente interactivo 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 solo 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 se 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 de la Tierra en 3D. Puedes 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. Planeamos añadir más funciones en futuras versiones. (A partir de la versión 2.113) |
G_DEFAULT_MAP_TYPES
|
Conjunto de los tres primeros tipos de mapa predefinidos descritos anteriormente (G_NORMAL_MAP, G_SATELLITE_MAP y G_HYBRID_MAP) |
G_MAPMAKER_MAP_TYPES
|
Un conjunto de los tipos de mapas de Google Map Maker descritos anteriormente (G_MAPMAKER_NORMAL_MAP, G_SATELLITE_MAP y G_MAPMAKER_HYBRID_MAP) |
G_MOON_MAP_TYPES
|
Conjunto de los dos tipos de Luna definidos anteriormente (G_MOON_ELEVATION_MAP and G_MOON_VISIBLE_MAP) |
G_MARS_MAP_TYPES
|
Conjunto de los tres tipos de mapa de Marte definidos anteriormente (G_MARS_ELEVATION_MAP, G_MARS_VISIBLE_MAP, and G_MARS_INFRARED_MAP) |
G_SKY_MAP_TYPES
|
Conjunto del tipo de mapa del cielo definido anteriormente (G_SKY_VISIBLE_MAP) |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se añade un nuevo elemento de derechos de autor a la recopilación de derechos de autor de una de las capas de mosaico contenidas en este tipo de mapa. |
La clase GMapTypeControl proporciona un control para seleccionar tipos de mapas admitidos y para 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 el conjunto de G_DEFAULT_MAP_TYPES; los mapas también pueden añadir tipos de mapa explícitamente a través de GMap2.addMapType(). Para conservar espacio en el mapa, puedes utilizar GHierarchicalMapTypeControlpara mostrar tipos de mapa "anidados" o GMenuMapTypeControl para mostrar un menú desplegable de tipos de mapa.
| Constructor | Descripción |
|---|---|
GMapTypeControl(useShortNames?:Boolean)
|
Crea un control GMapTypeControl con los nombres cortos (alt) de los tipos de mapa si useShortNames se establece en true y con los nombres largos de forma predeterminada. |
Las instancias de esta clase se utilizan como el argumento opts? en el constructor GMapType. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
| Propiedad | Tipo | Descripción |
|---|---|---|
shortName
|
String |
Establece el nombre corto del tipo de mapa devuelto por GMapType.getName(true). De forma predeterminada se utilizará el valor de name. |
urlArg
|
String |
Establece el argumento de URL del tipo de mapa devuelto por GMapType.getUrlArg(). De forma predeterminada se utilizará una cadena vacía.(Obsoleto desde la versión 2.210) |
maxResolution
|
Number |
Establece el nivel máximo de zoom de este tipo de mapa que devuelve GMapType.getMaximumResolution(). De forma predeterminada se utilizará el máximo de todas las capas de mosaico. |
minResolution
|
Number |
Establece el nivel mínimo de zoom de este tipo de mapa que devuelve GMapType.getMinimumResolution(). De forma predeterminada se utilizará el mínimo de todas las capas de mosaico. |
tileSize
|
Number |
Establece el tamaño de mosaico devuelto por GMapType.getTileSize(). El valor predeterminado es 256. |
textColor
|
String |
Establece el color de texto devuelto por GMapType.getTextColor(). El valor predeterminado es "black". |
linkColor
|
String |
Establece el color de texto devuelto por GMapType.getLinkColor(). El valor predeterminado es "#7777cc". |
errorMessage
|
String |
Establece el mensaje de error devuelto por GMapType.getErrorMessage(). De forma predeterminada se utilizará una cadena vacía. |
alt
|
String |
Establece el texto alternativo del tipo de mapa devuelto por GMapType.getAlt(). De forma predeterminada se utilizará una cadena vacía.(A partir de la versión 2.64) |
radius
|
Number |
Establece el radio del tipo de mapa según el valor transmitido de Number medido en metros. El valor predeterminado es 378137, que equivale al radio ecuatorial de la Tierra en metros.(A partir de la versión 2.89) |
heading
|
Number |
Esta propiedad contiene el encabezado del tipo de mapa en grados. El valor predeterminado es 0. (A partir de la versión 2.193) |
Esta clase representa un conjunto de opciones de interfaz de usuario para el mapa.
| Constructor | Descripción |
|---|---|
GMapUIOptions(opt_size:GSize)
|
Crea un conjunto de opciones de interfaz de usuario, con valores establecidos como predeterminados adecuados para un mapa del tamaño indicado. Un mapa "pequeño" es aquel que tiene un tamaño inferior a 400 píxeles de ancho o a 300 píxeles de alto. Un mapa "grande" es cualquier mapa de 400x300 píxeles o de un tamaño superior. |
| Propiedad | Tipo | Descripción |
|---|---|---|
maptypes.normal
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir al mapa el tipo normal de GMapType (G_NORMAL_MAP). El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
maptypes.satellite
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir al mapa el tipo de satélite de GMapType (G_SATELLITE_MAP). El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
maptypes.hybrid
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir al mapa el tipo híbrido de GMapType (G_HYBRID_MAP). El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
maptypes.physical
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir al mapa el tipo físico (relieve) de GMapType (G_PHYSICAL_MAP). El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
zoom.scrollwheel
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe habilitar la posibilidad de acercar y alejar el mapa con la rueda de desplazamiento. El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
zoom.doubleclick
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe habilitar la posibilidad de acercar o alejar el mapa al hacer doble clic. El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
keyboard
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe habilitar GKeyboardHandler en el mapa. El valor predeterminado de esta propiedad es true. (A partir de la versión 2.147) |
controls.largemapcontrol3d
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GLargeMapControl3D al mapa. Para mapas "grandes", esta propiedad es true de forma predeterminada.(A partir de la versión 2.147) |
controls.smallzoomcontrol3d
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GSmallZoomControl3D al mapa. Para mapas "pequeños", esta propiedad es true de forma predeterminada.(A partir de la versión 2.147) |
controls.maptypecontrol
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GMapTypeControl al mapa. Para mapas "grandes", esta propiedad es true de forma predeterminada.(A partir de la versión 2.147) |
controls.menumaptypecontrol
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GMenuMapTypeControl al mapa. Para mapas "pequeños", esta propiedad es true de forma predeterminada.(A partir de la versión 2.147) |
controls.scalecontrol
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GScaleControl al mapa. Para mapas "grandes", esta propiedad es true de forma predeterminada.(A partir de la versión 2.147) |
controls.overviewmapcontrol
|
Boolean |
Cuando se establece en true, esta propiedad especifica que se debe añadir GOverviewMapControl al mapa. Para todos los mapas, esta propiedad es false de forma predeterminada.(A partir de la versión 2.147) |
Una clase GMenuMapTypeControl proporciona un control para seleccionar tipos de mapas admitidos y para 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 el conjunto de G_DEFAULT_MAP_TYPES; los mapas también pueden añadir tipos de mapa explícitamente a través de GMap2.addMapType().
| Constructor | Descripción |
|---|---|
GMenuMapTypeControl(useShortNames?:Boolean)
|
Crea un control GMenuMapTypeControl con los nombres cortos (alt) de los tipos de mapa si useShortNames se establece en true y con los nombres largos de forma predeterminada. |
Una clase GNavLabelControl proporciona un control para una etiqueta "breadcrumb" (ruta de acceso) dinámica que indica la dirección de la ventana gráfica actual como una serie de componentes de dirección anidados. Además, este control proporciona enlaces de navegación para cada subcomponente de dirección individual.
De forma predeterminada, este control se encuentra en la esquina superior derecha de la ventana gráfica. Se ocultará después de diez segundos de inactividad y se mostrará al hacer clic en el mapa o al producirse un cambio en la ventana gráfica del mismo. También se oculta si la dirección de la ventana gráfica actual no está disponible.
| Constructor | Descripción |
|---|---|
GNavLabelControl()
|
Crea GNavLabelControl.(A partir de la versión 2.141) |
| Método | Valor de retorno | Descripción |
|---|---|---|
setMinAddressLinkLevel(level:Number)
|
None |
Establece el nivel de dirección mínimo que tiene un enlace en la etiqueta. Por ejemplo, muestra los enlaces de dirección de todas las direcciones de "EE.UU. > NY > Brooklyn" para el nivel 0 y muestra el enlace de dirección solo para "Brooklyn" en el caso del nivel 2. El nivel predeterminado es el 0. (A partir de la versión 2.162) |
Un objeto de derechos de autor contiene información sobre los mensajes de derechos de autor que se aplican a las diferentes regiones del mapa divididas en rectángulos, en un nivel de zoom determinado. Solo 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 especificadas. |
| Propiedad | Tipo | Descripción |
|---|---|---|
id
|
Number |
Identificador único para esta información de derechos de autor. |
minZoom
|
Number |
El nivel de zoom 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 clase permite administrar los mensajes de derechos de autor que se muestran 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 zoom. 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 producidos por esta recopilación de derechos de autor tendrán como prefijo común el argumento especificado. Ejemplo: "Imagery (C) 2006" |
| Método | Valor de retorno | Descripción |
|---|---|---|
addCopyright(copyright:GCopyright)
|
None |
Añade un objeto de información de derechas 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 determinada en un nivel de zoom concreto. Ejemplo: [ "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 determinada en un nivel de zoom concreto. Ejemplo: "Imagery (C) 2006 Google, Keyhole" |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se añade un nuevo elemento de derechos de autor a esta recopilación de derechos de autor. |
Este objeto crea una superposición de imagen rectangular sobre el mapa, cuyos límites se definen mediante GLatLngBounds.
| Constructor | Descripción |
|---|---|
GGroundOverlay(imageUrl:String,
bounds:GLatLngBounds)
|
Crea una superposición de suelo a partir de una URL de imagen y sus límites. (A partir de la versión 2.79) |
| Método | Valor de retorno | Descripción |
|---|---|---|
hide()
|
None |
Oculta la superposición de suelo si está visible en ese momento. Ten en cuenta que esta función activa el evento GGroundOverlay.visibilitychanged si la superposición de suelo está visible en ese momento.(A partir de la versión 2.87) |
isHidden()
|
Boolean |
Devuelve true únicamente si la superposición de suelo está oculta en ese momento.(A partir de la versión 2.87) |
show()
|
None |
Muestra la superposición de suelo si está oculta en ese momento. Ten en cuenta que esta función activa el evento GGroundOverlay.visibilitychanged si la superposición de 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 de suelo cambia de visible a oculto o viceversa. El argumento isVisible refleja el estado de la superposición de suelo después de completar este estado de visibilidad.
(A partir de la versión 2.77) |
Un icono especifica las imágenes utilizadas para mostrar un GMarker en el mapa. Por razones de compatibilidad con los navegadores, especificar un icono resulta bastante complejo. Ten en cuenta que puedes utilizar el icono predeterminado de Google Maps (G_DEFAULT_ICON) si no deseas especificar uno propio.
| Constructor | Descripción |
|---|---|
GIcon(copy?:GIcon,
image?:String)
|
Crea un nuevo objeto de icono. Si se especifica otro icono en el argumento opcional copy, sus propiedades se copiarán; de lo contrario, se quedarán vacías. El argumento opcional image establece el valor de la propiedad image. |
| Constante | Descripción |
|---|---|
G_DEFAULT_ICON
|
El icono predeterminado utilizado por los marcadores |
| Propiedad | Tipo | Descripción |
|---|---|---|
image
|
String |
La URL de la imagen de fondo del icono |
shadow
|
String |
La URL de la imagen de sombra del icono |
iconSize
|
GSize |
El tamaño en píxeles de la imagen de fondo del icono |
shadowSize
|
GSize |
El tamaño en píxeles de la imagen de sombra |
iconAnchor
|
GPoint |
Son las coordenadas en píxeles relativas a la esquina superior izquierda de la imagen del icono en la que este queda anclado al mapa. |
infoWindowAnchor
|
GPoint |
Son las coordenadas de píxeles relativas a la esquina superior izquierda de la imagen del icono en la que la ventana de información queda anclada a este icono. |
printImage
|
String |
Es la URL de una imagen de icono en primer plano alternativa que se utiliza para imprimir en los navegadores que no pueden administrar la imagen GIcon.image predeterminada. Las versiones de Internet Explorer requieren normalmente una imagen alternativa en estos casos, ya que no pueden imprimir los iconos como imágenes PNG transparentes. Ten en cuenta que los navegadores que pueden imprimir la imagen image predeterminada ignorarán esta propiedad. |
mozPrintImage
|
String |
Es la URL de una imagen de icono no transparente alternativa que se utiliza para imprimir en los navegadores que no son capaces de administrar las imágenes PNG transparentes (proporcionadas en la imagen GIcon.image predeterminada) o las imágenes GIF transparentes (proporcionadas en GIcon.printImage). Las versiones anteriores de Firefox/Mozilla suelen requerir imágenes que no sean transparentes al imprimir. Ten en cuenta que los navegadores que pueden imprimir la imagen image predeterminada ignorarán esta propiedad. |
printShadow
|
String |
La URL de la imagen de sombra utilizada para los mapas impresos Esta 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 prácticamente transparente de la imagen en primer plano del icono utilizada para capturar eventos de clic en Internet Explorer. Esta imagen debe ser una versión en formato PNG de 24 bits de la imagen principal del icono con un 1% de opacidad, pero con la misma forma y el mismo tamaño que el icono principal. |
imageMap
|
Number[] |
Conjunto de números enteros que representan las coordenadas x/y del mapa de imagen que debemos utilizar para especificar la parte de la imagen del icono en la que se puede hacer clic en navegadores diferentes a Internet Explorer. |
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 a iconAnchor) de la imagen de cruz que aparece cuando se arrastra un icono. (A partir de la versión 2.79) |
Esta clase crea una instancia de una superposición de "capa" predefinida que consiste en una recopilación de elementos relacionados. Implementa la interfaz GOverlay y, por tanto, se puede añadir al mapa con el método GMap2.addOverlay().
| Constructor | Descripción |
|---|---|
GLayer(layerId:String)
|
Crea una capa con el ID de capa única especificada. http://spreadsheets.google.com/pub?key=p9pdwsai2hDN-cAocTLhnag contiene una lista de las capas admitidas actualmente. |
| Método | Valor de retorno | Descripción |
|---|---|---|
hide()
|
None |
Oculta esta superposición para que no sea visible, pero mantiene su posición en la pila de superposiciones. |
show()
|
None |
Muestra una capa GLayer anteriormente oculta. |
| Método | Valor de retorno | Descripción |
|---|---|---|
GLayer.isHidden(layerId:String)
|
None |
Devuelve true únicamente si la superposición de capa está oculta o no se añadió al mapa con el método GMap2.addOverlay(). |
Los objetos GMarker marcan una posición en el mapa. Implementa la interfaz GOverlay y, por tanto, se puede añadir al mapa con el método GMap2.addOverlay().
Los objetos de marcador tiene un elemento latlng, que representa la posición geográfica donde el marcador está anclado al mapa, y un elemento icon. Si el elemento icon no se establece en el constructor, se utilizará el icono G_DEFAULT_ICON predeterminado.
Una vez añadido a un mapa, la ventana de información de ese mapa se puede abrir mediante el marcador. El objeto de marcador activa 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 valor transferido de latlng de GPoint o GLatLng con icon o G_DEFAULT_ICON. Si la etiqueta inert es true, el marcador no activará ningún evento y no se podrá hacer clic en él.(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, los marcadores tienen el icono predeterminado G_DEFAULT_ICON y se puede hacer clic en ellos.(A partir de la versión 2.50) |
Para poder invocar estos métodos, se debe haber añadido el marcador a un mapa.
| Método | Valor de retorno | Descripción |
|---|---|---|
openInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información del mapa sobre el icono del marcador. El contenido de la ventana de información se ofrece como un nodo DOM. Solo es aplicable la opción GInfoWindowOptions.maxWidth. |
openInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información del mapa sobre el icono del marcador. El contenido de la ventana de información se ofrece como una cadena de texto HTML. Solo es aplicable la opción GInfoWindowOptions.maxWidth. |
openInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información del mapa con pestañas sobre el icono del marcador. El contenido de la ventana de información se ofrece en como un conjunto pestañas cuyo contenido está formado por nodos DOM. Solo son aplicables las opciones GInfoWindowOptions.maxWidth y InfoWindowOptions.selectedTab. |
openInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información del mapa con pestañas sobre el icono del marcador. El contenido de la ventana de información se ofrece en como un conjunto pestañas cuyo contenido está formado por cadenas de texto HTML. Solo son aplicables las opciones InfoWindowOptions.maxWidth y InfoWindowOptions.selectedTab. |
bindInfoWindow(content:Node,
opts?:GInfoWindowOptions)
|
None |
Vincula el nodo DOM especificado a este marcador. El contenido de este nodo se mostrará automáticamente en la ventana de información al hacer clic en el marcador. Transmite content como null para cancelar la vinculación.(A partir de la versión 2.85) |
bindInfoWindowHtml(content:String,
opts?:GInfoWindowOptions)
|
None |
Vincula el texto HTML especificado a este marcador. El contenido HTML se mostrará automáticamente en la ventana de información al hacer clic en el marcador. Transmite content como null para cancelar la vinculación.(A partir de la versión 2.85) |
bindInfoWindowTabs(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Vincula los valores de GInfoWindowTab (proporcionados como nodos DOM) a este marcador. El contenido de los nodos de estas pestañas se mostrará automáticamente en la ventana de información al hacer clic en el marcador. Transmite tabs como null para cancelar la vinculación.(A partir de la versión 2.85) |
bindInfoWindowTabsHtml(tabs:GInfoWindowTab[],
opts?:GInfoWindowOptions)
|
None |
Vincula los valores de GInfoWindowTab (proporcionados como cadenas HTML) a este marcador. El contenido HTML de estas pestañas se mostrará automáticamente en la ventana de información al hacer clic en el marcador. Transmite tabs como null para cancelar la vinculación.(A partir de la versión 2.85) |
closeInfoWindow()
|
None |
Cierra la ventana de información solo si pertenece a este marcador. (A partir de la versión 2.85) |
showMapBlowup(opts?:GInfoWindowOptions)
|
None |
Abre la ventana de información del mapa sobre el icono del marcador. El contenido de la ventana de información es un primer plano alrededor de la posición del marcador en el mapa. Solo son aplicables las opciones InfoWindowOptions.zoomLevel y InfoWindowOptions.mapType. |
getIcon()
|
GIcon |
Devuelve el icono icon de este marcador, tal y como lo haya definido el constructor. |
getTitle()
|
String |
Devuelve el título de este marcador, según haya establecido el constructor a través de la propiedad GMarkerOptions.title. Devuelve un valor "indefinido" si no se transmite ningún título.(A partir de la versión 2.85) |
getLatLng()
|
GLatLng |
Devuelve las coordenadas geográficas del punto en el que se ancla este marcador, tal y como las haya definido el constructor o setLatLng().(A partir de la versión 2.88) |
setLatLng(latlng:GLatLng)
|
None |
Establece las coordenadas geográficas del punto en el que se ancla este marcador. (A partir de la versión 2.88) |
enableDragging()
|
None |
Habilita el marcador para que se pueda arrastrar y soltar en cualquier punto del mapa. Para que funcione, el marcador se debe haber inicializado con GMarkerOptions.draggable = true. |
disableDragging()
|
None |
Inhabilita el marcador para que no se pueda arrastrar y soltar en cualquier punto del mapa. |
draggable()
|
Boolean |
Devuelve true únicamente si el marcador se ha inicializado a través del constructor con GMarkerOptions.draggable = true. |
draggingEnabled()
|
Boolean |
Devuelve true únicamente si el marcador se ha habilitado para que se pueda arrastrarse por el mapa.
|
setImage(url:String)
|
None |
Solicita que la imagen especificada por la url se establezca como la imagen en primer plano de este marcador. Nota: este método solo tendrá efecto sobre un marcador si este se muestra actualmente en el mapa; además, si se ejecuta este método y se elimina el marcador del mapa, se restablecerá el marcador para que utilice la imagen original. Por esta razón, 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. Ni la imagen de impresión ni la imagen de sombra se ajustarán.
(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 únicamente si el marcador está oculto en ese momento.(A partir de la versión 2.77) |
Todos estos eventos se activan únicamente si el marcador no está inerte (consulta el constructor).
| Evento | Descripción |
|---|---|
click(latlng:GLatLng)
|
Este evento se activa al hacer clic en el icono del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. Ten en cuenta que este evento también activa el mapa, transmitiendo el marcador como primer argumento a su controlador de eventos. |
dblclick(latlng:GLatLng)
|
Este evento se activa al hacer doble clic en el icono del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. Ten en cuenta que este evento no se activará para el mapa, ya que el mapa se centra al hacer doble clic como control cableado. |
mousedown(latlng:GLatLng)
|
Este evento se activa cuando se activa el evento mousedown DOM en el icono del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. Ten en cuenta que el marcador detendrá el evento mousedown DOM para que el mapa no comience a arrastrarse. |
mouseup(latlng:GLatLng)
|
Este evento se activa para el evento mouseupen el marcador, transfiriendo la coordenada actual del marcador en el 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 ratón entra en el área del icono del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. |
mouseout(latlng:GLatLng)
|
Este evento se activa cuando el ratón sale del área del icono del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. |
infowindowopen()
|
Este evento se activa cuando se abre la ventana de información del mapa a través de este marcador. |
infowindowbeforeclose()
|
Este evento se activa antes de que se cierre la ventana de información del mapa que se abrió a través de este 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 de este marcador. Esto ocurre cuando la ventana de información se cierra o cuando se abre en otro marcador o sobre el mapa. El evento infowindowbeforeclose se activa antes de este evento. |
remove()
|
Este evento se activa cuando el marcador se elimina del mapa con GMap2.removeOverlay() o GMap2.clearOverlays(). |
dragstart(latlng:GLatLng)
|
Si el marcador está habilitado para poder arrastrar, este evento se activará cuando comience el arrastre del marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. |
drag(latlng:GLatLng)
|
Si el marcador está habilitado para poder arrastrar, este evento se activará mientras se arrastra el marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. |
dragend(latlng:GLatLng)
|
Si el marcador está habilitado para poder arrastrar, este evento se activará se deje de arrastrar el marcador, transfiriendo la coordenada actual del marcador en el argumento latlng. |
visibilitychanged(isVisible:Boolean)
|
Este evento se activa cuando se cambia la visibilidad del marcador (es decir, cuando se cambia de visible a oculto o viceversa). isVisible hace referencia al estado del marcador después de haber cambiado su visibilidad.
(A partir de la versión 2.77) |
Las instancias de esta clase se utilizan en el argumento opts? para el constructor de la clase GMarker. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
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, se utilizará G_DEFAULT_ICON.(A partir de la versión 2.50) |
dragCrossMove
|
Boolean |
Cuando se arrastran marcadores normalmente, el marcador flota y se aleja del cursor. En cambio, si se establece este valor en true, el marcador permanecerá debajo del cursor y la cruz se moverá hacia abajo. El valor predeterminado de esta opción es false.(A partir de la versión 2.63) |
title
|
String |
Esta cadena aparecerá como información sobre la 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 inhabilita alternativamente la posibilidad de hacer clic en el marcador. Los marcadores en los que no se puede hacer clic o los 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 inhabilita alternativamente la posibilidad de que los usuarios puedan arrastrar el marcador. Los marcadores que se pueden arrastrar necesitan más recursos que los marcadores en los que se puede hacer clic. De forma predeterminada, los marcadores que se pueden arrastrar son animados, tienen habilitado el desplazamiento automático y en ellos se puede hacer clic. El valor predeterminado de esta opción es false.(A partir de la versión 2.61) |
bouncy
|
Boolean |
Habilita o inhabilita alternativamente si el marcador debe rebotar hacia arriba y hacia abajo cuando termine de arrastrarse. El valor predeterminado de esta opción es false.(A partir de la versión 2.61) |
bounceGravity
|
Number |
Al finalizar el arrastre, este número se utilizará para definir el índice de aceleración del marcador durante el descenso a la Tierra. El valor predeterminado de esta opción es 1.(A partir de la versión 2.61) |
autoPan
|
Boolean |
Desplaza el mapa automáticamente al arrastrar el marcador cerca el extremo. Si el marcador se puede arrastrar, el valor predeterminado para esta opción será 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 están superpuestos sobre el mapa y también se ejecuta cuando su ventana de información está abierta. De forma predeterminada, los marcadores situados más al sur se colocarán en una posición más alta que los marcadores situados más al norte. Esta función se incluye 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 |
Cuando el valor es true, indica que el mapa no debe mostrar inicialmente GMarker. Para activar la superposición, ejecuta GMarker.show(). De forma predeterminada, este valor se establece en false.
(A partir de la versión 2.139) |
Todos los tipos de mapa 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 zoom que se indiquen. |
| Método | Valor de retorno | 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)
|
Boolean |
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 el ancho del mapa de la Tierra completa en píxeles en el nivel de zoom en cuestión.(A partir de la versión 2.46) |
G_AERIAL_MAP y G_AERIAL_HYBRID_MAP utilizan esta versión de GMercatorProjection. Un GObliqueMercator es un GMercatorProjection escorzado en el eje y según un factor de la raíz cuadrada de 2.
| Constructor | Descripción |
|---|---|
GObliqueMercator(zoomlevels:Number,
heading:Number)
|
Crea una proyección de Mercato oblicua según el encabezado y el número de niveles de zoom especificados. (A partir de la versión 2.193) |
| Método | Valor de retorno | Descripción |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Devuelve coordenadas oblicuas del mapa en píxeles correspondientes al punto en las coordenadas geográficas y el nivel de zoom especificados. Consulta GMercatorProjection.(A partir de la versión 2.193) |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Devuelve las coordenadas geográficas correspondientes al punto en las coordenadas oblicuas del mapa en píxeles y en el nivel de zoom especificados. La etiqueta unbounded hace que la coordenada de longitud geográfica no gire más allá de los meridianos de -180 o 180 grados. Consulta GMercatorProjection.(A partir de la versión 2.193) |
tileCheckRange(tile:GPoint,
zoom:Number,
tilesize:Number)
|
Boolean |
Devuelve un valor booleano indicando si el índice de mosaicos está en un intervalo válido para ese tipo de mapa. Consulta GMercatorProjection.(A partir de la versión 2.193) |
getWrapWidth(zoom:Number)
|
None |
Devuelve 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 repite a sí mismo. Consulta GMercatorProjection.(A partir de la versión 2.193) |
Las clases GMarker, GPolyline, GTileLayerOverlay y GInfoWindow implementan esta interfaz en la biblioteca del API de mapas. Puedes implementar esta interfaz 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(). A continuación, el mapa ejecutará el método GOverlay.initialize() en la instancia de superposición para mostrarse a sí mismo en el mapa inicialmente. Cuando cambie el aspecto del mapa, este ejecutará GOverlay.redraw() para que la superposición se pueda volver a colocar si es necesario. La instancia de superposición puede utilizar el método GMap2.getPane() para establecer comunicación con uno o varios elementos contenedores DOM para asociarse a ellos.
| Constructor | Descripción |
|---|---|
GOverlay()
|
Este constructor crea implementaciones simuladas para los métodos. Aún así, al heredar contenido de esta clase, el constructor de clase derivado deberá ejecutar este constructor para que el resultado sea completo. |
| Método | Valor de retorno | Descripción |
|---|---|---|
GOverlay.getZIndex(latitude:Number)
|
Number |
Devuelve un valor z-index CSS para una latitud determinada. Calcula un índice z de forma que las superposiciones situadas más al sur se colocan sobre las superposiciones situadas más al norte, creando así la apariencia de 3D de las superposiciones de marcadores. |
| Método | Valor de retorno | Descripción |
|---|---|---|
initialize(map:GMap2)
|
None |
El mapa ejecuta este método después de añadir la superposición al mapa con GMap2.addOverlay(). El objeto de la superposición puede arrastrarse a sí mismo a diferentes paneles del mapa que se pueden obtener con GMap2.getPane(). |
remove()
|
None |
El mapa ejecuta este método después de eliminar añadir la superposición del mapa con GMap2.removeOverlay() o GMap2.clearOverlays(). La superposición debe eliminarse a sí misma de los paneles del mapa aquí. |
copy()
|
GOverlay |
Devuelve una copia no inicializada de sí mismo que se puede añadir al mapa. |
redraw(force:Boolean)
|
None |
El mapa ejecuta este método cuando la visualización del mapa ha cambiado. El argumento force será true si cambia el nivel de zoom o el desplazamiento de píxeles de la vista del mapa, de modo que haya que volver a calcular las coordenadas de píxeles. |
getKml(callback:Function)
|
None |
Este método se utiliza para obtener la representación KML de la superposición de forma asíncrona. La función de devolución de llamada se ejecuta con un argumento de cadena único, que es una cadena KML parcial que representa la superposición o un valor nulo si la representación KML no está disponible. La cadena KML no incluirá la declaración XML ni el elemento raíz <kml>.(A partir de la versión 2.167) |
| Evento | Descripción |
|---|
Las instancias de esta clase se utilizan en los métodos enableEditing de GPolyline y GPolygon. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
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 permitido para esta polilínea. Una vez que se alcance este número, no se podrán añadir más vértices. (A partir de la versión 2.111) |
fromStart
|
Boolean |
Esta propiedad especifica si enableDrawing debe añadir puntos desde el principio en vez de desde el final, que es la configuración predeterminada. (A partir de la versión 2.111) |
Las instancias de esta clase se utilizan en el método setStrokeStyle de GPolyline y GPolygon y en el método setFillStyle de GPolygon. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
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 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) |
Esta clase es muy parecida a GPolyline, excepto en que además se puede especificar 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 un conjunto de vértices. Los valores de colors se especifican con una cadena que contiene el color en estilo HTML numérico hexadecimal, como #RRGGBB. weight indica el ancho de la línea expresado en píxeles. opacities indica la opacidad con un valor entre 0 y 1. La línea será semitransparente y se le aplicarán filtros antialiasing.(A partir de la versión 2.69) |
| Método | Valor de retorno | Descripción |
|---|---|---|
GPolygon.fromEncoded(polylines:encoded polylines[],
fill?:Boolean,
color?:String,
opacity?:Number,
outline?:Boolean)
|
GPolygon |
Crea un polígono (que consiste en varias polilíneas) a partir de cadenas codificadas de niveles y coordenadas recopilados. polylines contiene un conjunto asociativo de polilíneas constitutivas, codificadas con el mismo formato descrito en la GPolyline.fromEncoded documentación. fill especifica si rellenar el polígono con un color determinado. opacity y outline especifican si trazar el polígono con el color, el peso y la opacidad de la polilínea. Si se especifican varios valores en las polilíneas, se usarán los valores de la primera polilínea.
(A partir de la versión 2.78) |
| Método | Valor de retorno | Descripción |
|---|---|---|
deleteVertex(index:Number)
|
None |
Elimina el vértice con el índice especificado del polígono y actualiza la forma del polígono en consecuencia. GPolygon se debe haber añadido previamente 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 al usuario construir un objeto GPolygon al hacer clic en puntos adicionales del mapa. Previamente, se debe haber añadido GPolygon al mapa a través de GMap2.addOverlay(), aunque el polígono esté inicialmente vacío y no contenga vértices. Cada clic añade un vértice adicional al límite del polígono y se podrá finalizar el dibujo al hacer doble clic o un solo 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 el polígono no se eliminará del mapa.
(A partir de la versión 2.111) |
enableEditing(opts?:GPolyEditingOptions)
|
None |
Permite modificar un límite existente de GPolygon. Si se habilita, los usuarios podrán seleccionar y arrastrar los vértices existentes. GPolygon se debe haber añadido previamente al mapa mediante GMap2.addOverlay(). A menos que maxVertices especifique en GPolyEditingOptions un límite de vértices menor que el número de vértices actual, también se añadirán puntos "fantasma" en los puntos intermedios de las secciones del polígono, permitiendo así a los usuarios interpolar nuevos vértices haciendo clic y arrastrando 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 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 se debe haber añadido previamente al mapa mediante GMap2.addOverlay().
(A partir de la versión 2.111) |
isHidden()
|
Boolean |
Devuelve true únicamente si el polígono está oculto en ese momento.(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 únicamente si GPolygon.hide() es compatible con el entorno actual de los objetos GPolygon.(A partir de la versión 2.87) |
setFillStyle(style:GPolyStyleOptions)
|
None |
Cambia el estilo de relleno del polígono. GPolygon se debe haber añadido previamente 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 se debe haber añadido previamente al mapa mediante GMap2.addOverlay().
(A partir de la versión 2.111) |
| Evento | Descripción |
|---|---|
remove()
|
Este evento se activa cuando el polígono se elimina del mapa con 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 después de completar este estado de visibilidad.
(A partir de la versión 2.87) |
click(latlng:GLatLng)
|
Este evento se activa al hacer clic en el polígono, transfiriendo la coordenada del polígono en la que se ha hecho clic dentro del argumento latlng. Ten en cuenta que este evento también activa posteriormente un evento de "clic" en el mapa, donde el polígono se trasmite como el argumento overlay en ese evento.
(A partir de la versión 2.88>) |
mouseover()
|
Este evento se activa cuando el ratón entra en la región del polígono.
(A partir de la versión 2.111) |
mouseout()
|
Este evento se activa cuando el ratón sale 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) |
Las instancias de esta clase se utilizan en el constructor de GPolygon. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
Como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
clickable
|
Boolean |
Habilita o inhabilita 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) |
mouseOutTolerance
|
number |
Esta propiedad contiene la distancia (en píxeles) del cursor del ratón para desplazarse fuera del polígono antes de que se active el evento "mouseout".
(A partir de la versión 2.158) |
Es una superposición del mapa que dibuja una polilínea en el mapa con las funciones de dibujo de vectores del navegador (si están disponibles) o una superposición de imagen de los servidores de Google.
| Constructor | Descripción |
|---|---|
GPolyline(latlngs:GLatLng[],
color?:String,
weight?:Number,
opacity?:Number,
opts?:GPolylineOptions)
|
Crea una polilínea a partir de un conjunto de vértices. El valor de color se especifica con una cadena que contiene el color en estilo HTML numérico hexadecimal, como #RRGGBB. weight indica el ancho de la línea expresado en píxeles. opacity indica la opacidad con un valor entre 0 y 1. La línea será semitransparente y se le aplicarán filtros antialiasing. |
| Método | Valor de retorno | Descripción |
|---|---|---|
GPolyline.fromEncoded(color?:String,
weight?:Number,
opacity?:Number,
latlngs:String,
zoomFactor:Number,
levels:String,
numLevels:Number)
|
GPolyline |
Crea una polilínea a partir de cadenas codificadas de niveles y coordenadas recopilados. color es una cadena que contiene un estilo HTML numérico hexadecimal, como #RRGGBB. weight indica el ancho de la línea en píxeles. opacity indica 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 polilínea codificados. numLevels es el número de niveles de zoom contenidos en la cadena levels codificada. zoomFactor es el aumento entre conjuntos adyacentes de niveles de zoom en la cadena levels codificada. En conjunto, estos dos valores determinan la precisión de los niveles (levels) en una polilínea codificada. La línea será semitransparente y se le aplicarán filtros antialiasing.(A partir de la versión 2.63) |
| Método | Valor de retorno | Descripción |
|---|---|---|
deleteVertex(index:Number)
|
None |
Elimina el vértice con el índice especificado de la polilínea y actualiza la forma de la polilínea en consecuencia. GPolyline se debe haber añadido previamente 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 al usuario construir (o modificar) un objeto GPolyline al hacer clic en puntos adicionales del mapa. Previamente se debe haber añadido GPolyline al mapa a través de 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 modificar una cadena de puntos GPolyline existente. Si se habilita, los usuarios podrán seleccionar y arrastrar los vértices existentes. GPolyline se debe haber añadido previamente al mapa mediante GMap2.addOverlay(). A menos que maxVertices especifique en GPolyEditingOptions un límite de vértices menor que el número de vértices actual, también se añadirán puntos "fantasma" en los puntos intermedios de las secciones de la polilínea, permitiendo así a los usuarios interpolar nuevos vértices haciendo clic y arrastrando 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á visible en ese momento y 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 se debe haber añadido previamente al mapa mediante GMap2.addOverlay().
(A partir de la versión 2.111) |
isHidden()
|
Boolean |
Devuelve true únicamente si la polilínea está oculta en ese momento.(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 únicamente si GPolyline.hide() es compatible con el entorno actual de los objetos GPolyline.(A partir de la versión 2.87) |
setStrokeStyle(style:GPolyStyleOptions)
|
None |
Cambia el estilo de la polilínea. GPolyline se debe haber añadido previamente al mapa mediante GMap2.addOverlay().
(A partir de la versión 2.111) |
| Evento | Descripción |
|---|---|
remove()
|
Este evento se activa cuando la polilínea se elimina del mapa con 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 oculto o viceversa. El argumento isVisible refleja el estado de la polilínea después de completar este estado de visibilidad.
(A partir de la versión 2.87) |
click(latlng:GLatLng)
|
Este evento se activa al hacer clic en la polilínea, transfiriendo la coordenada de la línea en la que se ha hecho clic dentro del argumento latlng. Ten en cuenta que este evento también activa posteriormente un evento de "clic" en el mapa, donde la polilínea se trasmite como el argumento overlay en ese evento.
(A partir de la versión 2.88) |
mouseover()
|
Este evento se activa cuando el ratón se coloca sobre la polilínea.
(A partir de la versión 2.111) |
mouseout()
|
Este evento se activa cuando el ratón sale del área 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) |
Las instancias de esta clase se utilizan en el constructor de GPolyline. No hay ningún constructor para esta clase. En su lugar, se crea una instancia de esta clase como un objeto literal JavaScript.
Como indica el nombre de esta clase, todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
clickable
|
Boolean |
Habilita o inhabilita 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 ninguna opción, se podrá hacer clic en la polilínea.
(A partir de la versión 2.91) |
geodesic
|
Boolean |
Procesa cada extremo como una polilínea geodésica (un segmento de un "gran círculo"). Una polilínea geodésica es la ruta más corta entre dos puntos situados sobre la superficie de la Tierra.
(A partir de la versión 2.84) |
mouseOutTolerance
|
number |
Esta propiedad contiene la distancia (en píxeles) del cursor del ratón para desplazarse en diagonal a la polilínea antes de que se active el evento "mouseout".
(A partir de la versión 2.158) |
Esta es la interfaz de proyecciones de mapa. Se transmite 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 ejecuta estos métodos. Debes implementarlos.
| Método | Valor de retorno | Descripción |
|---|---|---|
fromLatLngToPixel(latlng:GLatLng,
zoom:Number)
|
GPoint |
Devuelve las coordenadas de mapa en píxeles del punto en las coordenadas geográficas y en el nivel de zoom en cuestión. |
fromPixelToLatLng(pixel:GPoint,
zoom:Number,
unbounded?:Boolean)
|
GLatLng |
Devuelve las coordenadas geográficas del punto en las coordenadas del mapa en píxeles y en el nivel de zoom en cuestión. La etiqueta unbounded hace que la coordenada de longitud geográfica no gire más allá de los meridianos 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. En caso contrario, el mapa mostrará un mosaico vacío. También puede modificar el índice tile para señalar otra instancia del mismo mosaico en caso de que el mapa contenga más de una copia de la Tierra y, por ello, el mismo mosaico en distintas coordenadas de mosaico. |
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 repite 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 solo sucede en los niveles de zoom inferiores).(A partir de la versión 2.46) |
El objeto muestra una superposición de imagen rectangular en el mapa cuya posición permanece fija aunque cambie la ventana gráfica. ScreenOverlays se puede utilizar, por ejemplo, para brújulas, logotipos y anuncios previos.
| Constructor | Descripción |
|---|---|
GScreenOverlay(imageUrl:String,
screenXY:GScreenPoint,
overlayXY:GScreenPoint,
size:GScreenSize)
|
Crea una superposición de pantalla a partir de una URL de imagen y la muestra en la pantalla según especifiquen los parámetros screenXY, overlayXY y size. El parámetro overlayXY determina el punto dentro de la imagen de superposición (o fuera de ella) que se incluye en el mapa en la coordenada screenXY. Esto se puede utilizar para "cortar" la imagen de una forma eficaz. El parámetro screenXY determina el punto relativo al origen de la pantalla (esquina inferior izquierda) en el que se incluye la imagen de superposición.(A partir de la versión 2.92) |
| Método | Valor de retorno | 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 pantalla está visible en ese momento.(A partir de la versión 2.92) |
isHidden()
|
Boolean |
Devuelve true únicamente si la superposición de pantalla está oculta en ese momento.(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 oculto o viceversa. El argumento isVisible refleja el estado de la superposición de pantalla después de completar este estado de visibilidad.
(A partir de la versión 2.92) |
GScreenPoint identifica un punto en la ventana gráfica del mapa mediante coordenadas X e Y, cada una de las cuales puede representar una posición fraccional o absoluta, dependiendo de los valores 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 transmiten en fracción o en píxeles a los parámetros xunits e yunits. El valor predeterminado de estos parámetros es "pixels."
(A partir de la versión 2.92) |
| Propiedad | Tipo | Descripción |
|---|---|---|
x
|
Number |
Coordenada x, aumenta hacia la izquierda |
y
|
Number |
Coordenada y, aumenta hacia abajo |
xunits
|
String |
Especifica el tipo de unidades que se deben utilizar para la coordenada x. Establece esta propiedad en "fraction" para indicar una posición fraccional en relación al tamaño del mapa, o en "pixels" para indicar una posición absoluta. Establece esta propiedad en de forma predeterminada una posición absoluta. |
yunits
|
String |
Especifica el tipo de unidades que se deben utilizar para la coordenada y. Establece esta propiedad en "fraction" para indicar una posición fraccional en relación al tamaño del mapa, o en "pixels" para indicar una posición absoluta. Establece de forma predeterminada una 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 estos parámetros pueden representar un tamaño fraccional o de 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 absoluto según se establezcan los valores "fraction" o "pixels" en los parámetros xunits e yunits. El valor predeterminado de los argumentos xunits y yunits es "pixels".
(A partir de la versión 2.92) |
| Propiedad | Tipo | Descripción |
|---|---|---|
width
|
Number |
El parámetro correspondiente al ancho del estado real de la pantalla. Ten en cuenta que este valor representa un valor de píxeles fraccional o absoluto, según el valor de la propiedad GScreen.yunits. |
height
|
Number |
El parámetro correspondiente a la altura del estado real de la pantalla. Ten en cuenta que este valor representa un valor de píxeles fraccional o absoluto, según el valor de la propiedad GScreen.yunits. |
xunits
|
String |
Especifica el tipo de unidades que se deben utilizar para la propiedad GScreenSize.width. Establece esta propiedad en "fraction" para indicar una posición fraccional en relación al tamaño del mapa, o en "pixels" para indicar una posición en píxeles. Establece de forma predeterminada una posición en píxeles. |
yunits
|
String |
Especifica el tipo de unidades que se deben utilizar para la propiedad GScreenSize.height. Establece esta propiedad en "fraction" para indicar una posición fraccional en relación al tamaño del mapa, o en "pixels" para indicar una posición en píxeles. Establece de forma predeterminada una posición en píxeles. |
Esta interfaz se implementa para proporcionar capas de mosaico de mapa personalizadas, ya sea a través de GMapType o de GTileLayerOverlay. Para implementar esta interfaz, es necesario utilizar una instancia de GTileLayer como prototipo, ya que implementa automáticamente la gestión de derechos de autor.
| Constructor | Descripción |
|---|---|
GTileLayer(copyrights:GCopyrightCollection,
minResolution:Number,
maxResolution:Number,
options?:GTileLayerOptions)
|
Los argumentos del constructor se pueden omitir si crean instancias como un prototipo. El constructor de una subclase debe ejecutar el constructor con call(). El parámetro opcional options especifica un conjunto de opciones GTileLayerOptions que se deben transmitir como un objeto literal. |
Estos métodos se ejecutan con el mapa y con el tipo de mapa al que se transmite esta capa de mosaico. Deberás implementar los métodos marcados como abstracto cuando implementes una capa de mosaico personalizada.
| Método | Valor de retorno | Descripción |
|---|---|---|
minResolution()
|
Number |
Devuelve al tipo de mapa el nivel de zoom más bajo de la capa de mosaico en cuestión. |
maxResolution()
|
Number |
Devuelve al tipo de mapa el nivel de zoom 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 de mapa con los índices de mosaico especificados por las propiedades x y y de GPoint en el nivel de zoom especificado. |
isPng()
|
Boolean |
Abstracto. Devuelve al mapa si el mosaico está en formato de imagen PNG y, por tanto, puede ser transparente. De lo contrario se asumirá que el formato es GIF. |
getOpacity()
|
Number |
Abstracto. Devuelve al mapa la opacidad con la que mostrar esta capa de mosaico. 1,0 es opaco y 0,0 es transparente. |
getCopyright(bounds:GLatLngBounds,
zoom:Number)
|
String |
Abstracto. Devuelve al mapa los mensajes de derechos de autor de esta capa de mosaico que son pertinentes para esa región del mapa en particular en el nivel de zoom especificado. Permite generar el mensaje de derechos de autor de GMapType a la que pertenece esta capa de mosaico.(A partir de la versión 2.89) |
| Evento | Descripción |
|---|---|
newcopyright(copyright:GCopyright)
|
Este evento se activa cuando se añade un nuevo mensaje de derechos de autor a la recopilación de derechos de autor de esta capa de mosaico. |
Esta clase representa argumentos opcionales de la interfaz GTileLayer. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
opacity
|
Number |
Establece la opacidad del mosaico entre 0,0 (invisible) y 1,0 (opaco). El valor predeterminado es 1.0. Ten en cuenta que Internet Explorer 6 no admite las imágenes PNG con ambas opacidades y transparencias alfa. Si estableces una opacidad en este caso, perderás la transparencia alfa de la imagen. |
isPng
|
Boolean |
Indica si los mosaicos están en formato PNG. |
tileUrlTemplate
|
String |
Especifica una plantilla para las URL de mosaico que se ampliarán por cada solicitud de mosaico para hacer referencia a un mosaico único basado en un sistema de coordenadas de mosaico existente. Colocar una plantilla en el constructor GTileLayer permite recuperar mosaicos dinámicamente con este sistema de coordenadas, parecido a la forma en que Google Maps recupera mosaicos.
Las plantillas deben tener la siguiente forma: http://host/tile?x={X}&y={Y}&z={Z}.png
donde X e Y hacen referencia a coordenadas de mosaicos latitudinales y longitudinales y donde Z hace referencia al nivel de zoom (por ejemplo, http://host/tile?x=3&y=27&z=5.png). |
draggingCursor
|
String |
El cursor que se mostrará mientras se arrastra el mapa. (A partir de la versión 2.59) |
GTileLayerOverlay aumenta el mapa con GTileLayer. Implementa la interfaz GOverlay y, por tanto, se puede añadir al mapa con el método GMap2.addOverlay(). GTileLayer se presenta en la parte superior de las imágenes del mapa existentes. Si en su lugar quieres que se sustituyan las imágenes, pon GTileLayer dentro de un GMapType personalizado.
| Constructor | Descripción |
|---|---|
GTileLayerOverlay(tileLayer:GTileLayer,
opts?:GTileLayerOverlayOptions)
|
Crea una clase GOverlay que define la superposición tileLayer.(A partir de la versión 2.61) |
| Método | Valor de retorno | Descripción |
|---|---|---|
hide()
|
None |
Oculta esta superposición para que no sea visible, pero mantiene su posición en la pila de superposiciones. (A partir de la versión 2.71) |
isHidden()
|
None |
Devuelve true únicamente si la superposición de capa de mosaico está oculta.(A partir de la versión 2.87) |
show()
|
None |
Muestra un GTileLayerOverlay anteriormente oculto.(A partir de la versión 2.71) |
refresh()
|
None |
Vuelve a cargar todos los mosaicos visibles conectados a este 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 esta superposición. (A partir de la versión 2.83) |
Esta clase representa argumentos opcionales del constructor GTileLayerOverlayOptions. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
zPriority
|
Number |
zPriority contiene un valor que determina el orden z relativo a esta clase TileLayerOverlay. Las capas de mosaico con una prioridad más alta se representarán sobre las capas de mosaico con una prioridad más baja.(A partir de la versión 2.110) |
Un objeto GAdsManager extrae AdSense para anuncios de Google Maps y los muestra en el mapa especificado. Los anuncios se muestran en función del estilo style seleccionado y se puede hacer clic en ellos para abrirlos de forma consistente con el estilo. GAdsManager selecciona los anuncios de AdSense en función de la ventana gráfica actual y el contenido textual que rodea a la página. Ten en cuenta que al añadir una clase GAdsManager al mapa, también deberás habilitarla específicamente 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 a los servidores de Google. El parámetro map identifica el mapa en el que este objeto GAdsManager debe mostrar anuncios. El parámetro publisherId especifica la cuenta de AdSense del desarrollador. El parámetro adsManagerOptions es un objeto GAdsManagerOptions literal.(A partir de la versión 2.85) |
| Método | Valor de retorno | Descripción |
|---|---|---|
enable()
|
None |
Habilita la recuperación de anuncios. Los anuncios no se recuperan 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 GAdsManager. No tiene constructor, pero se inicia como un objeto literal. Ten en cuenta que debes seleccionar el estilo de los anuncios en el objeto GAdManagerOptions durante la construcción para que los anuncios se muestren correctamente. El único estilo admitido actualmente es G_ADSMANAGER_STYLE_ADUNIT.
| Propiedad | Tipo | Descripción |
|---|---|---|
style
|
GAdsManagerStyle |
AdSense para el estilo de Google Maps que se va a mostrar para la ubicación de los mapas (A partir de la versión 2.158) |
maxAdsOnMap
|
Number |
El número máximo de anuncios que se deben mostrar en el mapa en cualquier momento. El valor predeterminado es 10, aunque en la práctica se recuperan menos anuncios. (A partir de la versión 2.85) |
channel
|
Number |
El número de canal de AdSense que se utiliza para extraer los anuncios. Los canales son una función opcional que los editores de AdSense pueden utilizar para realizar un seguimiento de varias fuentes. (A partir de la versión 2.85) |
minZoomLevel
|
Number |
El nivel de zoom mínimo en el que se pueden mostrar anuncios. El valor predeterminado es 6. (A partir de la versión 2.85) |
position
|
GControlPosition |
La posición del mapa en la que se muestran los anuncios cuando GAdsManagerOptions.style está establecido en G_ADSMANAGER_STYLE_ADUNIT. De forma predeterminada, los anuncios que muestran este estilo aparecen en la esquina inferior derecha del mapa.(A partir de la versión 2.158) |
Estas constantes indican el estilo de los anuncios que muestra GAdsManager. El estilo se selecciona en la propiedad GAdsManagerOptions.style. Ten en cuenta que debes seleccionar el estilo durante la construcción de tu objeto GAdsManager. El único estilo admitido actualmente es G_ADSMANAGER_STYLE_ADUNIT.
| Constante | Descripción |
|---|---|
G_ADSMANAGER_STYLE_ADUNIT
|
Especifica que GAdsManager debe mostrar anuncios de contenido en un marco del mapa.(A partir de la versión 2.163) |
G_ADSMANAGER_STYLE_ICON
|
Especifica que GAdsManager debe mostrar los anuncios como iconos individuales en el mapa.(Obsoleto desde la versión 2.189) |
Esta clase te permite comunicarte directamente con los servidores de Google para obtener los códigos geográficos de las direcciones especificadas por los usuarios. Además, los códigos geográficos mantienen su propia memoria caché de direcciones, lo que permite responder consultas repetidas sin necesidad de volver al servidor. Por lo general, no se recomienda utilizar las funciones GClientGeocoder en un bucle. Los desarrolladores que tienen varias direcciones para codificar de forma geográfica probablemente deberían utilizar en su lugar 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é opcional permite a uno especificar una memoria caché de cliente personalizada de direcciones conocidas. Si no se especifica ninguna, se utilizará GFactualGeocodeCache.
(A partir de la versión 2.55) |
| Método | Valor de retorno | Descripción |
|---|---|---|
getLatLng(address:String,
callback:function)
|
None |
Envía una solicitud a los servidores de Google para codificar de forma geográfica la dirección indicada. Si la dirección se localizó correctamente, la función de devolución de llamada especificada por el usuario se ejecutará con un punto GLatLng. De lo contrario, se le asignará un punto null a la función de devolución de llamada. En el caso de direcciones ambiguas, solo se transmite a la función de devolución de llamada el punto de mejor coincidencia.
(A partir de la versión 2.55) |
getLocations(address:String,
callback:function)
|
None |
Este método realiza una codificación geográfica que implica la conversión de una dirección interpretable por humanos a un par latitud/longitud. getLocations() envía una solicitud al servicio de asignación de identificadores geográficos de Google, en la que se pide que se analice la dirección (address) proporcionada y que se administre la respuesta en la devolución de llamada (callback) determinada.Como este método necesita enviar una llamada al servidor de Google, también debes utilizar un método callback para administrar la respuesta. Esta respuesta contendrá un código Status y, si se realiza correctamente, incluirá uno o varios objetos
Placemark. Ten en cuenta que, desde la versión 2.133, se ha mejorado este método para permitir que también se transmitan objetos GLatLng para realizar el proceso de codificación geográfica inversa, tal como se documenta en la siguiente entrada de la referencia.
(A partir de la versión 2.55) |
getLocations(latlng:GLatLng,
callback:function)
|
None |
Este método realiza el proceso de codificación geográfica inversa, que implica la conversión de un par latitud/longitud a direcciones interpretables por humanos. getLocations() envía una solicitud al servicio de asignación de identificadores geográficos de Google, en la cual se pide que se devuelva la dirección de la latitud y la longitud (latlng) proporcionada y que se transmita la respuesta en la devolución de llamada (callback) determinada.Como este método necesita enviar una llamada al servidor de Google, también debes utilizar un método callback para administrar la respuesta. Esta respuesta contendrá un código Status y, si se realiza correctamente, incluirá uno o varios objetos
Placemark.Ten en cuenta que este método puede transmitir en su lugar una cadena ( String) que se puede convertir en dirección, como se ha indicado anteriormente. En ese caso, el servicio realizará una codificación geográfica estándar. Sin embargo, si el primer argumento contiene una clase GLatLng, el servicio realizará una codificación geográfica inversa.(A partir de la versión 2.133) |
getCache()
|
GGeocodeCache |
Devuelve la memoria caché de códigos geográficos utilizada actualmente o null, si no se realiza ningún almacenamiento en caché de cliente.
(A partir de la versión 2.55) |
setCache(cache:GGeocodeCache)
|
None |
Establece un nuevo almacenamiento en caché de cliente. Si se invoca este método con la memoria caché establecida en null, se inhabilitará el almacenamiento en memoria caché del cliente. Si se establece una nueva memora caché, se descartarán las direcciones almacenadas anteriormente.
(A partir de la versión 2.55) |
setViewport(bounds:GLatLngBounds)
|
None |
Establece el geocoder para ampliar los resultados de codificación geográfica dentro o cerca de la ventana gráfica especificada. La ventana gráfica se expresa como un rectángulo GLatLngBounds. Ten en cuenta que establecer una ventana gráfica no restringe los resultados de ese cuadro delimitador, aunque aumente su prioridad.
(A partir de la versión 2.82) |
getViewport()
|
GLatLngBounds |
Devuelve la ventana gráfica para ampliar los resultados de codificación geográfica dentro de ese geocoder. La ventana gráfica se expresa como un rectángulo GLatLngBounds.
(A partir de la versión 2.82) |
setBaseCountryCode(countryCode:String)
|
None |
Configura el geocoder para que influya en los resultados de búsqueda como si estos se enviasen desde el dominio especificado en el dominio de nivel superior geográfico (ccTLD) determinado. La codificación geográfica solo funciona para países en los que Google Maps admite códigos geográficos. La mayoría de los códigos de dominio de nivel superior son idénticos a los códigos ISO 3166-1, con algunas excepciones importantes. Por ejemplo, el código ccTLD para Gran Bretaña es "uk" ( Ten en cuenta que el dominio predeterminado es el dominio desde que el cargaste inicialmente el API de Google Maps. Los códigos de países no distinguen entre mayúsculas y minúsculas. (A partir de la versión 2.82) |
getBaseCountryCode()
|
String |
Devuelve el código de país actual que utiliza el geocoder especificado. (Si no hay ningún código de país en efecto, este método devuelve null).
(A partir de la versión 2.82) |
reset()
|
None |
Restablece el geocoder. En particular, este método ejecuta el método GGeocodeCache.reset() en la caché de cliente si este geocoder utiliza uno.
(A partir de la versión 2.55) |
Esta clase se utiliza para obtener indicaciones para llegar en coche y mostrarlas en un mapa o en un panel de texto.
| Constructor | Descripción |
|---|---|
GDirections(map?:GMap2,
panel?:Element)
|
Crea una nueva instancia de un objeto Directions para solicitar y almacenar resultados de ruta. A continuación, este objeto Directions puede crear la ruta a partir de una consulta determinada mediante 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 del panel (para mostrar los resultados de la ruta en texto), o ambas cosas. Si se transmite un argumento map, siempre que se calculen resultados de rutas nuevas, la polilínea y los marcadores asociados al resultado se añadirá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 y sustituyen 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 más abajo).
(A partir de la versión 2.81) |
| Método | Valor de retorno | Descripción |
|---|---|---|
load(query:String,
queryOpts?:GDirectionsOptions)
|
None |
Este método emite una nueva consulta de ruta. El parámetro query es una cadena que contiene cualquier consulta de ruta válida, como "desde: Madrid hasta: Barcelona" o "desde: Sevilla hasta: Bilbao hasta: Valencia". De forma predeterminada, si se especifica un mapa durante la construcción del objeto GDirections, la consulta solicitará un resultado de polilínea. De forma similar, si se especificó un panel de texto, la consulta solicitará resultados textuales detallados. De lo contrario, el resultado solo contendrá información de resumen sobre las rutas encontradas.Para sustituir este funcionamiento (por ejemplo, para solicitar información de la polilínea aunque no haya ningún mapa vinculado al objeto), se puede utilizar el parámetro opcional queryOpts. Para obtener información detallada, consulta la documentación de GDirectionsOptions.
Si se reciben resultados de ruta, este objeto borrará los resultados anteriores y los sustituirá por los nuevos, actualizando el mapa y el panel con los nuevos resultados. Los resultados incluyen varias rutas (objetos de tipo
Si una solicitud (A partir de la versión 2.81) |
loadFromWaypoints(waypoints:Array,
queryOpts?:GDirectionsOptions)
|
None |
Emite una nueva consulta de ruta mediante un conjunto de hitos como datos en lugar de una sola cadena de consulta. Ese conjunto puede contener un máximo de 25 entradas de hitos. Cada entrada del conjunto es una cadena que representa una dirección de entrada o un punto de latitud/longitud. Para obtener información detallada sobre el comportamiento de este método, consulta GDirections.load().
(A partir de la versión 2.81) |
clear()
|
None |
Borra todos los resultados de rutas existentes, elimina las superposiciones del mapa y del 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 siguiente forma: { código: 200 solicitud: "ruta" } El código de estado puede presentar cualquiera de los valores definidos en GGeoStatusCode.
(A partir de la versión 2.81) |
getBounds()
|
GLatLngBounds |
Este método permite obtener el cuadro delimitador del resultado de esta consulta de ruta. Devuelve un objeto GLatLngBounds o el valor null si no se obtiene ningún resultado correcto.
(A partir de la versión 2.81) |
getNumRoutes()
|
Number |
Devuelve el número de rutas disponibles en el resultado. Para que la consulta devuelva 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 devolvió resultados), este método devuelve 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 identificador geográfico disponibles en el resultado. Para que la consulta devuelva 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 devolvió resultados), este método devuelve 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 de este resultado.
(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 totalidad de esta solicitud de ruta Ten en cuenta que este resumen es la única información devuelta a un objeto GDirections construido sin un elemento DIV o un mapa 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. El objeto contiene dos campos: un número denominado "meters", que indica el valor numérico de la distancia (en metros), y una cadena denominada "html", que contiene una representación de cadena localizada de la distancia utilizando las unidades predominantes en el país de origen de este conjunto de indicaciones.
(A partir de la versión 2.81) |
getDuration()
|
Object |
Devuelve un objeto literal que representa el tiempo total de la solicitud de ruta. El objeto contiene dos campos: un número denominado "seconds", que indica el valor numérico del tiempo (en segundos), y una cadena denominada "html", que contiene una representación de cadena localizada del tiempo.
(A partir de la versión 2.81) |
getPolyline()
|
GPolyline |
Devuelve el objeto GPolyline asociado a toda la respuesta de indicaciones. Ten en cuenta que habrá una única polilínea que representará todas las rutas de la respuesta. Este objeto solo se definirá después de que se hayan 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 al enésimo código geográfico. Este método devolverá un valor no nulo solo después de que se hayan cargado todos los resultados de ruta (es decir, cuando se haya activado el evento "load").
(A partir de la versión 2.81) |
| Evento | Descripción |
|---|---|
load()
|
Este evento se activa cuando los resultados de una consulta de ruta emitidos a través de GDirections.load() están disponibles. Ten en cuenta que el método load() inicia una nueva consulta que, a su vez, activa un evento "load" una vez que la consulta ha terminado de cargarse. El evento "load" se activa antes de que cualquier elemento de superposición se añada al mapa/panel.
(A partir de la versión 2.81) |
addoverlay()
|
Este evento se activa después de que los componentes de las polilíneas o de las rutas textuales se añadan al mapa o a los elementos DIV. Ten en cuenta que el evento "addoverlay" no se activa si ninguno de estos elementos está unido a un objeto GDirections. Este evento se activa después de que los componentes de las polilíneas o de las rutas textuales se añadan al mapa o a los elementos DIV.
(A partir de la versión 2.81) |
error()
|
Este evento se activa si una solicitud de ruta genera un error. Se puede emplear GDirections.getStatus() al realizar llamadas para obtener más información sobre el error. Cuando se produce un evento "error", no se activará ningún evento "load" o "addoverlay".
(A partir de la versión 2.81) |
Esta clase representa argumentos opcionales de los métodos GDirections.load() y GDirections.loadFromWaypoints(). No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
locale
|
String |
La configuración regional que se debe utilizar para el resultado de ruta. Por ejemplo, "en_US", "fr", "fr_CA", etc. |
travelMode
|
GTravelModes |
La forma de desplazamiento, por ejemplo, en automóvil (predeterminado) o a pie. Ten en cuenta que si indicas rutas a pie, debes especificar un panel <div> en el que debes insertar un aviso de advertencia para los usuarios.(A partir de la versión 2.129) |
avoidHighways
|
Boolean |
Si el valor es true, se intentarán evitar las autopistas al crear la ruta. Ten en cuenta que la ruta puede 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*() solo recuperan datos de polilínea si hay un mapa adjunto al objeto GDirections. Este campo se puede utilizar para anular este comportamiento y recuperar datos de polilíneas aunque no esté asociado un mapa al objeto Directions. |
getSteps
|
Boolean |
De forma predeterminada, los métodos GDirections.load*() solo recuperan datos de pasos si hay un panel adjunto al objeto GDirections. Este campo se puede utilizar para anular este comportamiento y recuperar datos de pasos aunque no esté asociado un panel al objeto Directions. |
preserveViewport
|
Boolean |
De forma predeterminada, cuando un objeto Directions tiene un mapa, este se centra y se acerca o aleja para ajustarse al cuadro delimitador de ruta. Cuando esta opción se establece en true, la ventana gráfica se deja sola para esta solicitud (a menos que no se haya establecido antes). |
Esta función ofrece una forma cómoda de recuperar asíncronamente un recurso identificado por una URL. Ten en cuenta que como el objeto XmlHttpRequest se utiliza para ejecutar la solicitud, está sujeto a la restricción de mismo origen de secuencias de comandos multisitio, es decir, que la URL debe hacer referencia al mismo servidor que la URL del documento actual que ejecuta este código. Así pues, a menudo resulta innecesario utilizar una URL absoluta para el argumento url, y es mejor utilizar solo una ruta absoluta o relativa. El autor de la llamada será el responsable de gestionar cualquier excepción que se produzca, como los errores de seguridad.
| Método | Valor de retorno | Descripción |
|---|---|---|
GDownloadUrl(url:String,
onload:Function,
postBody?:String,
postContentType?:String)
|
None |
Recupera el recurso de la URL especificada y ejecuta la función onload con el texto del documento como el primer argumento y el código de estado de la respuesta HTTP como el segundo. Si la solicitud sobrepasa el tiempo límite, es posible ejecutar la función "onload" en su lugar con "null" como primer argumento y "-1" como segundo. De forma predeterminada, esta función envía una solicitud GET HTTP. Para enviar una solicitud HTTP POST en su lugar, incluye datos dentro del argumento opcional postBody. Si los datos que se envían no son del tipo "application/x-www-form-urlencoded," transfiere el tipo de contenido como una cadena en el argumento postContentType. Este método está sujeto a restricciones de secuencias de comandos multisitio. Ten en cuenta que este método utiliza la implementación XmlHttpRequest subyacente del navegador. |
Esta clase ajusta la clase GGeocodeCache básica al aplicar condiciones más estrictas a las respuestas almacenadas en caché. Solo 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 solo las respuestas que considera factuales.
(A partir de la versión 2.55) |
| Método | Valor de retorno | Descripción |
|---|---|---|
isCachable(reply:Object)
|
Boolean |
Anula la implementación predeterminada de este método para realizar una comprobación más exhaustiva del código de estado. Solo se consideran almacenables en caché las respuestas con el estado Status.code establecido en G_GEO_SUCCESS o que se consideran no válidas. Las respuestas que han agotado el tiempo de espera o que han obtenido un error genérico del servidor no se almacenan en la memoria caché.
(A partir de la versión 2.55) |
No hay constantes simbólicas definidas para esta enumeración.
| 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
|
Precisión a nivel de región (estado, provincia, prefectura, etc.)
(A partir de la versión 2.59) |
3
|
Precisión a nivel de subregión (condado, municipalidad, etc.)
(A partir de la versión 2.59) |
4
|
Precisión a nivel de ciudad o de 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
|
Precisión a nivel de instalaciones (nombre del edificio, nombre de la propiedad, centro comercial, etc.)
(A partir de la versión 2.105) |
Los equivalentes numéricos de cada constante simbólica se especifican junto al signo igual.
| Constante | Descripción |
|---|---|
G_GEO_SUCCESS |
No se han producido errores; la dirección se ha analizado correctamente y se ha devuelto 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, es posible que la solicitud se haya rechazado si superaba el máximo permitido de hitos.
(A partir de la versión 2.81) |
G_GEO_SERVER_ERROR |
No se ha podido procesar correctamente la solicitud de codificación geográfica, de ruta ni de nivel de zoom máximo; no se conoce el motivo exacto del error.
(A partir de la versión 2.55) |
G_GEO_MISSING_QUERY |
El parámetro q HTTP faltaba o no tenía ningún valor. Para las solicitudes de codificación geográfica, esto significa que se ha especificado una dirección vacía como entrada. Para las solicitudes de ruta, esto significa que no se ha especificado ninguna consulta en la entrada.
(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 ninguna ubicación geográfica correspondiente a la dirección especificada. Esto puede deberse al hecho de que la dirección es relativamente nueva o es incorrecta.
(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 ha podido crear la ruta entre los puntos mencionados en la consulta. Esto suele deberse a que no hay ninguna ruta disponible entre ambos puntos o a que no disponemos de los datos necesarios en esa regió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 24 horas o ha enviado demasiadas solicitudes en muy poco tiempo. Si vas a enviar varias solicitudes en paralelo o en un bucle 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) |
Un objeto GGeoXml añade contenido geográfico al mapa a partir de un archivo XML (como un archivo KML) alojado en un servidor web de acceso público. Implementa la interfaz GOverlay y, por tanto, se puede añadir al mapa con el método GMap2.addOverlay().
| Constructor | Descripción |
|---|---|
GGeoXml(urlOfXml:String)
|
Crea una interfaz GOverlay que representa el archivo XML.
(A partir de la versión 2.108) |
| Método | Valor de retorno | Descripción |
|---|---|---|
getTileLayerOverlay()
|
GTileLayerOverlay |
Los objetos GGeoXml pueden crear una superposición de mosaico con motivos de optimización en determinados casos. Este método devuelve la superposición de capa de mosaico (si está disponible). Ten en cuenta que la superposición de mosaico puede ser null si no es necesaria o si el archivo GGeoXml aún no ha terminado de cargarse.(Obsoleto desde la versión 2.141) |
getDefaultCenter()
|
GLatLng |
Devuelve el centro de la ventana gráfica predeterminada como un par lat/lng. Solo se debe ejecutar esta función después de haber cargado el archivo.
(A partir de la versión 2.84) |
getDefaultSpan()
|
GLatLng |
Devuelve la extensión de la ventana gráfica predeterminada como un par lat/lng. Solo se debe ejecutar esta función después de haber cargado el archivo.
(A partir de la versión 2.84) |
getDefaultBounds()
|
GLatLngBounds |
Devuelve el cuadro delimitador de la ventana gráfica predeterminada. Solo se debe ejecutar esta función después de haber cargado el archivo.
(A partir de la versión 2.84) |
gotoDefaultViewport(map:GMap2)
|
None |
Establece la ventana gráfica del mapa como la ventana gráfica 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 aún no ha terminado de cargarse, este método devuelve false.
(A partir de la versión 2.84) |
hide()
|
None |
Oculta las superposiciones secundarias creadas por el objeto GGeoXml si la superposición es visible en ese momento y el método supportsHide() de la superposición devuelve true. Ten en cuenta que este método desencadenará el evento visibilitychanged respectivo para cada superposición secundaria que active dicho evento (como GMarker.visibilitychanged, GGroundOverlay.visibilitychanged, etc.). Si en ese momento no hay ninguna superposición visible que devuelva supportsHide() como true, este método no tendrá ningún efecto.
(A partir de la versión 2.87) |
isHidden()
|
Boolean |
Devuelve true únicamente si el objeto GGeoXml está oculto en ese momento, como modificado por el método GGeoXml.hide().(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 no ha terminado de cargarse, este método devolverá un valor no definido.
(Obsoleto desde la versión 2.146) |
show()
|
None |
Muestra las superposiciones secundarias creadas por el objeto GGeoXml, si están ocultas en ese momento. Ten en cuenta que este método desencadenará el evento visibilitychanged respectivo para cada superposición secundaria que active dicho evento (como GMarker.visibilitychanged, GGroundOverlay.visibilitychanged, etc.).
(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 ha terminado de cargarse y todas las superposiciones asociadas se han mostrado en el mapa, o bien si el archivo XML no se ha cargado correctamente.(A partir de la versión 2.108) |
Esta clase mantiene un mapa a partir de las direcciones a ubicaciones conocidas. Aunque esta clase es completamente funcional, se concibe como una clase básica de la cual se derivan cachés sofisticadas.
| Constructor | Descripción |
|---|---|
GGeocodeCache()
|
Crea una nueva caché para almacenar un mapa a partir de direcciones a ubicaciones. El constructor ejecuta inmediatamente el método GGeocodeCache.reset.
(A partir de la versión 2.55) |
| Método | Valor de retorno | Descripción |
|---|---|---|
get(address:String)
|
Object |
Devuelve la respuesta que se almacenó en la dirección (address) especificada. Si nunca se ha almacenado una respuesta para la dirección especificada, este método devuelve null.
(A partir de la versión 2.55) |
isCachable(reply:Object)
|
Boolean |
Determina si la respuesta especificada se debe almacenar en la memoria caché. De forma predeterminada, se realizan comprobaciones muy rudimentarias en el objeto reply. En particular, esta clase se asegura de que el objeto no sea null y de que tenga el campo name. Es posible este método quede anulada al ampliar las clases para proporcionar condiciones más precisas en el objeto reply.
(A partir de la versión 2.55) |
put(address:String,
reply:Object)
|
None |
Almacena la respuesta (reply) especificada en la dirección (address) especificada. Este método ejecuta el método GGeocodeCache.isCachable para verificar que reply se puede almacenar en la memoria caché. Si obtiene la aprobación, almacenará reply en la dirección normalizada con la ayuda del método GGeocodeCache.toCanoninical.
(A partir de la versión 2.55) |
reset()
|
None |
Purga todas las respuestas de la memoria caché. Después de ejecutar este método, la memoria caché estará 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 uno solo.
(A partir de la versión 2.55) |
La clase GGoogleBar proporciona funciones de búsqueda local dentro de las aplicaciones del API de Google Maps, lo que permite a los usuarios buscar ubicaciones de listas locales. GGoogleBar no tiene constructor. La crea el mapa y se accede a ella a través del método GMap2.enableGoogleBar(). Nota: actualmente, GoogleBar no es compatible con el complemento de Google Earth que utiliza el tipo de mapa GMapType.G_SATELLITE_3D_MAP, por lo que se inhabilitará mientras se muestre dicho complemento.
Esta clase representa opciones que se han transmitido al objeto GGoogleBarOptions dentro del parámetro adsOptions. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
client
|
String |
Esta propiedad especifica la ID de cliente de tu cuenta de AdSense para búsqueda de Google. Al especificar este parámetro podrás obtener ingresos con los anuncios mostrados en los resultados de búsqueda de GoogleBar. (A partir de la versión 2.149) |
channel
|
String |
Esta propiedad especifica el número de canal de tu cuenta de AdSense para búsqueda de Google, si has configurado previamente dicho canal. Los canales de AdSense te permiten realizar un seguimiento de las campañas de publicidad y determinar las fuentes que proporcionan ingresos. Ten en cuenta que los canales están unidos a las ID de cliente, por lo que también debes transmitir un parámetro client si deseas especificar un canal.(A partir de la versión 2.149) |
adsafe
|
String |
Esta propiedad especifica el nivel de "seguridad" de anuncios que se debe utilizar en tu GGoogleBar para los resultados de publicidad. El nivel de seguridad de anuncios indica el nivel de filtrado de contenido adulto que se aplica a los resultados de búsqueda. Hay cuatro valores disponibles. El valor "high" (predeterminado) indica que no se proporcionan anuncios para adultos. El valor "medium" indica que se pueden suministrar anuncios de temas adultos si el usuario lo solicita explícitamente (por ejemplo, anuncios de alcohol), pero no se proporcionarán anuncios de contenido pornográfico. El valor "low" indica que se pueden suministrar anuncios de temas adultos y de contenido pornográfico si el usuario lo solicita explícitamente. El valor "off" indica que se puede proporcionar cualquier tipo de anuncio. No se admiten otros valores.(A partir de la versión 2.149) |
language
|
String |
Esta propiedad especifica el idioma en el que se deben proporcionar los resultados de publicidad. Los idiomas se especifican con los códigos de idioma BCP 47 (por ejemplo, "en" para inglés o "pt-BR" para portugués de Brasil). (A partir de la versión 2.149) |
Estas constantes se incluyen en GGoogleBarOptions.linkTarget y definen el destino predeterminado de los enlaces en ventanas de información de resultados.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_LINK_TARGET_BLANK
|
Se corresponde con target = '_blank'. |
G_GOOGLEBAR_LINK_TARGET_PARENT
|
Se corresponde con target = '_parent'. |
G_GOOGLEBAR_LINK_TARGET_SELF
|
Se corresponde con target = '_self'. |
G_GOOGLEBAR_LINK_TARGET_TOP
|
Se corresponde con target = '_top'. |
Estas constantes restringen el tipo de resultados devueltos por una búsqueda local con GGoogleBar. Este comportamiento de la búsqueda se establece en la propiedad GGoogleBarOptions.listingTypes.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_TYPE_BLENDED_RESULTS
|
Esta constante indica que las búsquedas realizadas con GGoogleBar en el mapa deben devolver todo tipo de resultados (KML, comercios, 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 solo 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 solo los resultados de empresas y de códigos geográficos.(A partir de la versión 2.113) |
Esta clase representa opciones que se han transmitido dentro del parámetro googleBarOptions al objeto GMapOptions. No tiene constructor, pero se inicia como un objeto literal. Ten en cuenta que el objeto GGoogleBar, al igual que GInfoWindow, no se construye, sino que se asocia al objeto del mapa y se habilita mediante las propiedades descritas aquí.
| Propiedad | Tipo | Descripción |
|---|---|---|
showOnLoad
|
Boolean |
Cuando esta propiedad se establece en true, se muestra el cuadro de búsqueda de texto de GoogleBar (siempre que el control esté habilitado y el mapa se haya cargado). El cuadro de búsqueda de texto del control se encuentra oculto de forma predeterminada y solo se amplía al hacer clic en la lupa del control. Nota: al establecer la propiedad style en "new", se muestra siempre el cuadro de búsqueda de texto de GoogleBar y se ignora esta propiedad.(A partir de la versión 2.95) |
style
|
String |
Esta propiedad indica el estilo que utiliza GGoogleBar. Esta propiedad ha quedado obsoleta porque solo existe un estilo para GGoogleBar.(Obsoleto desde la versión 2.175) |
adsOptions
|
GGoogleBarAdsOptions |
Esta propiedad indica los parámetros que se deben usar para mostrar publicidad cuando se utiliza GGoogleBar. La publicidad está habilitada en GoogleBar de forma predeterminada. Configura estas opciones para añadir información sobre cómo se debe mostrar esa publicidad y para determinar las cuentas de AdSense que se deben vincular (para obtener ingresos).(A partir de la versión 2.149) |
linkTarget
|
GGoogleBarLinkTarget |
Esta propiedad permite especificar el destino de los enlaces incluidos en los resultados de búsqueda de GoogleBar. El valor predeterminado, G_GOOGLEBAR_LINK_TARGET_BLANK, especifica que los enlaces se abrirán en una ventana nueva.(A partir de la versión 2.95) |
listingTypes
|
GGoogleBarListingTypes |
Esta propiedad especifica los tipos de listas de resultados de búsqueda que GoogleBar ha obtenido y mostrado. El valor predeterminado es G_GOOGLEBAR_TYPE_BLENDED_RESULTS, que especifica que solo se devuelvan resultados KML y locales (listas de empresas y elementos destacados).(A partir de la versión 2.113) |
resultList
|
GGoogleBarResultList or Element |
Esta propiedad permite especificar el estilo de la lista de resultados de búsqueda para GoogleBar, que puede ser uno de los siguientes: G_GOOGLEBAR_RESULT_LIST_INLINE (predeterminado) coloca la lista de resultados en una tabla por encima del cuadro de búsqueda, G_GOOGLEBAR_RESULT_LIST_SUPPRESS sustituye la lista por un conjunto de botones siguiente/anterior y si se transmite un elemento (Element) DOM en bloque, la lista se sitúa dentro del contenedor que se especifique (normalmente es un elemento <div>).(A partir de la versión 2.95) |
suppressInitialResultSelection
|
Boolean |
Esta propiedad omite el primer resultado dentro de su propia ventana de información cuando se termina una búsqueda en GoogleBar (este es el comportamiento predeterminado).(A partir de la versión 2.95) |
suppressZoomToBounds
|
Boolean |
Esta propiedad suprime el zoom y la ampliación automática para ajustarse al conjunto de resultados tras completar una búsqueda en GoogleBar. (Esta propiedad suprime el comportamiento predeterminado).(A partir de la versión 2.95) |
onIdleCallback
|
Function |
Esta propiedad especifica que se ejecute una función de devolución de llamada cuando GoogleBar termina de buscar y los resultados de la búsqueda se rechazan.(A partir de la versión 2.95) |
onSearchCompleteCallback
|
Function |
Esta propiedad especifica que se ejecute una función de devolución de llamada cuando GoogleBar termina de buscar y la búsqueda se completa. Se transmite el objeto GlocalSearch asociado al control de búsqueda. Esta función de devolución de llamada se ejecuta antes de que los resultados se coloquen en el mapa o en la lista de resultados.(A partir de la versión 2.95) |
onGenerateMarkerHtmlCallback
|
Function |
Esta propiedad permite especificar la ejecución de una función de devolución de llamada cuando se abra la ventana de información de un marcador de resultado de búsqueda. Esta función debe recibir un GMarker, una cadena HTML generada y un GlocalSearchResult (en ese orden) y debe devolver la cadena HTML modificada para mostrarla en la ventana de información.(A partir de la versión 2.95) |
onMarkersSetCallback
|
Function |
Esta propiedad permite especificar la ejecución de una función de devolución de llamada cuando GGoogleBar completa la creación de sus marcadores y los coloca en el mapa. Esta función debe recibir un conjunto de objetos del formulario {result: GlocalSearch, marker: GMarker}.(A partir de la versión 2.95) |
Estas constantes se incluyen en GGoogleBarOptions.resultList y definen cómo se muestra la lista de resultados.
| Constante | Descripción |
|---|---|
G_GOOGLEBAR_RESULT_LIST_INLINE
|
Este es el estilo predeterminado, en el que la lista de resultados se muestra en forma de tabla en el mapa. |
G_GOOGLEBAR_RESULT_LIST_SUPPRESS
|
Esta constante se corresponde con el estilo predeterminado, donde la lista de resultados está oculta y se sustituye con los botones siguiente/anterior. |
Esta clase identifica de forma exclusiva una foto aportada por el usuario en Street View. No tiene constructor, pero se inicia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
repository
|
string |
Repositorio donde se almacena la foto. Actualmente, solo se admite el valor "panoramio".
(A partir de la versión 2.182) |
id
|
string |
Cadena que identifica de forma única la foto según su repositorio. Para Panoramio, esta es la representación de cadena de "photo_id" de Panoramio. Consulta el API de Panoramio para obtener información sobre cómo conseguir los ID de fotos según la latitud/longitud de un cuadro delimitador.
(A partir de la versión 2.182) |
Esta clase representa la estructura de un punto de vista de cámara utilizado por Street View. No tiene constructor, pero se inicia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
yaw
|
Number |
La oblicuidad de la cámara expresado en grados en relación al norte absoluto. El norte absoluto está a 0°, el este a 90°, el sur a 180° y el oeste a 270°.
(A partir de la versión 2.104) |
pitch
|
Number |
La inclinación de la cámara en grados, en relación al vehículo de Street View. Oscila entre 90° (completamente hacia arriba) y -90° (completamente hacia abajo).
(A partir de la versión 2.104) |
zoom
|
Number |
El nivel de zoom. El nivel de zoom más pequeño, es decir, la vista más alejada, es el 0. A medida que se acerca la imagen, el nivel de zoom aumenta. (A partir de la versión 2.104) |
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. Los clientes no deben crear directamente objetos de esta clase.
| Método | Valor de retorno | 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 del paso enésimo de la ruta.
(A partir de la versión 2.81) |
getStartGeocode()
|
Object |
Devuelve el resultado de identificador geográfico correspondiente al punto inicial de 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 |
El resultado de identificador geográfico correspondiente al punto final de 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 del último punto correspondiente al paso en cuestión a lo largo de la polilínea de esta ruta. Ten presente que este punto puede variar con respecto a lat,lng en GRoute.getEndGeocode(), porque getEndLatLng() siempre devuelve un punto pegado a la red de carreteras. No existe un método getStartLatLng() correspondiente porque es idéntico a ejecutar 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 esta ruta. Consulta la estructura de este objeto en GDirections.getDistance().
(A partir de la versión 2.81) |
getDuration()
|
Object |
Devuelve un objeto literal que representa la duración total de esta ruta. Consulta la estructura de este objeto en GDirections.getDuration().
(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 de los resultados de ruta. Esta clase no tiene constructor. Los clientes no deben crear directamente objetos de esta clase.
| Método | Valor de retorno | Descripción |
|---|---|---|
getLatLng()
|
GLatLng |
Devuelve un objeto GLatLng del primer punto correspondiente al paso en cuestión a lo largo de la polilínea.
(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 de este paso. Consulta la estructura de este objeto en GDirections.getDistance().
(A partir de la versión 2.81) |
getDuration()
|
Object |
Devuelve un objeto literal que representa la duración total de este paso. Consulta la estructura de este objeto en GDirections.getDuration().
(A partir de la versión 2.81) |
Un objeto GStreetviewClient realiza búsquedas de datos de Street View según los parámetros que se transmiten a sus métodos.
| Constructor | Descripción |
|---|---|
GStreetviewClient()
|
Crea un nuevo GStreetviewClient.
(A partir de la versión 2.104) |
| Método | Valor de retorno | 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 lo transmite a la devolución de llamada indicada. Si no hay ninguna panorámica cercana o si se ha producido un error del servidor, la devolución de llamada indicada se transmitirá como 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 al valor indicado para latlng y los transmite a la devolución de llamada indicada como un 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 indicado y los transmite a la devolución de llamada indicada como un objeto GStreetviewData. Los ID son únicos para cada panorámica y se mantienen estables durante una sesión, pero 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 junto al signo igual.
| Constante | Descripción |
|---|---|
SUCCESS |
Éxito (A partir de la versión 2.104) |
SERVER_ERROR |
El servidor no está respondiendo a las consultas. (A partir de la versión 2.104) |
NO_NEARBY_PANO |
No se ha encontrado ninguna panorámica. (A partir de la versión 2.104) |
Esta clase representa los datos asociados a una panorámica. No tiene constructor, pero se inicia 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 |
Una atribución de derechos de autor localizada (A partir de la versión 2.104) |
links
|
GStreetviewLink[] |
Enlaza con panorámicas vecinas, si hubiera alguna. (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 controla cuáles son los principales modos de visualización que se deben habilitar. Esta clase no tiene constructor, pero se inicia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
streetView
|
Boolean |
El modo de visualización streetView muestra imágenes panorámicas tomadas a pie de calle. Es el modo de visualización estándar de GStreetviewPanorama.
(A partir de la versión 2.182) |
userPhotos
|
Boolean |
El modo de visualización userPhotos permite ver fotos generadas por el usuario. Si esta función y la función streetView están habilitadas, las fotos aparecerán automáticamente cuando estén disponibles en forma de miniaturas en la esquina superior derecha de la panorámica de Street View. Las fotos también se muestran de forma automática con la función GStreetviewPanorama.setUserPhoto().
(A partir de la versión 2.182) |
Esta clase representa un enlace de una ubicación GStreetviewLocation a una ubicación GStreetviewLocation vecina. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
yaw
|
Number |
La oblicuidad desde la ubicación actual hasta la ubicación vecina. (A partir de la versión 2.104) |
description
|
String |
Es una cadena localizada que describe la ubicación vecina. (A partir de la versión 2.104) |
panoId
|
String |
Es un identificador exclusivo de la panorámica vecina. Se mantiene estable en una sesión, pero es inestable en diferentes sesiones. (A partir de la versión 2.104) |
Esta clase representa una ubicación de Street View. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
latlng
|
GLatLng |
Las coordenadas latlng de la panorámica (A partir de la versión 2.104) |
pov
|
GPov |
El punto de vista inicial (A partir de la versión 2.104) |
description
|
String |
Es una cadena localizada que describe la ubicación. (A partir de la versión 2.104) |
panoId
|
String |
Es un identificador exclusivo de la panorámica. Se mantiene estable en una sesión, pero es inestable en diferentes sesiones. (A partir de la versión 2.104) |
Un objeto GStreetviewOverlay es un conjunto de mosaicos que resalta ubicaciones donde hay datos de Street View disponibles. Esta clase implementa la interfaz GOverlay y se puede añadir al mapa mediante map.addOverlay y eliminar del mapa mediante map.removeOverlay.
| Constructor | Descripción |
|---|---|
GStreetviewOverlay()
|
Crea un nuevo objeto GStreetviewOverlay que implementa la interfaz GOverlay.(A partir de la versión 2.104) |
| Evento | Descripción |
|---|---|
changed(hasStreetviewData:Boolean)
|
Este evento se activa cuando el estado de los datos de Street View cambia en la ventana gráfica actual. Se activa al mover el mapa desde un área con datos de Street View a otra sin datos y viceversa. También se activa cuando al añadir un objeto GStreetviewOverlay al mapa, los datos de Street View aparecen en la ventana gráfica. El parámetro hasStreetviewData será true únicamente si la ventana gráfica contiene datos de Street View.(A partir de la versión 2.120) |
Un objeto GStreetviewPanorama contiene una instancia del visor panorámico Flash® de Street. Cada objeto de esta clase contiene una instancia diferente, mostrando así una vista única. Normalmente, este objeto está incluido en un objeto contenedor, como un DIV, y se puede manipular para cambiar su vista mediante los métodos de esta clase. Los datos de Street View no están disponibles en todas las ubicaciones. Utiliza el objeto GStreetviewClient o el objeto GStreetviewOverlay para determinar si hay disponibles datos de Street View en tu ubicación.
| Constructor | Descripción |
|---|---|
GStreetviewPanorama(container:Node,
opts?:GStreetviewPanoramaOptions)
|
Crea un nuevo objeto GStreetviewPanorama con su visor Flash correspondiente en el contenedor proporcionado. El visor no se mostrará hasta que se especifique una ubicación, ya sea en el objeto opcional GStreetviewPanoramaOptions opts o mediante la ejecución de setLocationAndPOV.
(A partir de la versión 2.104) |
| Método | Valor de retorno | Descripción |
|---|---|---|
remove()
|
None |
Elimina la instancia del visor Flash actual asociado a este objeto desde el DOM. Esta función se debe ejecutar antes de eliminar el elemento contenedor HTML, de lo contrario algunos navegadores no podrán recolectar la basura del visor Flash.
(A partir de la versión 2.104) |
setContainer(container:Node)
|
None |
Establece el elemento contenedor del visor Flash, moviéndolo de su ubicación original si está abierto en ese momento.
(A partir de la versión 2.104) |
checkResize()
|
None |
Notifica al visor Flash un cambio en el tamaño de su contenedor. Ejecuta este método si el tamaño del objeto DOM del contenedor ha cambiado para ajustar el visor al nuevo tamaño.
(A partir de la versión 2.104) |
hide()
|
None |
Oculta el visor Flash. Para eliminar el visor, ejecuta .remove() en su lugar.
(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 únicamente si el visor Flash asociado a este objeto está oculto.(A partir de la versión 2.104) |
getLatLng()
|
GLatLng |
Devuelve la latitud y la longitud del objeto panorámico.
(A partir de la versión 2.189) |
getPanoId()
|
string |
Devuelve el ID del objeto panorámico.
(A partir de la versión 2.189) |
getPOV()
|
GPov |
Devuelve el punto de vista actual mostrado en el visor Flash.
(A partir de la versión 2.104) |
setPOV(pov:GPov)
|
None |
Cambia el punto de vista actual mostrado 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 actual mostrado en el visor Flash sin cambiar la ubicación. Realiza una animación progresiva desde el punto de vista actual al nuevo. Si opt_longRoute está configurado, la animación seguirá una ruta larga alrededor de la esfera; de lo contrario, tomará la ruta más corta.
(A partir de la versión 2.104) |
setLocationAndPOV(latlng:GLatLng,
opt_pov:GPov)
|
None |
Establece 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 según el valor indicado para latlng, si se ha especificado alguno. Si no se disponen de datos para esta ubicación, el reproductor Flash permanecerá inalterado y emitirá un código de error. Consulta GStreetviewClient.ReturnValues para obtener información sobre los posibles códigos de respuesta.
(A partir de la versión 2.104) |
setUserPhoto(photoSpec:GPhotoSpec)
|
None |
Muestra una foto aportada por el usuario en el visor Flash. Después de ejecutar esta función, el visor mostrará la foto identificada de forma única por photoSpec. Si la foto no se puede mostrar, el reproductor Flash permanecerá inalterado y emitirá el código de error GStreetviewPanorama.ErrorValues.NO_PHOTO.
(A partir de la versión 2.182) |
followLink(yaw:Number)
|
None |
Sigue un enlace desde la panorámica actual a la panorámica vecina. yaw especifica la dirección de la panorámica vecina; si hay varias panorámicas en las proximidades, se seleccionará la más próxima.(A partir de la versión 2.104) |
| Evento | Descripción |
|---|---|
yawchanged(yaw:Number)
|
Este evento se activa cuando cambia la oblicuidad que se muestra en el visor Flash.
(A partir de la versión 2.104) |
pitchchanged(pitch:Number)
|
Este evento se activa cuando cambia la inclinación que se muestra en el visor Flash.
(A partir de la versión 2.104) |
zoomchanged(zoom:Number)
|
Este evento se activa cuando cambia el nivel de zoom 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 obtener información sobre los distintos tipos de error.(A partir de la versión 2.104) |
initialized(location:GStreetviewLocation)
|
Este evento se activa cuando la panorámica se inicializa después del traslado a la nueva ubicación. La ubicación es un objeto GStreetviewLocation. Nota: el evento initialized no se envía la primera vez que se renderiza la vista panorámica; este es un problema del que tenemos constancia y que solucionaremos en una próxima versión.
(Obsoleto desde la versión 2.170) |
initialized(location:GStreetviewLocation)
|
Este evento se activa cada vez que se inicializa una vista panorámica. La ubicación es un objeto GStreetviewLocation. Ten en cuenta que este evento se activa nada más comenzar el procesamiento, pero que es posible que los datos de las imágenes no se carguen en ese momento.
(A partir de la versión 2.170) |
Los equivalentes numéricos de cada constante simbólica se especifican junto al signo igual.
| Constante | Descripción |
|---|---|
NO_NEARBY_PANO |
No se ha encontrado ninguna panorámica. (A partir de la versión 2.104) |
NO_PHOTO |
No se ha encontrado ninguna foto del usuario. (A partir de la versión 2.182) |
FLASH_UNAVAILABLE |
El visor Flash no estaba disponible, normalmente debido a que el navegador del usuario no admite contenido Flash. (A partir de la versión 2.104) |
Esta clase representa las opciones transmitidas al constructor de GStreetviewPanorama. Esta clase no tiene constructor, pero se inicia 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 con la que abrir el visor Flash
(A partir de la versión 2.104) |
enableFullScreen
|
Boolean |
De forma predeterminada, el visor panorámico incluye un control de pantalla completa en la esquina superior derecha. Para no incluir el control de pantalla completa, establece esta etiqueta en false.
(A partir de la versión 2.175) |
features
|
GStreetviewFeatures |
De forma predeterminada, el visor panorámico habilitará los principales modos de visualización. Esta etiqueta se puede utilizar para habilitar o inhabilitar de forma selectiva determinados modos.
(A partir de la versión 2.182) |
userPhotosOptions
|
GStreetviewUserPhotosOptions |
Esta propiedad opcional se ignorará, a menos que se habilite la función userPhotos con la clase GStreetviewFeatures.
(A partir de la versión 2.182) |
Esta clase representa las opciones disponibles en el modo de visualización userPhotos. Esta clase no tiene constructor, pero se inicia como un objeto literal. Todas las propiedades son opcionales.
| Propiedad | Tipo | Descripción |
|---|---|---|
photoRepositories
|
Array |
Un conjunto opcional de cadenas. Cada cadena especifica un repositorio de fotos que habilitar. Si está ausente, todos los repositorios de fotos se habilitarán. Los valores válidos son: "panoramio", "picasa" y "flickr".
(A partir de la versión 2.182) |
Un GTrafficOverlay objeto añade una superposición al mapa que muestra información sobre el tráfico en carretera. Implementa la interfaz GOverlay y la añade al mapa con el método GMap2.addOverlay() y la elimina con el método GMap2.removeOverlay(). La clase GTrafficOverlay solo mostrará información de tráfico de las ciudades admitidas.
| Constructor | Descripción |
|---|---|
GTrafficOverlay(opts?:GTrafficOverlayOptions)
|
Crea un nuevo objeto GTrafficOverlay que muestra información del tráfico en carretera.(A partir de la versión 2.81) |
| Método | Valor de retorno | Descripción |
|---|---|---|
hide()
|
None |
Oculta la superposición de tráfico. (A partir de la versión 2.81) |
show()
|
None |
Muestra la superposición de tráfico. (A partir de la versión 2.81) |
| Evento | Descripción |
|---|---|
changed(hasTrafficInView:Boolean)
|
Este evento se activa cuando el estado de los datos de tráfico cambia en la ventana gráfica actual. Este evento se activa al mover el mapa de un área con datos de tráfico a otra sin datos. También se activa cuando al añadir un objeto GTrafficOverlay al mapa, los datos de tráfico aparecen en la ventana gráfica actual. El parámetro hasTrafficInView será true si la ventana gráfica contiene datos y false en caso contrario. El evento funciona independientemente de si la capa está visible u oculta.
(A partir de la versión 2.85) |
Esta clase representa argumentos opcionales del constructor GTrafficOverlay. No tiene constructor, pero se inicia como un objeto literal.
| Propiedad | Tipo | Descripción |
|---|---|---|
incidents
|
Boolean |
Cuando el valor es true, indica que el objeto GTrafficOverlay debe mostrar accidentes de tráfico en el mapa, cuando corresponda. El valor predeterminado es false.(A partir de la versión 2.121) |
hide
|
Boolean |
Cuando el valor es true, indica que el mapa no debe mostrar GTrafficOverlay inicialmente. Para activar la superposición, ejecuta GTrafficOverlay.show(). El valor predeterminado es false.
(A partir de la versión 2.121) |
| Constante | Descripción |
|---|---|
G_TRAVEL_MODE_WALKING
|
A pie (A partir de la versión 2.129) |
G_TRAVEL_MODE_DRIVING
|
En coche (A partir de la versión 2.129) |
Este espacio de nombre proporciona métodos estáticos para gestionar documentos XML y fragmentos de documentos.
| Método | Valor de retorno | Descripción |
|---|---|---|
GXml.parse(xmltext:String)
|
Node |
Analiza la cadena especificada como texto XML y devuelve una presentación DOM. Si el navegador no admite análisis XML de forma nativa, devolverá el nodo DOM de un elemento DIV vacío. |
GXml.value(xmlnode:Node)
|
String |
Devuelve el valor de texto (es decir, solo el contenido de texto sin formato) del fragmento de documento XML en cuestión en una representación DOM. |
Este espacio de nombre proporciona un método de diseño para crear instancias de XmlHttpRequest de una forma independiente al navegador.
| Método | Valor de retorno | Descripción |
|---|---|---|
GXmlHttp.create()
|
GXmlHttp |
Diseño para crear una nueva instancia de XmlHttpRequest |
Esta clase proporciona métodos para aplicar XSLT a XML de una forma independiente al navegador.
| Método | Valor de retorno | Descripción |
|---|---|---|
GXslt.create(xsltnode:Node)
|
GXslt |
Crea una instancia GXslt a partir de la hoja de estilo XSLT especificada como representación DOM. |
GXslt.transformToHtml(xmlnode:Node,
htmlnode:Node)
|
Boolean |
Utiliza la hoja de estilo XSLT especificada en el constructor de esta instancia GXslt para transformar el documento XML especificado como representación DOM en xmlnode. Anexa el fragmento de documento HTML resultante al htmlnode especificado. Esto solo funciona si el navegador admite por su lado transformaciones XSL, en cuyo caso devolverá true. De lo contrario, esta función no hará nada y devolverá false. |