Inicio > Android, Delphi, FMX, iOS, Mapas > Visualizando y utilizando Mapas (Componente TMapView)

Visualizando y utilizando Mapas (Componente TMapView)

miércoles, 21 de diciembre de 2016 Dejar un comentario Ir a comentarios
Share Button


En Delphi podemos utilizar diferentes componentes que nos permitan visualizar mapas en nuestras aplicaciones. El más básico, es el componente TWebBrowser del que ya he hablado otras veces en el blog. Al final un la visualización de un Mapa (utilizando los diferentes servicios existentes) no es más que la visualización de una página web.

Si queréis ver entradas anteriores relacionadas con esto, aquí os dejo una lista:

Aparte de esto, si queréis más información sobre el tema, os puedo recomendar las webs de:

COMPONENTE TMAPVIEW

Una vez realizada esta introducción nos centraremos en el componente que Delphi trae en las nuevas versiones específico para plataformas móviles. El componente TMapView nos permite utilizar los servicios de:

Utilizando este componente nos abstraemos de la plataforma y podemos utilizar el mismo código para diferentes dispositivos.

CONFIGURACION ESPECIALES PARA ANDROID

Para utilizar este componente con Android deberemos obtener una “API KEY” de google para poder visualizar correctamente los mapas. La explicación completa podéis encontrarla aquí, aunque a continuación veremos los pasos resumidos.

Paso 1)  Acceder a Google Developers Console con vuestra cuenta de Google

Paso 2) Crear un nuevo proyecto. La pantalla actual tiene una pinta similar a esta:

Google_APIs

Paso 3) Lo siguiente que debemos hacer es crear un nuevo proyecto. En la parte superior de la pantalla tenéis un acceso para ello. Nos solicitará un nombre.

Tardará unos segundos y al finalizar el proceso ya tendremos nuestro proyecto “TestMapView” (que es el nombre que yo he escogido) creado y seleccionado en el desplegable superior.

Nuevo_proyecto

NUevo_proyecto2

Paso 4) Seleccionamos a la izquierda “biblioteca” y activamos la API: “Google Maps Android API”. Al entrar en este link aparece un botón de [HABILITAR].

Paso 5) Entrar en la sección de “Credenciales” y creamos una “Clave de API”.

crear_clave_API

Si el proceso ha sido correcto, aparecerá una ventana como la que se ve a continuación con la clave asignada. Esta clave será la que tendremos que asignar en nuestra aplicación para que pueda usar este servicio de Google.

claveAPI

Con esto el proceso está completo y ya podemos volver al IDE y comenzar nuestro proyecto.

VISUALIZAR MAPAS

Para visualizar un Mapa en el control TMapView nuestra aplicación Android, debemos modificar un par de cosas en la configuración de proyecto.

“Entitlement List”: Que viene a significar algo así como “Lista de derechos”. Ahí activaremos permiso para la opción “Maps Service”.

“Version Info”: en esa sección añadiremos como apikey la que nos ha proporcionado el servicio de google.

Configuracion

Con esta configuración, si ejecutamos la aplicación, veremos que ya nos aparece un mapa con agua (algo es algo  ;-D).

Si queremos ver algo con algo más de interés (que un montón de agua), basta añadir este código al OnShow del formulario

procedure TFormMain.FormShow(Sender: TObject);
var
  mapCenter:TMapCoordinate;
begin
  // Centrar el mapa
  mapCenter := TMapCoordinate.Create(LAT_SAGRADA_FAMILIA, LON_SAGRADA_FAMILIA);
  MapView1.Location := mapCenter;
  MapView1.Zoom := 14;
end;

Con estas líneas, creamos un coordenada (latitud + longitud) y la utilizamos para centrar el mapa en ella y de paso asignamos un zoom.

OPERACIONES BÁSICAS

OPciones_MapaEl propio componente encapsula algunas de las operaciones básicas que podemos realizar sobre el mapa. Por ejemplo, para cambiar el tipo de mapa a visualizar, basta con utilizar la propiedad MapType con alguno de los valores permitidos.

  • Normal = 1
  • Satellite = 2
  • Hybrid = 3
  • Terrain = 4

Otra propiedad que implementa es LayerOptions, que nos permite añadir “capas” con nuevos elementos al Mapa que estemos visualizando en el memento. Así que podemos añadir 1 o varias de estas capas:

  • PointsOfInterest: Para visualizar puntos de interés en el mapa.
  • Buildings: Para visualizar los edificios.
  • UserLocation: Para visualizar en control que nos permite acceder a la ubicación actual.
  • Traffic: Nos permite ver información del tráfico actual.

Mapa_Layeropcions

Tenemos también modificar la inclinación del mapa utilizando la propiedad Tilt. Para ello debemos revisar la documentación, ya que dependiendo de la plataforma, el rango de valores es diferente y el comportamiento se ve afectado por otras propiedades como el Zoom.

Y por supuesto, el Zoom del que ya hemos hablado anteriormente.

AÑADIR MARCAS, POLILÍNEAS, POLIGONOS,…

Además de lo básico que ya hemos visto, podemos añadir objetos al Mapa.

El más básico de los que podemos tratar son la Marcas (Clase TMapMarker). Nos permitirán señalar un punto (coordenada) en el mapa. Para crear una marca, nos bastará el código siguiente:

 

var
  MarcaMapa:TMapMarker;
  descMarca:TMapMarkerDescriptor;
  posicion:TMapCoordinate;
begin
  // Posicion para la marca
  posicion := TMapCoordinate.Create(LAT_SAGRADA_FAMILIA, LON_SAGRADA_FAMILIA);
  // Crear el objeto Marker
  descMarca := TMapMarkerDescriptor.Create(posicion);
  // Asignar la imagen (de un TImageList, en mi caso)
  descMarca.Icon := GetBitmap('imgMarca');
  // Definimos si se puede arrastrar
  descMarca.Draggable := False;
  descMarca.Opacity := 0.8;
  // Título y subtítulo para la ventana
  descMarca.Title := 'Sagrada familia';
  descMarca.Snippet := 'Antonio Gaudí 1882';
  // Añadirla al mapa
  MarcaMapa := MapView1.AddMarker(descMarca);
  // Centrar el mapa en ese punto.
  MapView1.Location := posicion;
end;

Con este código en el mapa veremos algo similar a esto.

Los Polígonos (TMapPolygon) y Polilíneas (TMapPolyline) son bastante similares a la forma de tratar con ellos. Básicamente tenemos una lista de puntos que hay que mostrar en el mapa. La propiedad para añadirlos es diferente, pero por lo demás son bastante similares.

Para crear una polilínea podemos utilizar este código:

NOTA: Para poder crear polilíneas y polígonos en la aplicación voy a utilizar una lista de puntos que provienen de un Track GPS, grabado directamente con el teléfono. Son coordenadas GPS que para los test están almacenados en una lista, pero que perfectamente podrían venir dados por el sensor de ubicación.

 

var
  numPuntos:integer;
  dLat, dLon:Double;
  i:integer;
  center:TMapCoordinate;
...
  // polylinea
  desCPoly: TMapPolylineDescriptor;
  mapPoly:TMapPolyline;
  puntosPoly: TArray<TMapCoordinate>;
...
begin
  // Crear el array de puntyos
  puntosPoly := TArray.Create();
  SetLength(puntosPoly, mmPuntosTest.Lines.Count);
  // Añadir los puntos
  for i := 0 to (mmPuntosTest.Lines.Count - 1) do begin
    // Coordenadas
    dLat := StrToFloatDef(AnsiReplaceText(mmPuntosTest.Lines.Names[i], '.', ','), 0);
    dLon := StrToFloatDef(AnsiReplaceText(mmPuntosTest.Lines.ValueFromIndex[i], '.', ','), 0);
    // Añadir el punto
    if (dLat <> 0) and (dLon <> 0) then begin
      puntosPoly[i].Latitude := dLat;
      puntosPoly[i].Longitude := dLon;
    end;
  end;
 
  // polylineas (utilizamos los puntos de test
  descPoly := TMapPolylineDescriptor.Create(puntosPoly);
  // Caracteristicas
  descPoly.StrokeColor := TAlphaColorRec.Red;
  descPoly.StrokeWidth := 6;
  descPoly.Geodesic := True;
  descPoly.ZIndex := 0.5;
  // Añadirla al mapa
  mapPoly := MapView1.AddPolyline(descPoly);
  // centrar el mapa (calculado aprox. a partir de los puntos)
  MapView1.Location := CenterPolyline(puntosPoly);
 
  // Crear marcas de inicio y final
  CrearMarca(MapView1, puntosPoly[0].Latitude, puntosPoly[0].Longitude, 'imgBandera');
  CrearMarca(MapView1, puntosPoly[i-1].Latitude, puntosPoly[i-1].Longitude, 'imgFinish');

En este ejemplo, vemos que se añaden los puntos a un array (puntosPoly) desde un componente mmPuntosTest (TMemo). Posteriormente se crea el elemento descPoly de tipo TMapPolylineDescriptor, que es el que define las características visuales de la polilinea. Por último se añade la polilinea al mapa para visualizarla.

En este caso para completar la visualización, se añaden 2 marcas (TMapMarker), una al punto inicial y otra al punto final de la polilinea.

A continuación se muestra una imagen cómo se vería en el mapa:

En el caso de un polígono, vemos el siguiente código, muy similar. Primero definimos los puntos que delimitan el rectángulo (en este caso).

  // Definimos un tamaño 5 (rectángulo    INICIAL=FINAL)
  SetLength(outLinePolygon.Points, 5);
  // Cuatro puntos del polígono
  arrPoints[0].Latitude := pLat - DELTA; 
  arrPoints[0].Longitude := pLon - DELTA;
  arrPoints[1].Latitude := pLat + DELTA; 
  arrPoints[1].Longitude := pLon - DELTA;
  arrPoints[2].Latitude := pLat + DELTA; 
  arrPoints[2].Longitude := pLon + DELTA;
  arrPoints[3].Latitude := pLat - DELTA; 
  arrPoints[3].Longitude := pLon + DELTA;
  // Punto final igual al inicial
  arrPoints[4].Latitude := arrPoints[0].Latitude;
  arrPoints[4].Longitude := arrPoints[0].Longitude;

A continuación lo creamos y lo añadimos al mapa:

var
  numPuntos:integer;
  dLat, dLon:Double;
  i:integer;
  center:TMapCoordinate;
begin
 
  // genera 4 punto alrededor de uno dado
  ...
 
  // polygon (utilizamos los puntos de test
  descPolygon := TMapPolygonDescriptor.Create(outLinePolygon.Points);
  // Caracteristicas
  descPolygon.StrokeColor := TAlphaColorRec.Red;
  descPolygon.StrokeWidth := 6;
  descPolygon.Geodesic := True;
  descPolygon.ZIndex := 0.5;
  descPolygon.FillColor := TAlphaColorRec.Yellow;
  // Añadirla al mapa
  mapPolygon := MapView1.AddPolygon(descPolygon);
  // centrar el mapa (calculado aprox. a partir de los puntos)
  MapView1.Location := CenterPolyline(outLinePolygon.Points);

El resultado es el que se ve a continuación:

MOVIMIENTO Y ANIMACIÓN

En el ejemplo (y en el vídeo del final de la entrada) se muestra también algo de animación. Por ejemplo utilizando los métodos SetVisible que poseen todos los objetos. En el caso de las marcas, en el ejemplo se utiliza el método Remove para eliminar la marca creada y volver a crear en una nueva posición y de esta forma darle movimiento.

En el caso de los polígonos y polilíneas el método Remove no está disponible (o mejor dicho, ahora tiene un error), así que se ha solventado utilizando un método alternativo (menos eficiente).

Finalmente os dejo un vídeo de la aplicación funcionando, donde repaso un poco por encima las características de las que hemos hablado y cómo funcionan en un dispositivo móvil (Android).

UN PAR DE PROBLEMILAS…

Hay un par de pequeños bugs que afectan a TMapView y que me he encontrado durante el desarrollo de esta entrada y del ejemplo.

Los adjunto para que si veis el código sepáis porqué se ha hecho así.

Si alguno estáis interesados en este tema y os afectan podéis votarlos dentro de Quality Central para darles «prioridad».

TMapView always on top of other controls

https://quality.embarcadero.com/browse/RSP-10707

El primero (no es grave) afecta al componente TMapView y al menú de la aplicación. Veréis que al mostrar el menú, se oculta el TMapView y al ocultar el menú de visualiza. No afecta a la funcionalidad, pero queda un poco raro. Es debido a que el componente TMapView queda «por encima» del TMultiview y lo tapa.

Problema al borrar objetos del TMapView

https://quality.embarcadero.com/browse/RSP-10364

El segundo (un poco más importante) afecta a cómo se obtienen los objetos de un Mapa, por ejemplo para borrarlos. En el caso de TMapPolyline y TMapPoligon, al ejecutar el método Remove, se obtiene una excepción (Invalid TypeCast). De ahí que la animación de la polilínea del ejemplo, realmente se haga ocultando una y creando nuevas, cuando sólo se debería utilizar un sólo objeto, para preservar la memoria.

Os adjunto el código fuente del programa

<CODIGO FUENTE DEL PROYECTO>

Y hasta aquí todo lo que hemos visto. Espero que haya sido útil.
Como siempre cualquier comentario, sugerencia, aclaración,… será bienvenida.

Hasta la próxima.

Vota este post
Subscribe
Notify of
guest

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.

44 Comments
Inline Feedbacks
Ver todos los comentarios
Casimiro
Casimiro
7 years ago

¿De dónde sacas el tiempo? :o
Impresionante.
Saludos.

Agustí
Agustí
7 years ago

Antes que nada felicitarte por tu web, es sencillamente magnífica. Una gozada poder aprender de una forma tan didáctica. Como sugerencia, para cuando algo de mapas a través de SERVICIO WEB DE MAPAS (WMS). Creo que podría resultar muy interesante. Espero que no te moleste la sugerencia. Sea como sea, enhorabuena por todo otra vez.

Mystery
Mystery
7 years ago

Hola German el articulo esta muy Bueno pero que sucede….
Necesito algo más sencillo, pero bueno estoy asimilando ahora mismo todos estos componentes de las nuevas versiones de Delphi…
Yo necesito algo más sencillo solo quisiera cargar un ShapeFile en este componente (MapView) ya después veré como utilizo estas cosas que publicas para dibujar en las rutas y otras cosas…
Bueno discúlpame que trate de robarte tiempo en estos asuntos, pero agradecería mucho que me iluminaras con estas cosas…
Muchas gracias
Salu2…

Mystery
Mystery
7 years ago

Ok lo descargo y lo veo… muchas gracias, UD siempre tan atento…

Mystery
Mystery
7 years ago

Hola Neftalí me parece que los enlaces al código fuente ya no existen… OK.
Muchas gracias de cualquier forma…
bueno salu2

Bertifox
Bertifox
7 years ago

Hola, primero felicitarte por tu muy buen aporte, necesito conectar la rotación del mapa al sensor de orientación, para esto utilízo lo siguiente:

MapView1.Bearing:=Trunc(OrientationSensor1.Sensor.HeadingX);

Pero no logro el resultado requerido, me puedes dar una pista?.

Gracias

Bertifox
Bertifox
7 years ago

Gracias Germán, me queda claro, en cuanto encuentre como hacer la conversión la publico aquí.

Bertifox
Bertifox
7 years ago

Hola Germán, te cuento que encontré por unas formulas y las lleve a instrucciones Delphi:
if (y>0) Then
iGrados:=trunc(90 – arctan2(x,y)*180 / pi)
else
if (y<0) then
iGrados:= trunc(270 – arctan2(x,y)*180 / pi)

Lo probé pero esto no funciona. Lo que realmente quiero lograr es girar el mapa MapView con :
MapView1.Bearing:=iGrados;

Buscando encontré que TLocationSensor, además de Latitud, Longuitud entrega TCustomLocationSensor.TProperty.TrueHeading y TCustomLocationSensor.TProperty.Speed
pero no logro obtener los valores de estas variables. Me puedes dar una pista donde encontrar un ejemplo simple, ya revise el ejemplo sensorinfo, pero esta muy complejo ya que éste sirve para todos los sensores presentes en el movil.

Saludos

Bertifox
Bertifox
7 years ago

Hola Germán, estoy de visita nuevamente, en esta ocasión es para plantearte la necesidad de cargar las marcas desde una base de datos, actualmente cargo la totalidad de marcas existentes en la tabla de una BD MySql, pero me gustaría cargar solo aquellas que están situadas en el área visible en la pantalla, el fin de esto es acotar el query de tal forma de cargar las marcas que van a ser visibles en el área del mapa que se esta visualizando, para esto necesito determinar la longitud y latitud del extremo superior izquierdo y del extremo inferior derecho. No se si fui claro en el planteamiento.

Saludos

Comandant
Comandant
7 years ago

Hola man desde hace mucho que no uso delphi siempre sobresaliste en club delphi y bueno ahora ando de vuelta solo que bueno me quede en el xe. Mi duda es respecto a la variable ico del market, precisamente en el procedimiento getbitmap en tam: TSize, que lo que no entiendo si es una constante o es un valor relativo al tamaño de la pantalla. Gracias man saludos

Comandant
Comandant
7 years ago

Hola Neftali solo a modo contribucion nose poque pero en delphi XE8 si pongo como pusiste

procedure TFormMain.lbiMarcasClick(Sender: TObject);
var
  MarcaMapa:TMapMarker;
...
begin
  // Posicion
  posicion := TMapCoordinate.Create(LAT_SAGRADA_FAMILIA, 
      LON_SAGRADA_FAMILIA);
  // Crear Marker
  descMarca := TMapMarkerDescriptor.Create(posicion);
  descMarca.Icon := GetBitmap('imgMarca');
  descMarca.Draggable := False;
  descMarca.Opacity := 0.8;
  descMarca.Snippet := 'Antonio Gaudí 1882';
  descMarca.Title := 'Sagrada familia';
 
  // Añadirla
  MarcaMapa := MapView1.AddMarker(descMarca);
  // Centrar el mapa en ese punto
  MapView1.Location := posicion;

Se me sale la aplicacion al cargar el bitmap ico ahora si pongo la variable posicion antes osea

posicion := TMapCoordinate.Create(LAT_SAGRADA_FAMILIA, 
   LON_SAGRADA_FAMILIA);
MapView1.Location := posicion;

carga correctamente todo, no veo la relacion pero pienso que es un problema de conversion al codigo java.
Hay una cosa mas yo en vez de crear la variable MarcaMapa hice asi

  // Añadirla
  MapView1.AddMarker(DescMarca);

Muchas gracias man por tu trabajo me diste un empujoncito y sigo viendo que tal anda el componente

NOTA (Germán): He añadido las etiquetas al código parta que se visualice mejor.

Mystery
Mystery
7 years ago

Hola Germán…
Bueno muchas gracias por la ayuda… realmente no había visto tu respuesta, he estado un poco complicado con algunos asuntos y bueno lamento mucho la demora de mi respuesta.
ya lo descargué. muchas gracias
reviso y te cuento, sin mas
Mystery

Ignacio
Ignacio
7 years ago

Germán buen día, antes que nada muchas gracias por compartir tus conocimientos con la comunidad. Estoy tratando de desarrollar una pequeña aplicación para Android con Delphi 10.1 Berlín, quiero implementar la búsqueda de lugares cercanos usando Google Places API for Android, pero la verdad no se si se pueda implementar en un proyecto de Delphi, ¿hay alguna manera de hacerlo?. De antemano muchas gracias.

Ignacio
Ignacio
6 years ago

@Germán Estévez
No te preocupes, intentaré lo que me comentas y muchas gracias por tomarte el tiempo de responder. Saludos.

Asiel
Asiel
6 years ago

De excelente ayuda este material Neftalí. Me gustaría ver si en algún momento pudieras comentarnos acerca de Static Maps API.

Fernando
Fernando
6 years ago

Hola Germán excelente explicación sobre esta herramienta, sácame una duda mi amigo pf, como agrego la opción lugares cercanos, y la segunda seria indicar una ruta desde mi ubicación hacia un destino determinado en un textbox. Saludos y Exitos.!!

Tiago
Tiago
6 years ago

Es un placer hablar contigo, que lleva tanto conocimiento, necesito preguntarte algo, si es posible extraer las coordenadas Latitud y Longitud del local actual del usuario, del propio mapview, sin utilizar otros sensores … espero una respuesta, si puedes me responda por e-mail o zap, sigue numero … 55 16 99714-5996

55 – Brasil
16 – Sao Paulo
99714-5996 – Vivo Zap

desde ya gracias y hasta más

Tiago

EDWARD
EDWARD
6 years ago

Hola a todos, es un verdadero placer compartir con ustedes.

@Germán Estévez eres un prodigio en esto. He estado analizando tu programa y veo que se puede hacer lo que dice @Tiago definiendo una variabla Tposicion.

y muchas gracias a @Comandant por su gran aporte, me ayudo bastante.

EDWARD
EDWARD
6 years ago

EDWARD :
Hola a todos, es un verdadero placer compartir con ustedes.
@Germán Estévez eres un prodigio en esto. He estado analizando tu programa y veo que se puede hacer lo que dice @Tiago definiendo una variabla Tposicion.
y muchas gracias a @Comandant por su gran aporte, me ayudo bastante.

Corrijo mi error de información.
Hay que declarar la una variable TMapCoordinate, con esta podrás obtener la Longitud y Latitud.

EDWARD
EDWARD
6 years ago

@Germán Estévez estoy haciendo un proyecto y Tengo muchas preguntas que hacerte sobre Delphi y el componente TMapView, pero no quiero abusar, así que solo preguntare(por ahora) sobre los problemas del TMapView.

Se han solucionado algunos de esos problemas ya?
Estoy usando Embarcadero XE8.

EDWARD
EDWARD
6 years ago

Hola otra vez.

Germán, te comente que solucione el problema del MultiView usando la propiedad Margin del TmapView.

También te quiero comentar que debido a las limitaciones que tiene el componente TmapView descargue componente externo TMSFMXWebGMaps de la pagina http://www.tmssoftware.com y es realmente una chuleria. Te invito a que le des un vistazo.

Gracias nuevamente por tus aportes y os dejo saber cualquier avance.

mdsf
mdsf
5 years ago

Nice tutorial! Thank you!

But after that… How to remove/delete all markers (polylines, polygones)?

Héctor Alberto Vargas de la Llatta
Héctor Alberto Vargas de la Llatta
4 years ago

Me gustaria ver este ejemplo en tu codigo completo, lo tendras disponible y en que liga??

saludos y Gracias.

Ruben Martinez
Ruben Martinez
3 years ago

Buenas Tardes, Una Ayuda por favor, Estoy empezando a programar en android con rad studio 10.3.
Soy Autodidacta, estoy aprendiendo a usar el componente TMAPVIEW, estoy siguiendo las indicaciones que explicas e incluso las de embarcadero. Y la aplicación en el emulador NOX me funciona correctamente. Unicamente es una pantalla con el componente tmapview. No tiene nada mas.

He introducido los permisos de maps service, introducido la api key(En el emulador me funciona).
Pero en cuanto lo instalo en el movil y lo ejecuto, la aplicación se sale. Es un samsung galaxy a40, con android 10. Estoy totalmente perdido. os agraceceria si podeis ayudarme. Muchass Graciasss

Angel Almonte
Angel Almonte
3 years ago

Buenos dias, aun hay soporte?

quisiera apoyo para saber como puedo cambiar de color el marker.
y como puedo hacer que al dar un LongClick me muestre y/u obtenga las cocoordenadas de
donde le di click exactamente en el mapview}
Espero puedan apoyarme con esto :(

44
0
Would love your thoughts, please comment.x
()
x