Bots de conversa de Telegram amb Google Apps Script

Crear mapes

Els mapes són imatges que contenen un mapa de Google sobre el que podem indicar punts, línies i àrees. Hi ha diverses comandes per fer tot això. A continuació en comentem algunes. També hi ha possibilitat de treballar amb adreces i coordenades o d'incorporar rutes als mapes, que veurem més avall. Es pot trobar informació completa al web de Google.

La comanda per crear un mapa és:

Les comandes per ajustar el que es veu al mapa són:

Convé indicar les adreces amb un cert nivell de detall. Per exemple, si posem ETSEIB és probable que encertem però si posem FIB segurament no es considerarà la Facultat d'Informàtica de Barcelona sinó una adreça als Estats Units. Sempre és millor fer servir les adreces però també convé que estiguin ben especificades ja que hi ha poblacions amb el mateix nom o amb noms semblants en diferents llocs. Convé, doncs, indicar el codi posatal o el país. Amb les coordenades, si no ens equivoquem, encertarem segur.

Per passar d'adreça a coordenades, o al contrari, podem fer servir un objecte de geolocalització.

Les comandes per marcar punts al mapa són:

Les mides disponibles per als marcadors són:

Els colors disponibles per als marcadors són:

Les comandes per dibuixar línies o àrees al mapa són:

Atenció: Aquestes comandes dibuixen línies rectes i polígons però no rutes per anar d'un punt a un altre.

Les comandes per obtenir la imatge del mapa són:

En aquest exemple mostrem com crear la imatge en format de dades binàries (BLOB), enviar-la a Telegram i generar un fitxer d'imatge o un fitxer pdf.

Adreces i coordenades

Tenim funcions per poder obtenir les coordenades aproximades a partir d'una adreça o l'adreça que correspon a unes coordenades concretes.

Les dues funcions poden retornar tres dades:

Les dades obtingudes seran les més properes que estiguin identificades.

La resposta pot ser múltiple i, per tant, les funcions retornen un vector. Cal, doncs, preveure consultar totes les respostes (o bé preveure que la primera és la que ens interessa).

var lat = 41.384411;
var long = 2.116264;
function adreces(){
  var response = Maps.newGeocoder().reverseGeocode(lat, long);
  for (let i = 0; i < response.results.length; i++) {
    const result = response.results[i];
    Logger.log(result.formatted_address);
    Logger.log(result.geometry.location.lat + ", " + result.geometry.location.lng);
  }
}

var adre = "diagonal, 647, 08028 Barcelona";
var coord = Maps.newGeocoder().geocode(adre);
function coordenades(){
  for (let i = 0; i < coord.results.length; i++) {
    const result = coord.results[i];
    Logger.log(result.formatted_address);
    Logger.log(result.geometry.location.lat + ", " + result.geometry.location.lng);
  }
}

Incorporar rutes als mapes

Les rutes ens mostren el camí a seguir per anar d'un lloc a un altre. A les rutes es poden forçar punts de pas (etapes o escales) intermedis. Entre cada dos punts tenim una pota de la ruta, hi ha una pota menys que punts definits. A més de les comandes que hem comentat més amunt, per mostrar rutes tenim les comandes del cercador de rutes, les de gestió de les rutes i les corresponents a les potes de cada ruta. A continuació en comentem algunes. Es pot trobar informació completa al web de Google.

Les comandes del cercador de rutes són:

Les comandes de gestió de les rutes són:

Les comandes per a les potes de cada ruta són:

En aquest exemple mostrem com crear mapes que incorporen rutes.

Aquesta obra d'Oriol Boix està llicenciada sota una llicència no importada Reconeixement-NoComercial-SenseObraDerivada 3.0.