miércoles, 7 de julio de 2010

Api para la presentación de minimapas de localidades de Colombia basada en OpenStreetMap.org


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

http://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="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>


http://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

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,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

1 comentario:

Luis Hache dijo...

Como siempre, excelente trabajo. Una pregunta ¿es posible añadir diferentes "punteros" en una misma imágen?

Muchas gracias, y excelente desarrollo!