Abrir Citymapper desde apps y desde la web
Abrir Citymapper desde apps de iOS y Android
Las apps de iOS y Android de Citymapper pueden abrirse usando una URL que lleve al usuario directo a las direcciones a un destino especificado. Va así:
citymapper://directions?startcoord=<lat>,<lon>&startname=<name>&startaddress=<address>&endcoord=<lat>,<lon>&endname=<name>&endaddress=<address>
Por ejemplo, esta URL da direcciones desde la ubicación actual al bonito Bosque de Chapultepec:
citymapper://directions?endcoord=19.421066,-99.186287&endname=Bosque%20de%20Chapultepec&endaddress=Av%20Paseo%20De%20la%20Reforma
Hablando claro, sólo necesitas meter el endcoord y el endname, aunque incluir el endaddress ayudará a que la pantalla final de Citymapper quede más detallada.
Si quieres planificar un viaje con llegada a una hora concreta (para un evento o vuelo), puedes añadir un arriveby time en formato ISO-8601 format, por ejemplo:
citymapper://directions?endcoord=40.491363,-3.592639&endname=Madrid-Barajas%20T4&arriveby=2016-010-23T11%3A00%3A57%2B01%3A00
Abrir Citymapper desde Web
Si estás desarrollando una web mobile, también tenemos una versión de este esquema para web. Es exactamente lo mismo, excepto que empiezas con http://citymapper.com en lugar de con citymapper. Ejemplo:
Esto llevará al usuario a una web que muestra el destino. Si tiene la app de Citymapper instalada, abrirá direcciones dentro de la app.
CMMapLauncher para iOS
A veces sólo quieres añadir rápidamente un "obtén direcciones" a tu app para iOS sin pasar mucho tiempo liándote con el formateo de parámetros de la URL. Para ayudar con eso, creamos una microlibrería llamada CMMapLauncher, que simplifica abrir Citymapper como hacen Apple, Google y otras apps de mapas. La tienes aquí: CMMapLauncher on GitHub
La idea es mantenerla pequeña y sencilla, que puedas usarla añadiendo un par de archivos de código fuente en tu proyecto. Si conoces otras apps que puedan abrirse y dar direcciones, te animamos a compartir los detalles vía pull request o creando un issue en Github.
Si usas nuestro URL scheme, o tienes otras ideas de integraciones con Citymapper, ¡cuéntanoslas! Estamos en api@citymapper.com