Obtener datos metereológicos con la API REST de openweathermap


En este post vamos a aplicar lo que hemos visto anteriormente sobre el tratamiento de las llamadas a APIs, en concreto vamos a practicar usando la API de openweathermap  

Inicialmente necesitamos obtener el API-KEY,  que se obtiene desde la propia página en función del tipo de servicio se necesite, en nuestro caso para hacer pruebas, con el servicio FREE es suficiente, ya que nos permite hacer 60 llamadas a la API por minuto y 1000000 al mes.

Aquí tienen los precios de los diferentes servicios que ofrece.

Una vez que tenemos el token (es algo parecido a esto: 23ab82b1ca4fab6783902accd6fb783a63) abrimos nuestra plataforma de desarrollo de aplicaciones de confianza Delphi 10.4.2

Abrimos la aplicación Rest Debugger, desde el menú Tools - Rest Debugger y en la caja de texto URL, escribimos:
http://api.openweathermap.org/data/2.5/weather?lat=40.4167&lon=-3.70325&APPID=<API-KEY> (sustituyendo <API-KEY> por la que han obtenido de la página web)
y en la caja "Content-Type" seleccionamos la opción application/json

Pulsamos el botón SEND REQUEST, esperamos unos segundos para recibir una respuesta del servidor y pulsamos a continuación el botón COPY COMPONENTS

Después vamos al form de nuestra aplicación y pulsamos Ctrl+V para pegar los componentes RESTClient, RESTResponse y RESTRequest.

Todo esto está explicado con detalle en el post: "Utilizar los componentes REST con Delphi"

El siguiente paso es extraer la información del JSON que nos devuelve el servidor de los campos "main" y "weather" (hay más pero para este ejemplo es suficiente)

{
    "coord": {
        "lon": -3.7923,
        "lat": 40.4587
    },
    "weather": [
        {
            "id": 800,
            "main": "Clear",
            "description": "clear sky",
            "icon": "01n"
        }
    ],
    "base": "stations",
    "main": {
        "temp": 304.73,
        "feels_like": 302.85,
        "temp_min": 300.24,
        "temp_max": 307.74,
        "pressure": 1018,
        "humidity": 22
    },
    "visibility": 10000,
    "wind": {
        "speed": 7.6,
        "deg": 23,
        "gust": 9.39
    },
    "clouds": {
        "all": 0
    },
    "dt": 1629142067,
    "sys": {
        "type": 2,
        "id": 2007545,
        "country": "ES",
        "sunrise": 1629091608,
        "sunset": 1629141097
    },
    "timezone": 7200,
    "id": 6544494,
    "name": "Madrid City Center",
    "cod": 200
}

----

 Para extraer la información de dichos campos hay que seguir los pasos del post:

"Programa complejo resuelto con una línea de código en Delphi"

Añadiendo un RESTResponseDataSetAdapter, FDMemTable, BindsourceDB y BindingsList 

Al final en el LiveBindings Designer  tendría que aparecer lo siguiente:

Como ven los campos main y weather se vinculan a los componentes Edit1.Text y Edit2.Text (hacer todo lo anterior no se tarda más de 5 minutos)

Añadimos un componente tButton (INICIAR) y escribimos dentro del evento onclick del Botón:  

         

PROCEDURE TForm1.Button1Click(Sender: TObject);
BEGIN

	RESTRequest1.Execute;

END;

Ejecutamos el programa pulsando el botón INICIAR

Vemos que nos ha devuelto en la caja Edit1

[{"id":800,"main":"Clear","description":"clear sky","icon":"01d"}]

y en la caja Edit2

{"temp":307.92,"feels_like":305.57,"temp_min":303.57,"temp_max":310.28,"pressure":1017,"humidity":16}

Para que sea un poco mas manejable la información, he creado un procedimiento llamado "GetData" para que al final quede la información de esta forma

id=800
main=Clear
description=clearsky
icon=01n
temp=303.53
feels_like=301.82
temp_min=299.13
temp_max=304.97
pressure=1018
humidity=23
El procedimiento GetData es el siguiente:
Procedure TForm1.GetData(texto: STRING);
VAR
  i: integer;
  aux: STRING;
  datos: TStringDynArray;
BEGIN
  aux := texto;
  FOR i := LOW(texto) TO HIGH(texto) DO
  BEGIN
    IF (ansipos(aux[i], '{}[]"')) > 0 THEN
      aux[i] := ' ';
  END;
  aux := stringreplace(aux, ' ', '', [rfreplaceAll]);
  datos := SplitString(aux, ',');
  FOR i := 0 TO length(datos) - 1 DO
  BEGIN
    datos[i] := stringreplace(datos[i], ':', '=', [rfreplaceAll]);
    Memo1.lines.add(datos[i]);
  END;
END;

--- 

Y este es el resultado:


Si lo quieren probar, recuerden que tienen que añadir el API-KEY en la propiedad "BaseURL" del componente RESTClient1, si no lo hacen dará el error "FDMemTable:Field main not found"

Descarga del programa

Si quieren saber más sobre desarrollo de API REST pueden consultar este post de Marco Cantú en el que habla de la web apilayer.com, una web que ofrece microservicios basados en API.


Evento solidario para ayudar a Jhonny Suarez

Abatic, empresa dedicada a la consultoría, formación y desarrollo de software ha convocado el primer "Delphi meet", encuentro de desarrolladores Delphi, que consiste en una reunión virtual a través de la plataforma Zoom, en la que se debaten temas relacionados con la tecnología.

La próxima reunión del 7 de Octubre a las 15:30 Hora de Madrid / España tendrá un carácter solidario, ya que todos los beneficios irán destinados a la familia de Jhonny Suarez, que se encuentra actualmente en un delicado estado de salud provocado por el COVID y por otra enfermedad respiratoria que tenía anteriormente.

Jhonny Suarez es creador y fundador del podcast "No sólo Delphi".

Espero Johnny que te mejores pronto y puedas seguir brindándonos la oportunidad de seguir escuchándote y desarrollando tu labor como programador y divulgador.

El contenido de este evento será el siguiente:

  • Sesión inicial de 30 minutos por parte de Emilio Pérez
  • 2’5 horas de Preguntas y Respuestas relacionadas con el mundo Delphi donde iremos respondiendo entre todos los asistentes y tendrá como moderador a Emilio Pérez.
  • Podrás participar activamente y en directo con el resto de compañeros de la comunidad Delphi.
  • Tendrás acceso al vídeo del directo para poder verlo las veces que necesites
  • Cupón de descuento del 75% para la academia online TodoPostgreSQL
  • Cupón de descuento del 100% para la academia online No Solo Delphi
  • Podrás aportarnos tu cupón que lo incluiremos en este curso y así más programadores Delphi podrán conocerte y tener un buen descuento en tus productos/servicios

Para los que quieran inscribirse y hacer una donación a la familia de Jhonny pueden hacerlo desde aquí.

Si quieren conocerle un poco más, aquí tienen el enlace a su página en Linkedin.



Programa complejo resuelto con una línea de código en Delphi

Partimos del supuesto que recibimos el encargo de realizar un programa en Delphi que debe hacer una llamada a una API, la cual nos devuelve un resultado en formato JSON, con 1000 campos, pero sólo queremos visualizar 3 de ellos (URL, TITLE, EXPLANATION) en el formulario de presentación al cliente.

¿Cómo hacemos esto de una forma visual en Delphi?, pues a continuación les explico detalladamente los pasos a seguir:


Añadimos un componente tRestResponseDataSetAdapter, un tFDMemTable y para hacer pruebas un tStringGrid, que nos mostrará todo el conjunto de datos

En la propiedad "Dataset" del tRestResponseDataSetAdapter seleccionamos FDMemTable1 y en "Response" selecciono "RESTResponse1"

Con el botón derecho del ratón pulsamos sobre el componente FDMemtable1 y seleccionamos AddBindSource, con lo se creará otro componente llamado "BindSourceDB1"

Volvemos a pulsar con el botón derecho del ratón sobre FDMemTable1 y seleccionamos Bind Visually... y se abrirá una nueva ventana llamada "LiveBindings Designer" 


 Si vinculamos FDmemTable1 con el componente StringGrid1, uniendo con el ratón los campos marcados con un asterisco, de esta forma:


al iniciar el programa llamando a "Execute", de esta forma:

PROCEDURE TFORM1.INICIO;
BEGIN
	RESTRequest1.Execute;
END;

veremos que los 1000 campos que nos ha devuelto la API se ven el Grid, que no es lo queremos en este caso, ya que únicamente necesitamos que se muestren en pantalla 3 de ellos, entonces ¿cómo se hace esto?, pues gracias al componente tBindingsList    ¡Este es el truco de magia!

1) Hacemos doble clic sobre el componente BindingsList1


(que se habrá creado al hacer la vinculación anterior)

 


 2) Sobre el apartado Bind Components hacemos clic con el botón derecho y seleccionamos la opción "New LinkControlToField1" y hacemos clic sobre esa nueva línea que se habrá creado para ver las propiedades en el Inspector de Objetos.


 

Allí en la propiedad "DataSource" seleccionamos "BindSourceDB1"  y en "FieldName" escribimos "Title" (es uno de los campos que nos interesa visualizar)


Cerramos la ventana de Edición del BindingsList y Actualizamos la ventana "LiveBindings Designer" haciendo clic con el botón derecho del ratón y activando el menú "Refresh Designer" y veremos que se ha creado un nuevo ítem "Title (Invalid)", lo de Invalid me imagino que es por que el dataset está cerrado en la fase de diseño.

y hacemos lo mismo para los otros dos campos.
Después sólo queda vincular los ítems "Title (invalid), url (invalid) y explanation (invalid)" a los componentes tEdit-Text, uniendo con el ratón los campos anteriores con el campo "Text", tal como se muestra en la imagen:

 

Eliminamos el componente "StringGrid1"

Y eso es todo, ahora al ejecutar el programa

PROCEDURE TFORM1.INICIO;
BEGIN
	RESTRequest1.Execute;
END;
 

Veríamos el resultado que nos interesa, lo que se traduce en una mayor rapidez de ejecución del programa, ya que nos ahorramos procesar 997 campos, de los 1000 que devuelve la API.


Además, como han podido ver, todo se ha hecho de forma visual con sólo 1 línea de código, simplemente asombroso y es que además este mismo programa funciona en Android, IOS, Linux y Windows y la portabilidad es instantánea.

¿A que merece la pena pasarse a Delphi?