API service building tips? Recent docs?

52 views
Skip to first unread message

Michael Scheper

unread,
Jun 12, 2012, 6:45:01 PM6/12/12
to OneBusAway API
G'day people,

A quick delurk, as suggested on #onebusaway at freenode: I work for a
public transport agency in Australia and we're working on implementing
a onebusaway service. (Can't be more specific, I'm afraid; NDAs and
all that.) I'm quite experienced with Java EE (think dot com boomtimes
and Y2k), pretty comfortable with git, have been using hand-held
transit apps since I chased LRVs with my WAP-enabled dumbphone hooked
to nextbus, but I'm a complete novice with Maven.

It looks like we'll have to customise the REST API service a bit, so
the first thing to do is to get that working on our test server, a
Linux cloud instance running Tomcat 7. Is the 1.1.8 release on GitHub
a good point to fork from? Are there any recent docs for how to build
the bugger, or what the dependencies are? We've got our GTFS feed
working with some real-time data.

I'm honestly still a bit unclear about the canonical source for
OneBusAway developer information. I'm finding various versions of docs
at GitHub, Google Code and onebusaway.org; the Google stuff looks
dated but it seems the most comprehensive. The broken quick start link
at developer.onebusaway.org really makes me wonder whether that's the
right place to look. Guidance?

Thanks,
MS.

Brian Ferris

unread,
Jun 13, 2012, 2:33:42 AM6/13/12
to onebusa...@googlegroups.com
The definitive sources of information are:

https://github.com/OneBusAway/onebusaway/wiki

and for the application suite specifically:

https://github.com/OneBusAway/onebusaway-application-modules/wiki

The latest stable release of the application suite is 1.0.7. You can
check out the quickstart guide for the suite here:

http://developer.onebusaway.org/modules/onebusaway-application-modules/current/guides/quickstart-guide.html

Thanks,
Brian
> --
> You received this message because you are subscribed to the Google Groups "OneBusAway API" group.
> To post to this group, send email to onebusa...@googlegroups.com.
> To unsubscribe from this group, send email to onebusaway-ap...@googlegroups.com.
> For more options, visit this group at http://groups.google.com/group/onebusaway-api?hl=en.
>

Michael Frumin

unread,
Jun 13, 2012, 3:49:29 PM6/13/12
to onebusa...@googlegroups.com
Unfortunately, the docs for the additional modules we've developed for http://bustime.mta.info/ (inference engine, SIRI REST API, new UI's) are not really yet available publicly.  But the code is, and we're trying to help on the list, for whatever that's worth.  Just depends whether (assuming you already have an AVL system in place) you're looking for standards-based REST API's or the new/spiffy UI's we've been working on for NYC.

thanks,
Mike

Michael Scheper

unread,
Jun 13, 2012, 6:15:15 PM6/13/12
to onebusa...@googlegroups.com
Thanks for the info, fellas.

My gut feeling was indeed that the latest guides were the GitHub ones, but the broken link made me wonder. FYI, it was at https://github.com/OneBusAway/onebusaway/wiki; the 'quick-start guide' link in the second paragraph lead to a 404 (http://developer.onebusaway.org/modules/onebusaway-quickstart/current/), but I've changed it so it goes to the page Brian linked to.

Another apparently broken link is at https://github.com/OneBusAway/onebusaway-application-modules/wiki/Developer-Guide: the 'Importing Souce Code Into Eclipse' link seems to reference a non-existent wiki page (I couldn't find it in a search, either).' Since I'm a Maven n00b, I ended up cloning both onebusaway-api-webapp and the combined webapp, because I couldn't get the former to build. I got some help so it's all good now, but I take it I only need one or the other, not both?

One more question on this topic: Should I ignore links back to code.google.com, or does that site still serve some purpose?

Cheers,
MS.
> To post to this group, send email to onebusaway-api@googlegroups.com.
> To unsubscribe from this group, send email to onebusaway-api+unsubscribe@googlegroups.com.

cooki...@gmail.com

unread,
Jun 13, 2012, 6:39:00 PM6/13/12
to onebusa...@googlegroups.com
Importing Source Code Into Eclipse:

http://web.archive.org/web/20101113212316/http://code.google.com/p/onebusaway/wiki/ImportingTheSourceIntoEclipse
> <http://onebusaway.org>; the Google stuff looks
> > dated but it seems the most comprehensive. The broken quick start
> link
> > at developer.onebusaway.org <http://developer.onebusaway.org>
> really makes me wonder whether that's the
> > right place to look. Guidance?
> >
> > Thanks,
> > MS.
> >
> > --
> > You received this message because you are subscribed to the
> Google Groups "OneBusAway API" group.
> > To post to this group, send email to
> onebusa...@googlegroups.com
> <mailto:onebusa...@googlegroups.com>.
> > To unsubscribe from this group, send email to
> onebusaway-ap...@googlegroups.com
> <mailto:onebusaway-api%2Bunsu...@googlegroups.com>.
> > For more options, visit this group at
> http://groups.google.com/group/onebusaway-api?hl=en
> <http://groups.google.com/group/onebusaway-api?hl=en>.
> >
>
> --
> You received this message because you are subscribed to the Google
> Groups "OneBusAway API" group.
> To view this discussion on the web visit
> https://groups.google.com/d/msg/onebusaway-api/-/M0eRZ1L3LLwJ.
> To post to this group, send email to onebusa...@googlegroups.com.
> To unsubscribe from this group, send email to
> onebusaway-ap...@googlegroups.com.

Michael Scheper

unread,
Jun 13, 2012, 9:09:55 PM6/13/12
to onebusa...@googlegroups.com
Thanks, Tim. I wish I'd seen that page yesterday! I've recreated it in the wiki.

Cheers,
MS.
>      > To unsubscribe from this group, send email to
>     <mailto:onebusaway-api%2Bunsu...@googlegroups.com>.
>      > For more options, visit this group at
>     http://groups.google.com/group/onebusaway-api?hl=en
>     <http://groups.google.com/group/onebusaway-api?hl=en>.
>      >
>
> --
> You received this message because you are subscribed to the Google
> Groups "OneBusAway API" group.
> To view this discussion on the web visit
> https://groups.google.com/d/msg/onebusaway-api/-/M0eRZ1L3LLwJ.
> To post to this group, send email to onebusaway-api@googlegroups.com.
> To unsubscribe from this group, send email to
> For more options, visit this group at
> http://groups.google.com/group/onebusaway-api?hl=en.
>      > To unsubscribe from this group, send email to
>     <mailto:onebusaway-api%2Bunsu...@googlegroups.com>.
>      > For more options, visit this group at
>     http://groups.google.com/group/onebusaway-api?hl=en
>     <http://groups.google.com/group/onebusaway-api?hl=en>.
>      >
>
> --
> You received this message because you are subscribed to the Google
> Groups "OneBusAway API" group.
> To view this discussion on the web visit
> https://groups.google.com/d/msg/onebusaway-api/-/M0eRZ1L3LLwJ.
> To post to this group, send email to onebusaway-api@googlegroups.com.
> To unsubscribe from this group, send email to

Michael Scheper

unread,
Jun 14, 2012, 12:06:09 AM6/14/12
to OneBusAway API
I've updated the Import Source Code page for git—would somebody who
knows more about Maven than me like to review it? I didn't mention
that I needed to install Maven itself and run the install command from
the command line, because I'm not sure I really needed to. (I'm new to
Maven and this is the first time in many years that I've developed
under Windows, and I'm finding it pretty quirky). If this was the
right way, the wiki page should mention that.

Cheers,
MS.

On Jun 14, 11:09 am, Michael Scheper <goo...@michaelscheper.com>
wrote:
> Thanks, Tim. I wish I'd seen that page yesterday! I've recreated it in the
> wiki.
>
> Cheers,
> MS.
>
>
>
>
>
>
>
> On Thursday, 14 June 2012 08:39:00 UTC+10, Tim wrote:
>
> > Importing Source Code Into Eclipse:
>
> >http://web.archive.org/web/20101113212316/http://code.google.com/p/on...
>
> > On 6/13/2012 15:15, Michael Scheper wrote:
> > > Thanks for the info, fellas.
>
> > > My gut feeling was indeed that the latest guides were the GitHub ones,
> > > but the broken link made me wonder. FYI, it was at
> > >https://github.com/OneBusAway/onebusaway/wiki;the 'quick-start guide'
> > > link in the second paragraph lead to a 404
> > > (http://developer.onebusaway.org/modules/onebusaway-quickstart/current/),
> > but
> > > I've changed it so it goes to the page Brian linked to.
>
> > > Another apparently broken link is at
>
> >https://github.com/OneBusAway/onebusaway-application-modules/wiki/Dev...
>
> > > the 'Importing Souce Code Into Eclipse' link seems to reference a
> > > non-existent wiki page (I couldn't find it in a search, either).' Since
> > > I'm a Maven n00b, I ended up cloning both onebusaway-api-webapp and the
> > > combined webapp, because I couldn't get the former to build. I got some
> > > help so it's all good now, but I take it I only need one or the other,
> > > not both?
>
> > > One more question on this topic: Should I ignore links back to
> > > code.google.com, or does that site still serve some purpose?
>
> > > Cheers,
> > > MS.
>
> > > On Wednesday, 13 June 2012 16:33:42 UTC+10, Brian Ferris wrote:
>
> > >     The definitive sources of information are:
>
> > >    https://github.com/OneBusAway/onebusaway/wiki
> > >     <https://github.com/OneBusAway/onebusaway/wiki>
>
> > >     and for the application suite specifically:
>
> > >    https://github.com/OneBusAway/onebusaway-application-modules/wiki
> > >     <https://github.com/OneBusAway/onebusaway-application-modules/wiki>
>
> > >     The latest stable release of the application suite is 1.0.7. You can
> > >     check out the quickstart guide for the suite here:
>
> >http://developer.onebusaway.org/modules/onebusaway-application-module...
> > >     <
> >http://developer.onebusaway.org/modules/onebusaway-application-module...>
>
> > >     Thanks,
> > >     Brian
>
> > >     On Wed, Jun 13, 2012 at 12:45 AM, Michael Scheper
> > >     <goo...@michaelscheper.com <mailto:goo...@michaelscheper.com>>
> > >     onebusa...@googlegroups.com
> > >     <mailto:onebusa...@googlegroups.com>.
> > >      > To unsubscribe from this group, send email to
> > >     onebusaway-ap...@googlegroups.com
> > >     <mailto:onebusaway-api%2Bunsu...@googlegroups.com>.
> > >      > For more options, visit this group at
> > >    http://groups.google.com/group/onebusaway-api?hl=en
> > >     <http://groups.google.com/group/onebusaway-api?hl=en>.
>
> > > --
> > > You received this message because you are subscribed to the Google
> > > Groups "OneBusAway API" group.
> > > To view this discussion on the web visit
> > >https://groups.google.com/d/msg/onebusaway-api/-/M0eRZ1L3LLwJ.
> > > To post to this group, send email to onebusa...@googlegroups.com.
> > > To unsubscribe from this group, send email to
> > > onebusaway-ap...@googlegroups.com.
> > > For more options, visit this group at
> > >http://groups.google.com/group/onebusaway-api?hl=en.
>
> On Thursday, 14 June 2012 08:39:00 UTC+10, Tim wrote:
>
> > Importing Source Code Into Eclipse:
>
> >http://web.archive.org/web/20101113212316/http://code.google.com/p/on...
>
> > On 6/13/2012 15:15, Michael Scheper wrote:
> > > Thanks for the info, fellas.
>
> > > My gut feeling was indeed that the latest guides were the GitHub ones,
> > > but the broken link made me wonder. FYI, it was at
> > >https://github.com/OneBusAway/onebusaway/wiki;the 'quick-start guide'
> > > link in the second paragraph lead to a 404
> > > (http://developer.onebusaway.org/modules/onebusaway-quickstart/current/),
> > but
> > > I've changed it so it goes to the page Brian linked to.
>
> > > Another apparently broken link is at
>
> >https://github.com/OneBusAway/onebusaway-application-modules/wiki/Dev...
>
> > > the 'Importing Souce Code Into Eclipse' link seems to reference a
> > > non-existent wiki page (I couldn't find it in a search, either).' Since
> > > I'm a Maven n00b, I ended up cloning both onebusaway-api-webapp and the
> > > combined webapp, because I couldn't get the former to build. I got some
> > > help so it's all good now, but I take it I only need one or the other,
> > > not both?
>
> > > One more question on this topic: Should I ignore links back to
> > > code.google.com, or does that site still serve some purpose?
>
> > > Cheers,
> > > MS.
>
> > > On Wednesday, 13 June 2012 16:33:42 UTC+10, Brian Ferris wrote:
>
> > >     The definitive sources of information are:
>
> > >    https://github.com/OneBusAway/onebusaway/wiki
> > >     <https://github.com/OneBusAway/onebusaway/wiki>
>
> > >     and for the application suite specifically:
>
> > >    https://github.com/OneBusAway/onebusaway-application-modules/wiki
> > >     <https://github.com/OneBusAway/onebusaway-application-modules/wiki>
>
> > >     The latest stable release of the application suite is 1.0.7. You can
> > >     check out the quickstart guide for the suite here:
>
> >http://developer.onebusaway.org/modules/onebusaway-application-module...
> > >     <
> >http://developer.onebusaway.org/modules/onebusaway-application-module...>
>
> > >     Thanks,
> > >     Brian
>
> > >     On Wed, Jun 13, 2012 at 12:45 AM, Michael Scheper
> > >     <goo...@michaelscheper.com <mailto:goo...@michaelscheper.com>>
> > >     onebusa...@googlegroups.com
> > >     <mailto:onebusa...@googlegroups.com>.
> > >      > To unsubscribe from this group, send email to
> > >     onebusaway-ap...@googlegroups.com
>
> ...
>
> read more »
Reply all
Reply to author
Forward
0 new messages