API de Valenbisi (Servicio de JCDeacaux)
19 de julio del 2010 
Escrito por Alex Barros Valenbisi es un servicio que ofrece el ayuntamiento de Valencia de bicicletas públicas, mediante una red de “estaciones” donde coger o dejar una bici.
La web que tienen ( http://www.valenbisi.es ) me parece muy deficiente, por lo que me quiero aventurar a hacer una aplicación simplificada, más 2.0, con la API de Google Maps.
La web de Valenbisi (la empresa encargada es la francesa JCDecaux) no ofrece una API pública, pero no es muy difícil averiguar el sistema que usan para cargar los datos en su web (que es lo que voy a detallar a continuación). Sólo esperemos que no modifiquen esta funcionalidad, que resulta verdaderamente accesible.
Actualización:
Desde la aplicación biciv.com se ofrece una sencilla API que en una sola consulta devuelve los valores actuales de todas las estaciones en formato JSON.
Puedes acceder a este listado en la dirección http://biciv.com/api/stations
Se trata de dos archivos clave, que contienen toda la información en el formato XML:
1: Las estaciones
El primer archivo nos va a dar información de todas las estaciones existentes, junto con información relativa a la localización.
http://www.valenbisi.es/service/carto
Devuelve un archivo similar a este fragmento:
-
<carto>
-
<markers>
-
<marker name="063_AVDA. DEL PUERTO I" number="63" address="AVDA. DEL PUERTO I – Esq. C/Antonio Suarez" fullAddress="AVDA. DEL PUERTO I – Esq. C/Antonio Suarez " lat="39.46755709145644" lng="-0.357891042655049" open="1" bonus="0"/>
-
<marker name="064_AVDA. DEL PUERTO II" number="64" address="AVDA. DEL PUERTO II – Frente a los numeros 61 y 63" fullAddress="AVDA. DEL PUERTO II – Frente a los numeros 61 y 63 " lat="39.46638708872079" lng="-0.353943030206345" open="1" bonus="0"/>
-
<marker name="065_AVDA. DEL PUERTO III" number="65" address="AVDA. DEL PUERTO III – Esquina con Calle Doctor Manuela" fullAddress="AVDA. DEL PUERTO III – Esquina con Calle Doctor Manuela " lat="39.46549608664973" lng="-0.351062021089717" open="1" bonus="0"/>
-
<marker name="066_GUILLEN DE ANGLESOLA" number="66" address="GUILLEN DE ANGLESOLA – Esquina con Avenida del Puerto" fullAddress="GUILLEN DE ANGLESOLA – Esquina con Avenida del Puerto " lat="39.46414708365747" lng="-0.34636900630001" open="1" bonus="0"/>
-
<marker name="067_JUAN VERDEGUER" number="67" address="JUAN VERDEGUER – Esquina con Calle Boters" fullAddress="JUAN VERDEGUER – Esquina con Calle Boters " lat="39.458805068652005" lng="-0.337036975447925" open="0" bonus="1"/>
-
</carto>
Cada marker contiene toda la información de una estación, que son el nombre, el número (este dato es fundamental para el siguiente paso), la dirección, datos cartográficos y si está operativa (la propiedad bonus no he comprendido todavía qué significa)
2: Detalles de la estación
Cuando quieres centrarte en los datos de una estación concreta, debes acudir al siguiente archivo. Se trata de una dirección base a la que debes añadir al final el número de estación que deseas obtener.
http://www.valenbisi.es/service/stationdetails/valence/num_estacion
(donde num_estacion es un número entero correspondiente a una estación.)
Devuelve un archivo como este:
-
<station>
-
<available>14</available>
-
<free>2</free>
-
<total>19</total>
-
<ticket>0</ticket>
-
</station>
Es decir, el número de bicicletas disponibles (avaliable), el número de bornetas disponibles para aparcar (free) el número total de bornetas con que cuenta la estación (total) y si admite la opción de alquiler con tarjeta bancaria (ticket).
A partir de aquí lo único que hace falta es un parser de XML para el lenguaje que estés utilizando, y una conexión a internet, el resto lo pone la imaginación del programador.
Que vivan las APIs!
(Editado: podéis ver mi experimento: bicis disponibles de Valenbisi en http://bicivalencia.com y una versión móvil en http://bicivalencia.com/m)
Categorias: Boozox |
Respeta el copyleft
julio
0:48 calamar Ha dicho:
A ver con qué nos sorprendes. El otro día leí por aquí que habían montado una extensión de chrome con el equivalente de las bicis en Barcelona.
Quise hacer lo mismo pero sabía que alguien lo haría en no mucho tiempo y ahí llegaste tu. Un pin, campeón! En nada me plantan 3 estaciones en mi calle, una en la puerta de casa mismo.
julio
13:26 Alex Barros Ha dicho:
Ya ha sido publicado:
http://bicivalencia.com
julio
9:02 Fernando Ha dicho:
Vaya, vaya, magnífica idea, me encanta.
Se pueden obtener también los ubicaciones no activadas (las que en su mapa están en blanco)?
Y otra cosa, al acceder a la web me ha pedido mi ubicación… es normal?
julio
0:00 Alex Barros Ha dicho:
A través de la API sí, son los Markers con la propiedad open=0
En la web he decidido no ponerlos, porque está pensada para planificar el USO del servicio, y no para ver las que van a abrir. He creído que esta información molestaría al usuario, pero el sistema está preparado para añadir las nuevas estaciones que se van abriendo y mostrar su información.
Lo de que te pidiera tu ubicación era normal, es una característica de algunos navegadores, pero la he deshabilitado porque confundía a mucha gente.
Ahora la primera vez que visitas la web te coloca en un punto predeterminado, pero a partir de entonces siempre recuerda el último punto donde te situaste, característica que no tiene ni la web oficial ni las otras webs similares que conozco (y creo que es algo básico).
Un saludo Fernando, y gracias por tu comentario!
agosto
17:10 Miquel Camps Ha dicho:
excelente alex!
me alegro que sigas programando
un saludo
septiembre
21:59 Vorete Ha dicho:
Genial aplicación. Ya podrían aprender los de la web oficial a hacer las cosas así de bien..por cierto, me alegro que se solucionasen los problemas que te causaron los de valenbisi, de acceso a su web. Me quedo contigo, mas rápido, imposible. Sigue así
septiembre
18:59 Alex Barros Ha dicho:
@Vorete Muchas gracias por tus cumplidos! Y me alegra que te guste mi aplicación.
He de aclarar que los problemas que tenía con JCDecaux siguen ahí, ellos no han desbloqueado el acceso. Lo que he hecho es lo que en inglés se llama “workaround“, básicamente obtener la información por otra vía que no pueden bloquear (al menos no fácilmente).
Espero que en el algún momento razonen, y permitan el acceso desde mi servidor al suyo, porque sería más cómodo que la solución actual. O al menos que mejoren su servicio para que me plantee no hacerles la “competencia” (no entiendo que clase de competencia, ya que no hay lucro en el servicio de información ni por mi parte ni por la suya…)
septiembre
8:34 JAGT Ha dicho:
Buenas Alex.
¿Cómo has conseguido los ficheros XML?
Yo también los descubrí trasteando mucho el código fuente, y me preguntaba si había una forma más sencilla.
Por cierto, tengo entendido que “Bonus” es información sobre si la estación permite pagos con tarjeta bancaria, es decir, vas directo a la estación y alquilas una bici sin necesidad de estar abonado. En caso contrario, sólo es posible coger una bici con el bono de valenbici previamente adquirido.
Un saludo.
septiembre
14:54 Alex Barros Ha dicho:
Lo averigüé gracias a un rastreador. Te sirve Firebug, o en chrome uno que viene por defecto muy similar.
Símplemente revisé los archivos que se cargaban externamente.
octubre
17:42 dave Ha dicho:
El dia 17 DE SEPTIEMBRE hice mi abono a Valenbisi y hoy es 8 DE OCTUBRE! y sigo sin recibir mi puñetera tarjeta….alguien me puede explicar que c*** pasa o tengo que ir a consumo?
INCOMPETENTES
octubre
0:13 Diego Ha dicho:
Alex, gracias a la información que aportas me he podido bajar las estaciones a local y adaptarlas al formato GPX para mi GPS eTrex Vista. Lo he hecho muy para salir del paso, pero ya tengo la base que es lo importante. Muchas gracias. Te mando una copia del fichero tal como está, faltaría poner el tag del NAME y quizás el comentario con la dirección, pero como te he dicho lo que me interesaban eran las coordenadas para orientarme con la bici que he alquilado. Si lo completo lo mandaré por si a alguien más le puede interesar.
octubre
0:33 Diego Ha dicho:
A veces soy un poco burro, he probado un copy paste y supongo que la ensalada de tags se le ha indigestado. Lo subí a Google Docs:
https://docs.google.com/leaf?id=0B5bN1SWOBEdwZTZhNmJhNDEtNjVhZC00YWJiLTlhMGQtODVlYzQxODZhNzc0&hl=es
octubre
0:58 Alex Barros Ha dicho:
Muchas gracias Diego!
octubre
10:54 Danielly Ha dicho:
Hola Dave
Yo hice lo mismo y hasta hoy NADA DE NADA….Todos los días envío un mail (por la web de valenbisi y por mail) haciendo la queja y solicitando mi baja (después puedo hacerlo con la tarjeta mobilis, y eso es mejor ya que en la hora puedo usar las bicis. Me han dicho que me darían un mes más, pero así mismo solicité mi baja….si no tengo nada esa semana me paso en la oficina del consumidor y entro en la lucha por mi derecho
octubre
22:41 Josep Ha dicho:
Se podrian sacar estadisticas de cuales son las estaciones mas usadas, a que horas hay mas transito, … para saber los defectos del servicio e intentar mejorarlo, o por lo menos dejar constancia de los fallos?
noviembre
22:49 Rosa Ha dicho:
Hola,
Yo solicité mi abono el día 3 de septiembre y hoy fecha 5 de noviembre aún no lo he recibido.
En llamado en varias ocasiones, aún hoy me decían que tenía que esperar un poco más, ya van más de dos meses esperando!!!. Finalmente hoy he solicitado mi baja por escrito y mi devolución de los 18 euros. Si el lunes no recibo una respuesta favorable pondré una reclamación en la oficina del consumidor.
Un desastre.
septiembre
10:27 ACICOM Ha dicho:
Nos parece una locura el bloqueo de tus páginas por parte de Decadeux. Todo el mundo dice que para salir de la crisis esta, es necesario apostar por la sociedad del conocimiento y para uno que realiza de manera ingeniosa y altruista una aplicación que mejora la vida de la ciudadania y aporta mejor información que todo el departamento de información de una gran multinacional, se cabrean y cierran la web, en vez de aprender u ofrecerle adquirir su idea y extenderla al resto de ciudades.
Alex nos gustaria contar contigo en nuestra/tuya asociación. Precisamente el dia 28 vamos a celebrar el Dia Internacional del Derecho a Saber .
Desearíamos contactar directamente contigo, haznos llegar un correo o teléfono de contacto.
Un saludo
Jose Ignacio Pastor , Presidente ACICOM
noviembre
4:40 Gonzalo Aranda Ha dicho:
Al final, cómo quedó todo??
Te abrieron el paso?
Conga taste con la asociacion?
Yo soy de Sevilla, y el servicio también es de la misma compañía.
En realidad, pertenezco a un grupo de investigación que queremos estudiar las ciudades… Pero así es dificil!!
Enhorabuena y gracias por tu trabajo!!
Gonzalo