QWERTY LTDA

Es una conexión que permite la generación de minimapas estáticos de localidades colombianas basada en la información de OpenStreetmap.org, el api puede devolver información en varios formatos conforme a la petición hecha

1 Parámetros

Para ser llamada la api se necesita invocar los siguientes parámetros separados por comas o por barras “/ ” cuando queda algún parametro vacio es mejor usar las comas “,” como separadores: https://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,html

1.1 URL

La pimera parte es la URL de la api: https://qwerty.co/api/geocol/

1.2 Municipio

El segundo parámetro se refiere al municipio que se desea consultar: https://qwerty.co/api/geocol/libano/

1.3 Departamento

El tercer parametro es el departamento a que pertenece dicho municipio: https://qwerty.co/api/geocol/libano/tolima/

1.4 Centro poblado

Como cuarto parámetro se puede pasar el nombre de un centro poblado o hito geográfico para precisar la ubicación: https://qwerty.co/api/geocol/libano/tolima/marcada

1.5 Ancho de la Imágen

Por el quinto parámetro se puede pasar el ancho de la imagen para el caso de la respuesta img o html por omisión este valor es igual a 500 pixeles: https://qwerty.co/api/geocol/libano/tolima/marcada,300

1.6 Alto de la imágen

El sexto parmetro es la altura de la imagen para las espuestas html e img, por omisión este valor es de 200 pixeles: https://qwerty.co/api/geocol/libano/tolima/marcada,300,300

1.7 Zoom o escala

el séptimo parámetro es el zoom o la escala en un valor entero de 1 a 18, según la especificación de OSM (ver Link) : https://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12

https://wiki.openstreetmap.org/wiki/ES:FAQ#.C2.BFCu.C3.A1l_es_la_escala_cartogr.C3.A1fica_para_un_nivel_de_zoom_particular_del_mapa.3F

1.8 Respuesta

El octavo parámetro es la forma en que deseamos que sea devuelta la información básicamente la api devuelve tres tipos de respuestas:

1.8.1 html

Por defecto devuelve codigo HTML con la imágen del mapa y datos de su localización y código DANE o divipola, tambien un link para ampliar la presentación del mapa directamente en la web de OpenStreetMap.org

<img src=”https://dev.openstreetmap.de/staticmap/staticmap.php?center=4.892335561,-75.070536605&zoom=12&size=300×300&maptype=mapnik&markers=4.892335561,-75.070536605,red-pushpin” alt=’ Líbano,TOLIMA,La Marcada [ lat: 4.892335561 Lon: -75.070536605 ] Codigo DANE divipola: 73411′ title=’ Líbano,TOLIMA,La Marcada [ lat: 4.892335561 Lon: -75.070536605 ] Codigo DANE divipola: 73411’/> <br><font size=’-2′> Líbano,TOLIMA,La Marcada [ lat: 4.892335561 Lon: -75.070536605 ] Codigo DANE divipola: 73411</font> <a href=’https://www.openstreetmap.org/?mlat=4.892335561&mlon=-75.070536605&zoom=12&layers=B000FTF’ target=’map’>Ampliar mapa</a>

https://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,html

Lo cual se mostrará como :

Líbano,TOLIMA,La Marcada
[ lat: 4.892335561 Lon: -75.070536605 ]
Codigo DANE divipola: 73411 Ampliar mapa

1.8.2 img

Devuelve una URI de para ser incluida en una etiqueta <IMG> de HTML, puede ser usada de la siguiente manera: <img src=’https://localhost/api/geocol/libano/tolima/convenio/500,100,8′>

https://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,img

1.8.3 json

Regresa un objeto JSON que puede ser recorrido o leido desde una aplicación foránea del tipo:

{LAT:4.892335561,LON: -75.070536605, DEPARTAMENTO: TOLIMA , MUNICIPIO: Líbano, PUNTO: La Marcada, CODIGO_DANE: 73411,MAPA:https://dev.openstreetmap.de/staticmap/staticmap.php?center=4.892335561,-75.070536605&zoom=12&size=300×300&maptype=mapnik&markers=4.892335561,-75.070536605,red-pushpin}

https://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,json

2 Permiso de uso

En la presente etapa beta, se permite su uso con fines personales y humanitarios, para usos comerciales por favor comuniquese con correo@qwerty.com.co para solicitar un permiso especial.

3 Contacto
Las sugerencias y observaciones serán bien recibidas por el desarrollador: fredyrivera@qwerty.com.co