AYUDA EN LÍNEA
 WINDEV, WEBDEV Y WINDEV MOBILE
Ayuda / Desarrollar una aplicación o un sitio web / Controles, ventanas y páginas / Controles: tipos disponibles / Control Mapa
  • Presentación
  • Inicializar un mapa
  • Mostrar un mapa
  • Gestión de parámetros avanzados (WEBDEV)
  • Funciones de controles Mapa
  • Observaciones
  • Propiedades específicas de los controles Mapa
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Presentación
WINDEV, WEBDEV y WINDEV Mobile permiten manipular controles Mapa mediante programación. Para ello, utilice la variable del control Mapa en el código.
La variable del control Mapa corresponde al nombre del control.
Esta página de ayuda explica cómo manipular controles Mapa mediante programación.
Observación: Existen varias funciones WLanguage específicas para los controles Mapa. Para obtener más información, consulte Funciones de controles Mapa.
Inicializar un mapa

Mostrar un mapa

Cuando se abre una ventana que contiene un control Mapa, se muestra un mapa del mundo automáticamente: el mapa se centra en Europa, con un nivel mínimo de zoom.
Puede visualizar la última ubicación en el mapa: simplemente seleccione la opción "Recordar última posición mostrada" en la pestaña "General" de la ventana de descripción del control Mapa. En este caso, se muestra la última ubicación con el mismo nivel de zoom.
Para mostrar una ubicación específica en el mapa, utilice:
  • la función MapDisplayPosition: Esta función permite mostrar una ubicación específica (variable de tipo geoPosition), una ciudad o un monumento.
    Por ejemplo:
    // Centers the map displayed by the "MAP_Position" control
    // on a geographical location
    MyPosition is geoPosition
    MapDisplayPosition(MAP_Position, MyPosition)
     
    // Centers the map displayed by the "MAP_Position" control on a city
    // from its name
    MapDisplayPosition(MAP_Position, "Montpellier, France")
     
    // Centers the map displayed by the "MAP_Position" control on a monument
    // from its name
    MapDisplayPosition(MAP_Position, "Eiffel Tower")
  • un comando de asignación directa con una ubicación específica. En este caso, la ubicación se muestra sin animaciones.
    Ejemplo:
    // Centers the map displayed by the "MAP_Position" control
    // on a geographical location
    MyPosition is geoPosition
    MAP_Position = MyPosition
Gestión de parámetros avanzados (WEBDEV)
WEBDEV - Código ServidorWEBDEV - Código Navegador WEBDEV permite definir varias opciones para los controles Mapa. Sin embargo, también puede especificar parámetros adicionales mediante la API de Google Maps.
Para ello, puede utilizar las siguientes funciones:
  • MapConfigureGglAPI, que puede utilizarse en código Servidor, permite especificar parámetros adicionales para el control Mapa. Estos parámetros son globales al proyecto.
  • MapGetJSObject, que puede utilizarse en código Navegador, permite almacenar el mapa y sus opciones en un objeto dinámico para manipular el control en código JavaScript.
Ejemplo:
  • Declarar las bibliotecas que deben cargarse en código Servidor: 
    // Code serveur
MapConfigureGglAPI("libraries=geometry,places","language=fr")
  • Recuperar el objeto dinámico en código Navegador:
    // Browser code
    MyMap is object dynamic
    MyMap = MapGetJSObject(MAP_Browser)
    // Call to the JavaScript function
    FindAddress()
  • Función JavaScript utilizada para manipular el control Mapa:
    // JavaScript function that uses the dynamic object
    function FindAddress()
    {
    var infowindow;
    // Rome: 41.873144, 12.480391
    var pyrmont = new google.maps.LatLng(41.873144, 12.480391);
    var request = {
    location: pyrmont,
    radius: 500,
    types: ['store']
    };
    infowindow = new google.maps.InfoWindow();
    var service = new google.maps.places.PlacesService(MyMap);
    service.nearbySearch(request, ReturnAddress_WB);
    }
Funciones de controles Mapa
Las funciones WLanguage utilizadas con controles Mapa pueden dividirse en varias categorías:
  • Funciones para obtener ubicaciones en el mapa:
    MapDisplayPositionCenters the map displayed in a Map control on a geographical position or on a specific location.
    MapGetPositionReturns the geographical position of the point located in the center of the map currently displayed in a Map control.
    MapInfoPositionReturns the coordinates (in pixels) of the point corresponding to a geographical position (latitude and longitude).
    MapInfoXYReturns the geographical position (latitude and longitude) corresponding to a point in a Map control.
  • Funciones para rastrear el dispositivo:
    MapEndOfMoveSe detiene siguiendo el movimiento del dispositivo en un control Mapa.
    MapFollowMovementDisplays the current location of the device in a Map control and updates the location as it moves.
  • Funciones para gestionar marcadores en el mapa. Estas funciones utilizan variables de tipo Marker para definir todas las características de los marcadores.
    MapAddMarkerAdds a new marker onto a map displayed in a Map control.
    MapDeleteAllDeletes the following from a Map control:
    • all markers,
    • use any shape you want,
    • all images.
    MapDeleteMarkerDeletes a marker from a map displayed by a Map control.
    MapModifyMarkerModifies a marker displayed in a Map control.
  • Funciones para manipular rutas en el mapa.
    MapAddItineraryAdds an itinerary onto a Map control.
    MapDeleteItineraryElimina un itinerario de un control Mapa.
  • Funciones para opciones adicionales de la API de Google Maps:
    MapConfigureGglAPIDeclares additional parameters for the Map control that will be transmitted to the Google API.
    MapExecuteJSEjecuta el código nativo de Google Maps API en un control Mapa en JavaScript.
    MapGetJSObjectReturns the instance of the API of Map control.

Observaciones

  • AndroidiPhone/iPad La función geoRunApp permite iniciar la aplicación nativa de mapas del dispositivo.
  • WINDEVWEBDEV - Código Servidor La función MapLicenseGgl permite especificar el ID de Google necesario para utilizar un control Mapa con la API de Google Maps for Work. Para obtener más información, consulte las condiciones del servicio de las API de Google Maps.
    WEBDEV - Código Servidor También puede especificar la clave de la API de Google Maps en la ventana de descripción del proyecto (pestaña "Avanzado").
Propiedades específicas de los controles Mapa
Utilice las siguientes propiedades para manipular controles Mapa mediante programación:
MapModeObtiene o establece el modo de visualización del mapa en el control Mapa.
ValueCentra la vista en la posición especificada por la variable geoPosition.
ZoomObtiene o establece el nivel de zoom inicial del mapa.

Para obtener la lista completa de las propiedades WLanguage que pueden utilizarse con los controles Mapa, consulte Propiedades del control Mapa.
Ver también
Versión mínima requerida
  • Versión 17
Esta página también está disponible para…
Comentarios
Errors that may occur in Maps not working:
A) in the Google developer environment, a valid credit/debit card must be registered in the billing method of payment. If you do not have a card that has valid usage data, it may also give an error.
B) environment changes may be necessary to create new api key.
C) the api is not ok, because for the maps it has a
Different web and mobile apis, minus watching an updated tutorial.
D) ocorre erro também quando o WX (Windev, Webdev e Windev Mobile) esta desatualizado e usando a versão antiga do internet explorer. Solução mudei pra o google/edge.
E) informeo apikey válido do googlemaps.
Boller
30 08 2023

Última modificación: 18/09/2023

Señalar un error o enviar una sugerencia | Ayuda local