Java Maps

Java: API Google Maps para Java
En esta ocasión, os voy a mostrar una serie de clases que he desarrollado para manejar de forma sencilla el API de Google Maps con Java. En concreto, vamos a ver 3 productos, un archivo .jar(denominado MapsJava.jar ) que contendrá las clases mencionadas, un ejemplo sencillo por consola (denominado MapsJava_EjemploFacil ), y un ejemplo más completo y visual deutilización de estas clases (denominado Maps.JAVA ). Empezamos:


Índice de la entrada
1. Clases MapsJava
1. MapsJava
2. Geocoding
3. Elevation
4. StaticMaps
5. StreetView
6. ShowMaps
7. Route
8. Places
2. Límites de uso
3. Ejemplo básico
4. Ejemplo avanzado
5. Resumen y descargas
1. Clases MapsJava
El archivo .jar, como decimos se llama MapsJava.jar y lo podéis descargar desde aquí . Este conjunto declases está totalmente documentado en castellano (eso sí, el nombre de las funciones está en mi inglés tejano ) y se compone de las siguientes clases:
Clase padre: MapsJava
Clases hijas: Elevation, Geocoding, Places, Route, ShowMaps, StaticMaps y StreetView.

1.1. MapsJava
Es la clase de la cual se derivan el resto y contiene una serie de funciones y propiedades (estáticas) principalmente paralas diferentes opciones a la hora de realizar las peticiones al API Google Maps (sensor, idioma, etc.) y un seguimiento del estado de cada petición.

PROPIEDADES (lectura/escritura):
String Region (getRegion/setRegion): comprueba/establece las regiones de búsqueda de los diferentes resultados. Sirve principalmente, para que dé prioridad a resultados de la región seleccionada, es decir, si buscamosla ciudad de León habiendo puesto como región España (“es”), el primer resultado será de León (España), en cambio, si ponemos como región México (“mx”), nos aparece como primer resultado la ciudad de León (México). La región predeterminada es España (“es”). Para más información sobre los diferentes tipos de regiones, haz clic aquí .
String Language (getLanguage/setLanguage): comprueba/establece elidioma en el que se mostrarán los resultados de las búsquedas. El idioma predeterminado es español (“es”). Para más información sobre los diferentes idiomas, haz clic aquí .
Boolean Sensor (getSensor/setSensor): comprueba/estable el uso o no uso de un sensor GPS (GNSS) en las peticiones para obtener ubicación. De forma predeterminada es false.
String Key (getKey/setKey): comprueba/establece el usode clave de desarrollador API Google Maps. Esta clave únicamente es necesaria para la petición de locales (Places). De forma predeterminada no hay clave (String vacío). Para más información de cómo obtener clave (es gratuita), pulsa aquí .

PROPIEDADES (sólo lectura):
String getLastRequestStatus: en esta propiedad se indica el estado de la última petición realizada. En caso de que no haya surgidoningún imprevisto será “OK”.
String getLastRequestURL: en esta propiedad se indica la URL de la última petición realizada. Un ejemplo sería, “ttp://maps.google.com/maps/api/geocode/xml?address=Madrid%2C+Puerta+del+Sol®ion=es&language=es&sensor=false”
String getLastRequestInfo: en esta propiedad se indica información referente de qué tipo de servicio ha realizado la última petición. Un ejemplosería, “Geocoding request”.
String getLastRequestException: en esta propiedad se indica si en la última petición ha habido excepciones. En caso de que todos haya sido correcto, el resultado sería “No exception”.
String[] getLastRequestRequest: en esta propiedad se muestra toda la información de la última petición realizada. En concreto es un vector con 6 posiciones, con el siguiente orden:[0]="Número de petición"; [1]="Fecha/hora petición"; [2]="status de la petición";
[3]="URL de la petición"; [4]="Información sobre petición realizada"; [5]="Excepciones generadas";
[][]String getStockRequest: esta propiedad es exactamente igual que la anterior, pero en vez de almacenar únicamente la última petición, muestra información de todas las peticiones realizadas. En concreto se compone de dos...