Mission Manager Community

Mission Manager => Announcements => Topic started by: Radishworks on March 04, 2012, 07:47:42 PM

Title: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 04, 2012, 07:47:42 PM
For anyone interested in developing their own mobile application for Mission Manager, there is now a API to do so.  With this new API you can build a custom application that interfaces directly with MM.  Some features that are exposed and should make for a very useful mobile application are:

•   You can poll a list of the active missions for your team, allowing the app to let the user select what mission they are currently on.
•   The ability to post GPS locations to MM just like InstaMapper does.
•   The ability to post clues from the field including pictures and GPS location of where the clue was found.
•   You can pole information about the team the person is currently assigned to, including team number, assignment, team members, team type, etc.
•   The application can start polling the API as soon as a member arrives on scene.  The phone can alert the member as soon as they are assigned to a team.
•   Members can view all the important information about their team assignment without the need for a paper copy.
•   Many other creative things.

Other API features will be exposed, so stay tuned  :).

The draft documentation can be found here: http://www.radishworks.com/SearchManager/Help.htm#API (http://www.radishworks.com/SearchManager/Help.htm#API)
A simple JavaScript test page can be seen here: http://www.radishworks.com/SearchManager/apitester.html (http://www.radishworks.com/SearchManager/apitester.html)

If you are a mobile developer, let's see what you can build!


Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 05, 2012, 09:00:55 PM
Well, I took a stab at this and came up with a pretty simple Android app. Of the API released, the only feature I haven't yet integrated is posting images along with a clue.

http://www.zmonkey.org/beacon/ (http://www.zmonkey.org/beacon/)

It's clearly a very early release, but I would welcome feedback.

As far as future features, one key thing I'd like to add is delayed posting of clues and locations. Around here anyway, mobile Internet can be very spotty. I'd like to queue up the events for when a network is available. An API feature for posting data along with a time code would be great.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tkleager on March 06, 2012, 07:16:07 AM
tensai,

I'm interested in helping test this application out.

I loaded it this morning to my Droid 3.  When I run the application I get a "Application has stopped unexpectedly." Force Close error.  Anything I need to do different when I install and set up the app?

TK
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 06, 2012, 09:58:29 AM
Quote
When I run the application I get a "Application has stopped unexpectedly."
I saw the same thing when I tried it for the first time.  It seems to be related to the GPS in the phone not being ready, once the GPS found its satellites it seemed to work ok.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 06, 2012, 10:03:50 AM
Quote
An API feature for posting data along with a time code would be great.
Done!   ;D  You can now post the ClueDate and ClueTime if you like.  There is also a whole new set of GET parameters that allow access to more mission information, such as the command post location, name, radio channels etc..   See the API docs for more info http://www.radishworks.com/SearchManager/Help.htm#API (http://www.radishworks.com/SearchManager/Help.htm#API)
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 06, 2012, 10:18:05 PM
I haven't been able to replicate the crash when GPS isn't available, but I made some changes that should hopefully eliminate it. Please test out version 0.2 which I've just posted at http://www.zmonkey.org/beacon/ (http://www.zmonkey.org/beacon/).

Thanks for the ClueDate and ClueTime feature. I added basic support for it and confirmed it works, but I don't have the offline queuing ready yet. So many features, so little time.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 07, 2012, 01:39:28 PM
More API Accessible features:
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 07, 2012, 09:58:23 PM
You're adding API calls faster than I can implement them. :)

I've got a version 0.3 uploaded which is mostly UI cleanup and code reorganization. I like the idea of getting all the mission info downloaded for quick access. I'll get that added in here before long.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 09, 2012, 10:56:22 AM
Quote
You're adding API calls faster than I can implement them.
He he, sorry about that!  :)  Here comes a few more.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 11, 2012, 10:21:21 PM
I've got a version 0.4 out and I'm getting caught up on your new features. The one I'm at now is posting the subject image. What file format is that? Speaking of that, can you elaborate on how you envision posting images for clues? The parameter is for a URL but wouldn't it make more sense for the image data to be POST content?

I really like the XML and JSON options. This CSV parsing is for the birds.

What are your thoughts about assigning an API key to the sample users? This would simplify my testing so I don't have to re-enter the key every day.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 12, 2012, 07:55:57 PM
Quote
I've got a version 0.4 out and I'm getting caught up on your new features.
Great!

Quote
The one I'm at now is posting the subject image. What file format is that?
It is in the form of an example: http://www.websiteoptimization.com/speed/tweak/inline-images/ (http://www.websiteoptimization.com/speed/tweak/inline-images/).  You should be able to drop the returned text right in as a piece of your HTML.

Quote
Speaking of that, can you elaborate on how you envision posting images for clues?  The parameter is for a URL but wouldn't it make more sense for the image data to be POST content?
Maybe this will make more sense.  There is now a new "Image" parameter that can be posted as a standard HTML: <input type="file" name="Image"> form submit.  Hopefully this will work easier.

Quote
I really like the XML and JSON options. This CSV parsing is for the birds.
:D

Quote
What are your thoughts about assigning an API key to the sample users?
The idea behind API keys is once they are assigned to a Member they shouldn't be changed or reset.  Once a member enters their API key into their mobile app it shouldn't need to be changed unless their API key is reset.  I would expect the Mobile App to save the entered API Key and be there the next time the app is started.  Does that make sense or am I not understanding the question?

Nice work on the App!!
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 13, 2012, 08:02:02 AM
Quote
The idea behind API keys is once they are assigned to a Member they shouldn't be changed or reset.  Once a member enters their API key into their mobile app it shouldn't need to be changed unless their API key is reset.  I would expect the Mobile App to save the entered API Key and be there the next time the app is started.  Does that make sense or am I not understanding the question?

That part makes sense. I was referring to the test bed users, e.g. cmd@radishworks.com. They don't have a default API key so I have to reset it every day.

Would it be possible to add a button to email/text the user their API key? I'm thinking of somebody out in the field who wants to sign into the app but can't get into the website to look up the API key.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 13, 2012, 09:55:17 AM
Quote
That part makes sense. I was referring to the test bed users
Ahh, I see what you mean.  Hmmm, I'm not sure what to do about that.  The sandbox is designed to reset each night, this means new API keys.  Remember the sandbox is visible to anyone on the Web so someone else could also interfere with your testing.  It might be better to created a test member in your own team's account. 

Quote
Would it be possible to add a button to email/text the user their API key?
Done.  There is a new "Email" button to email a member their API Key.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 18, 2012, 07:51:12 PM
I think I found a bug when posting a clue. It seems to fail when the first clue to be posted is done through the mobile API. If I create a clue through the website then I can post clues through the API just fine.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 18, 2012, 11:09:01 PM
Yep, looks like a bug.  Will post a fix in the next few days.  Thanks for the report.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 21, 2012, 05:40:47 PM
Quote
It seems to fail when the first clue to be posted is done through the mobile API.
The fix for this has been posted.  It should work OK now.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 22, 2012, 07:06:56 AM
Quote
The fix for this has been posted.  It should work OK now.
Works like a charm. Thanks!
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tkleager on March 22, 2012, 07:27:57 AM
Any way that you could make the "Click to Select Mission" button bigger.  I have a catcher's mitt for a hand, and have a hard time getting my finger to catch the button.

Thanks.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on March 22, 2012, 04:02:18 PM
Another new API feature has been added:

For GPS locations you can now pass a Date= and Time= to specify the date and time the point was collected.  This way you can collect up a bunch of point when the app is out of cell service and post them all when service returns. 

Note there is also a new error <320>.  This error will be returned if a point is posted too quickly, MM will only accept points every 30 seconds. 

Lastly the ClueTime and ClueDate parameters have been renamed to Time and Date for consistency.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: tensai on March 23, 2012, 09:00:28 PM
Quote
Any way that you could make the "Click to Select Mission" button bigger.  I have a catcher's mitt for a hand, and have a hard time getting my finger to catch the button.

I rolled version 0.6 which adds a setting for a font size. If those are still not big enough, let me know.

Quote
Lastly the ClueTime and ClueDate parameters have been renamed to Time and Date for consistency.

Version 0.7 is now compatible with this change.
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: jgiambo on September 11, 2012, 01:57:43 AM
I am noticing a small problem with the API.  I have just recently begun coding an iPhone app for mission manager and there is no way to lookup all team information simultaneously.  Mission manager will only give you information for the team you are assigned to.  This means the incident commander cannot use an API to pull information about all information for the teams in the field.  Same with a lot of the other API calls it seems. 
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: Radishworks on September 11, 2012, 07:38:22 AM
Quote
Mission manager will only give you information for the team you are assigned to.
Hmm... This is by design, not to say it can't change.

The intent of the API was for team members in the field.  It sounds like you are creating an APP for more than just field people?  Can you explain more about what you are building into the app and we'll see if we can give you more API features?

Thanks,
Mike
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: atucker@wcrescue.com on October 12, 2012, 11:24:48 AM
I very new to all of this, I have been playing with the MM and some of the smartphone apps ie SARApp for the iphone is there another app for iphone/ipad users? Thanks
Title: Re: Mission Manager 6.6 - Moble Application API (beta)
Post by: CKeller on November 19, 2012, 11:00:51 AM
atucker, just to let you know, SARApp does work on the iPad and on Android tablets in a Beta version and we'll be releasing a new App on the Google Play and iTunes App stores soon that will "officially" allow tablet users to download the App.