Mission Manager Community
Mission Manager => Announcements => Topic started 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!
-
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.
-
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
-
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.
-
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)
-
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.
-
More API Accessible features:
- Information about Subjects can now be queried from the API. My hopes is there can be a eVersion of the missing person fliers for teams in the field via their mobile phones.
- Data requested form the API can now be requested and delivered as Text, XML, or JSON
-
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.
-
You're adding API calls faster than I can implement them.
He he, sorry about that! :) Here comes a few more.
- You can now set altitude with the new Altitude parameter when posting GPS locations for teams
- You can get pictures (image) of subjects with the new SubjectImage parameter
- With the new TeamAreas parameter you can get assigned team map areas, areas, paths, markers, etc. The GPS coordinates for these areas are returned and can be used to display the assigned areas on mobile maps.
- Using the new OtherTeamGPSLocations get parameter, you can get the GPS locations of other teams on the mission.
-
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.
-
I've got a version 0.4 out and I'm getting caught up on your new features.
Great!
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.
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.
I really like the XML and JSON options. This CSV parsing is for the birds.
:D
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!!
-
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.
-
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.
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.
-
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.
-
Yep, looks like a bug. Will post a fix in the next few days. Thanks for the report.
-
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.
-
The fix for this has been posted. It should work OK now.
Works like a charm. Thanks!
-
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.
-
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.
-
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.
Lastly the ClueTime and ClueDate parameters have been renamed to Time and Date for consistency.
Version 0.7 is now compatible with this change.
-
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.
-
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
-
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
-
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.