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: http://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,html
1.1 URL
La pimera parte es la URL de la api: http://qwerty.co/api/geocol/
1.2 Municipio
El segundo parámetro se refiere al municipio que se desea consultar: http://qwerty.co/api/geocol/libano/
1.3 Departamento
El tercer parametro es el departamento a que pertenece dicho municipio: http://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: http://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: http://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: http://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) : http://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12
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="http://dev.openstreetmap.de/staticmap/staticmap.php?center=4.892335561,-75.070536605&zoom=12&size=300x300&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='http://www.openstreetmap.org/?mlat=4.892335561&mlon=-75.070536605&zoom=12&layers=B000FTF' target='map'>Ampliar mapa</a>
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='http://localhost/api/geocol/libano/tolima/convenio/500,100,8'>
http://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:http://dev.openstreetmap.de/staticmap/staticmap.php?center=4.892335561,-75.070536605&zoom=12&size=300x300&maptype=mapnik&markers=4.892335561,-75.070536605,red-pushpin}
http://qwerty.co/api/geocol/libano/tolima/marcada,300,300,12,json2 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
