API Google Maps y Visual Basic.NET. Parte VIII. Calcular ruta.

En esta nueva entrada vamos a adentrarnos un poco más en el API de Google Maps y vamos a ver cómo calcular una ruta para que podamos extraer la información del tiempo de recorrido, indicaciones, etc. Lo primero que hay que tener claro es cómo trabaja el API de Google Maps y cómo se hacen las peticiones HTTP para poder extraer la información (en este caso en formato XML), si esto no lo tienes muy claro, te recomiendo echar un vistazo a alguna de las entradas en las que se ha tratado esto (recomiendo esta).

Como hemos visto, de lo que se trata es de hacer un petición mediante una URL y ésta nos mostrará la información en formato XML y será de ahí de donde se extraerán todos los datos. Sin más dilación, voy a mostrar un ejemplo de una petición para una ruta en coche (sin restricción en cuanto a carreteras) de Madrid a Barcelona:

https://maps.googleapis.com/maps/api/directions/xml?&origin=madrid&destination=Barcelona&mode=driving&language=es&region=es&sensor=false

API Google Maps y Visual Basic.NET. Parte VI. Buscar código postal.

En esta entrada vamos a explicar de forma breve cómo buscar un código postal a partir de una localización. Realmente no se va a ver nada nuevo, ya que esta información se extrae a través de una petición de codificación geográfica, que ha sido explicada en otra entrada.
Como se puede observar al hacer la petición, hay un campo en el que se incluye el código postal. Este campo está localizado en una etiqueta denominada postal_code que se encuentra dentro de otra etiqueta llamada address_component.
Petición: http://maps.googleapis.com/maps/api/geocode/xml?address=Puerta%20del%20Sol,%20Madrid&region=es&sensor=false&language=es

Código postal en archivo XML

API Google Maps y Visual Basic.NET. Parte V. Elevación de una localización.

Retomando un poco el API de Google Maps, y después de haber visto cómo obtener la latitud y longitud a partir de una determinada dirección (codificación geográfica), o cómo mostrar una localización en un mapa (I y II), el siguiente paso es, utilizando lo anterior, obtener la altitud de un punto en concreto.

El primer paso para obtener la altitud de un lugar es determinar de qué lugar queremos obtenerla. En este caso, para poder obtener la altitud de un punto en concreto debe saberse su latitud y longitud, por lo que vamos a aprovechar la entrada en la que explicábamos cómo determinar la latitud/longitud un lugar, a partir de su dirección (lo que se llama codificación geográfica).

Lo primero que vamos a explicar es la solicitud HTTP que tenemos que crear y nada mejor que ver un ejemplo:

http://maps.googleapis.com/maps/api/elevation/xml?locations=40.4167522,-3.7033701&sensor=false

Como se puede observar, hay pocos parámetros que incluir. A continuación los enumeramos:

Parte I. Crear documentación XML en Visual Basic .NET

En este minitutorial vamos a ver los principios básicos para documentar nuestro código fuente para que así Visual Studio nos muestre la información en IntelliSense.

Cuando estamos programando qué útil es IntelliSense explicándonos cómo funcionan las funciones, propiedades, etc., y sus correspondientes parámetros, pero, ¿cómo podemos hacerlo nosotros en nuestro código? Pues de una forma muy sencilla e intuitiva.

Ejemplo IntelliSense

Primero vamos a empezar creando una clase la cual vamos a documentar. Para ello, en primer lugar creamos un nuevo proyecto y a ese nuevo proyecto (en principio será únicamente un formulario) le vamos a añadir una clase a la que llamaremos ClaseMostrarFormulario. El funcionamiento de esta clase es trivial, simplemente está compuesta por una serie de propiedades y un método. Las propiedades son para dar tamaño, color, texto y el tiempo que va a mostrar el formulario y tiene un método que hará que se muestre el formulario. El código de la clase es el siguiente.